尧图网页设计 
简介这是一套基于JavaWeb技术栈开发的个人博客管理系统源码面向Java初学者与Web开发入门者聚焦MVC架构实践与全栈功能实现帮助学习者掌握Servlet、JSP、JDBC及前后端协同开发的核心流程。资源包共7154个文件涵盖3716张界面截图与图标png/gif/jpg、1250个前端交互脚本js、745个页面模板html、395个样式文件css/scss、60个服务端视图jsp以及89个核心业务类java完整呈现从用户登录、文章CRUD、评论管理到数据库操作的闭环逻辑压缩包大小为54.01MB结构清晰含src/main/java、webapp、WEB-INF等标准目录便于理解课程设计级项目的工程组织方式。已有2357人学习下载附带可直接部署的WAR结构、MySQL建表SQL及典型Servlet类如ShowBlogServlet、EditServlet、UserDaoImpl等是开展JavaWeb实战训练、理解分层开发思想的理想参考案例。1. 这不是又一个“Hello World”博客JavaWeb个人博客管理系统源码是能跑通、能改、能上线的最小生产闭环你搜“JavaWeb个人博客管理系统 源码”点开一堆压缩包解压后看到web/src/WebContent/pom.xml甚至还有db.sql—— 但双击index.jsp打不开IDEA里右键 Run on Server 报错404或ClassNotFoundExceptionMySQL连不上登录页提交后跳转空白……这不是源码的问题是缺了一条「从文件到可运行服务」的完整链路。这个标题下的源码本质是一个基于 Servlet JSP JDBC或轻量级 ORM MySQL 的传统 JavaWeb 全栈闭环实践样本它不追求 Spring Boot 的自动装配也不堆砌 Vue 前端框架而是用最原始、最透明、最易调试的方式把 HTTP 请求怎么进、业务逻辑怎么走、SQL 怎么发、HTML 怎么吐一帧一帧拆给你看。适合刚学完《Java Web 编程技术》教材第 7 章、正在被 Tomcat 配置和 web.xml 绑架的在校生也适合想快速验证一个老系统改造可行性、需要剥离 Spring 复杂度做底层探针的运维/测试工程师。它解决的不是“高并发博客”而是“我写的 Java 类怎么真正在浏览器里变成一个能发文章、能查列表、能删评论的网页”——这是所有 JavaWeb 工程师绕不开的第一道实操门槛。2. 从解压到启动用 IDEA 跑通 JavaWeb 个人博客管理系统的最小命令与配置路径2.1 确认项目结构先别急着 run看清它是哪种 JavaWeb 项目范式拿到.zip后第一件事不是导入 IDEA而是用文本编辑器打开根目录下的pom.xml或web.xml快速判断项目类型有pom.xml且含packagingwar/packaging→ Maven 管理的 WAR 项目主流无pom.xml但有WEB-INF/web.xmlclasses/lib/→ 传统 Ant 构建或手动打包的 WAR 结构老派但稳定有src/main/java/src/main/webapp/→ 标准 Maven Web 项目布局推荐只有WebContent/目录里面直接放jsp和WEB-INF/→ Eclipse 时代经典结构需适配 IDEA提示绝大多数“JavaWeb个人博客管理系统源码”属于第 1 或第 4 类。若pom.xml存在但version是2.5或3.0说明它依赖 Servlet 2.5/3.0 规范必须配 Tomcat 7/8Tomcat 10 因 Jakarta EE 命名空间变更javax.*→jakarta.*会直接报NoClassDefFoundError—— 这是新手翻车第一坑先记下。2.2 IDEA 导入三步锁定部署路径拒绝“Artifact not configured”以 Maven 项目为例最常见在 IDEA 中操作File → Open → 选中解压后的根目录 → OK不要选pom.xml单独导入否则模块识别错乱等待 Maven 自动加载依赖后右键项目名 → Add Framework Support → Web Application勾选Web ApplicationVersion 选3.0匹配web.xml中web-app version3.0关键动作点击Web resource directory右侧的...定位到src/main/webappMaven或WebContentEclipse 结构—— 这个路径决定了index.jsp、css/、js/的实际访问根路径。配置 Tomcat ServerRun → Edit Configurations → → Tomcat Server → LocalApplication server指向你本地已下载的 Tomcat 8.5推荐兼容性最好Deployment → → Artifact → 选中项目名:war exploded注意这里必须选exploded解压模式不是war。因为开发阶段要热更新 JSP 和静态资源war包每次都要重打包。Application context填/blog或其他你喜欢的上下文路径如/表示根路径# 验证 Tomcat 是否就绪终端执行 $ $TOMCAT_HOME/bin/startup.sh # Linux/Mac $ $TOMCAT_HOME/bin/startup.bat # Windows # 访问 http://localhost:8080/看到 Apache Tomcat welcome page 即成功2.3 数据库初始化不是只执行 SQL而是打通连接池最后一公里源码包里通常附带db.sql或init.sql但直接执行往往不够。真实落地需三步建库与字符集CREATE DATABASE blog CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;执行建表语句db.sql内容注意检查 SQL 中是否含ENGINEInnoDB DEFAULT CHARSETutf8mb4;—— 若为utf8中文可能存成?务必替换。配置 JDBC 连接核心90% 启动失败源于此找到src/main/resources/jdbc.properties或WEB-INF/web.xml里的context-param确认以下三项jdbc.urljdbc:mysql://localhost:3306/blog?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8mb4serverTimezone必填否则 MySQL 8 报The server time zone value XXX is unrecognizedjdbc.usernamerootjdbc.passwordyour_password若用 Druid 或 C3P0 连接池还需检查druid.properties中driverClassNamecom.mysql.cj.jdbc.DriverMySQL 8或com.mysql.jdbc.DriverMySQL 5.x——驱动类名写错连数据库都连不上更别说报 404。3. 代码层拆解Servlet JSP 如何协作完成一篇博文的增删改查3.1 请求入口web.xml是整个系统的路由总控台不要跳过WEB-INF/web.xml它是 JavaWeb 项目的“宪法”。典型配置如下!-- web.xml -- servlet servlet-nameArticleServlet/servlet-name servlet-classcom.blog.servlet.ArticleServlet/servlet-class /servlet servlet-mapping servlet-nameArticleServlet/servlet-name url-pattern/article/url-pattern /servlet-mapping这意味着浏览器访问http://localhost:8080/blog/article?actionadd→ 触发ArticleServlet的doGet()方法ArticleServlet通过request.getParameter(action)判断操作类型add/update/delete/list关键逻辑Servlet 不负责拼 HTML只处理业务、调 DAO、设置 request 属性然后request.getRequestDispatcher(/list.jsp).forward(request, response);这就是 JSP 的价值把ListArticle丢给list.jsp它用c:forEach遍历输出表格。前后端职责清晰没有 Ajax 时这就是最朴素的 MVC。3.2 业务中枢ArticleServlet的标准写法与状态流转设计一个健壮的ArticleServlet至少包含 5 个分支且每个分支必须明确forward或redirect// ArticleServlet.java protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String action request.getParameter(action); switch (action) { case list: ListArticle articles articleDao.findAll(); request.setAttribute(articles, articles); request.getRequestDispatcher(/list.jsp).forward(request, response); break; case toAdd: request.getRequestDispatcher(/add.jsp).forward(request, response); break; case add: String title request.getParameter(title); String content request.getParameter(content); Article article new Article(title, content, new Date()); articleDao.save(article); response.sendRedirect(request.getContextPath() /article?actionlist); // 重定向防重复提交 break; case delete: int id Integer.parseInt(request.getParameter(id)); articleDao.delete(id); response.sendRedirect(request.getContextPath() /article?actionlist); break; default: response.sendError(HttpServletResponse.SC_NOT_FOUND); } }注意add和delete用sendRedirect()避免刷新页面重复提交list和toAdd用forward()保持 request 域内数据如articles可用。这是 JavaWeb 开发的“玄学”守则——错用就会出现“添加成功但页面没刷新”或“删除后列表仍存在”。3.3 数据持久JDBC 封装的 DAO 层为什么不用 MyBatis 也能稳如泰山源码中常见ArticleDao.java其核心是Connection获取与PreparedStatement参数绑定// ArticleDao.java public class ArticleDao { private static final String INSERT_SQL INSERT INTO t_article(title, content, create_time) VALUES(?, ?, ?); public void save(Article article) throws SQLException { Connection conn JdbcUtil.getConnection(); // 工具类获取连接 PreparedStatement ps conn.prepareStatement(INSERT_SQL); ps.setString(1, article.getTitle()); ps.setString(2, article.getContent()); ps.setTimestamp(3, new Timestamp(article.getCreateTime().getTime())); ps.executeUpdate(); // 关键必须 executeUpdate()不是 executeQuery() JdbcUtil.close(ps, conn); // 必须关闭否则连接泄漏 } }JdbcUtil是自定义工具类封装了DriverManager.getConnection()和try-with-resources逻辑。它比硬写Class.forName()更安全且统一管理连接关闭。很多源码崩溃是因为 DAO 层忘了close()导致 Tomcat 连接池耗尽后续所有请求卡死在getConnection()—— 这是血泪经验。4. 避坑指南JavaWeb个人博客管理系统源码运行中的5个高频翻车现场4.1 现象启动 Tomcat 后访问http://localhost:8080/blog/显示 404但http://localhost:8080/正常原因Application context配置错误或web.xml中welcome-file-list未指定默认首页。解决检查 IDEA 中 Tomcat 配置的Application context是否与项目名一致如项目名blogcontext 必须为/blog在web.xml中添加welcome-file-list welcome-fileindex.jsp/welcome-file /welcome-file-list并确认index.jsp真实存在于webapp/根目录下。4.2 现象登录页提交后跳转空白控制台无报错浏览器 Network 显示200 OK但 Response 为空原因response.sendRedirect()的路径写错或forward()时 JSP 路径不存在。解决sendRedirect()必须带上下文路径response.sendRedirect(request.getContextPath() /login.jsp);forward()的路径是相对于webapp/目录的request.getRequestDispatcher(/admin/index.jsp).forward(...)不能写成/webapp/admin/index.jsp。4.3 现象MySQL 连接成功但执行SELECT * FROM t_article报Table blog.t_article doesnt exist原因db.sql中建表语句未执行或执行时未选中blog库。解决登录 MySQL 命令行mysql -u root -p→USE blog;→SHOW TABLES;确认表存在若表名是article而非t_article检查 DAO 层 SQL 字符串是否硬编码了表名需同步修改。4.4 现象JSP 页面中文显示为??数据库存的是?原因MySQL 连接 URL 缺少characterEncodingutf8mb4或 Tomcat 的server.xml未配置 URI 编码。解决JDBC URL 补全?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8mb4修改$TOMCAT_HOME/conf/server.xml在Connector标签内加URIEncodingUTF-84.5 现象修改 JSP 后刷新页面无变化必须重启 Tomcat原因IDEA 未开启On update action的自动部署或 Tomcat 的reloadable未启用。解决IDEA 中Run → Edit Configurations → Tomcat Server → On update action → Update classes and resourcesserver.xml中Context标签加reloadabletrue仅开发环境生产禁用若仍无效清空$TOMCAT_HOME/work/Catalina/localhost/下对应项目的缓存文件夹。5. 进阶实战把个人博客管理系统从“能跑”升级为“能用”的3个硬核改造点5.1 改造一用 Filter 实现统一登录拦截告别每个 Servlet 里写 if(!login) redirectLoginFilter.java是提升工程规范性的第一块砖。它不侵入业务代码却能强制保护/admin/*下所有资源// LoginFilter.java public class LoginFilter implements Filter { Override public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; String uri request.getRequestURI(); // 放行登录页、登录接口、静态资源 if (uri.contains(/login.jsp) || uri.contains(/login) || uri.endsWith(.css) || uri.endsWith(.js)) { chain.doFilter(req, resp); return; } // 检查 session 中是否有 user HttpSession session request.getSession(false); if (session null || session.getAttribute(user) null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } chain.doFilter(req, resp); } }在web.xml中注册filter filter-nameLoginFilter/filter-name filter-classcom.blog.filter.LoginFilter/filter-class /filter filter-mapping filter-nameLoginFilter/filter-name url-pattern/admin/*/url-pattern /filter-mapping这个 Filter 的价值在于当你新增一个/admin/write.jsp无需改任何 Servlet只要 URL 匹配/admin/*就自动受保护。比在每个 Servlet 里写if(sessionnull) redirect干净十倍。5.2 改造二用 JSTL 替代 Scriptlet让 JSP 从“Java 混合页”变“纯视图模板”源码中常见% while(rs.next()) { %这种嵌套 Java 代码的 JSP维护性极差。换成 JSTL 后% taglib prefixc urihttp://java.sun.com/jsp/jstl/core % c:forEach items${articles} vararticle tr td${article.id}/td td${article.title}/td tdfmt:formatDate value${article.createTime} patternyyyy-MM-dd HH:mm//td td a hrefarticle?actiondeleteid${article.id}删除/a /td /tr /c:forEach落地步骤pom.xml加依赖dependency groupIdjstl/groupId artifactIdjstl/artifactId version1.2/version /dependencyJSP 顶部加% taglib prefixc urihttp://java.sun.com/jsp/jstl/core %EL 表达式${}直接取 request 属性无需%request.getAttribute(articles)%JSTL 不是语法糖它是视图层的“标准化协议”。用它你的 JSP 就能被前端工程师看懂也能被 IDE 正确高亮和校验。5.3 改造三用 Log4j2 记录操作日志把“谁在什么时候删了哪篇文章”变成可追溯证据log4j2.xml配置文件放在src/main/resources/下?xml version1.0 encodingUTF-8? Configuration statusWARN Appenders File nameBlogLog fileNamelogs/blog.log PatternLayout pattern%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n/ /File /Appenders Loggers Logger namecom.blog levelinfo additivityfalse AppenderRef refBlogLog/ /Logger Root levelerror AppenderRef refConsole/ /Root /Loggers /Configuration在ArticleServlet的delete分支中加日志// ArticleServlet.java private static final Logger logger LogManager.getLogger(ArticleServlet.class); // ... case delete: int id Integer.parseInt(request.getParameter(id)); articleDao.delete(id); String username (String) session.getAttribute(username); logger.info(用户 {} 删除文章 ID: {}, username, id); // 结构化日志 response.sendRedirect(...); break;日志文件logs/blog.log会按天滚动内容可直接 grep 查询“grep 删除文章 ID logs/blog.log | tail -20”。这比靠数据库create_time推断操作人靠谱得多——毕竟真正的线上问题永远发生在“昨天下午三点谁点了那个红色按钮”。我带过的实习生第一个月都在和web.xml、context.xml、server.xml打交道第二个月开始改 Filter 和 Log第三个月才敢碰 DAO 层事务隔离级别。这套 JavaWeb 个人博客管理系统源码不是让你速成架构师而是逼你亲手拧紧每一颗螺丝——当http://localhost:8080/blog/终于跳出你写的欢迎来到我的博客那一刻的踏实感是任何框架文档都给不了的。希望帮到你。本文还有配套的精品资源点击获取 JavaWeb博客系统源码跑通指南：Servlet+JSP+MySQL完整闭环
简介这是一套基于JavaWeb技术栈开发的个人博客管理系统源码面向Java初学者与Web开发入门者聚焦MVC架构实践与全栈功能实现帮助学习者掌握Servlet、JSP、JDBC及前后端协同开发的核心流程。资源包共7154个文件涵盖3716张界面截图与图标png/gif/jpg、1250个前端交互脚本js、745个页面模板html、395个样式文件css/scss、60个服务端视图jsp以及89个核心业务类java完整呈现从用户登录、文章CRUD、评论管理到数据库操作的闭环逻辑压缩包大小为54.01MB结构清晰含src/main/java、webapp、WEB-INF等标准目录便于理解课程设计级项目的工程组织方式。已有2357人学习下载附带可直接部署的WAR结构、MySQL建表SQL及典型Servlet类如ShowBlogServlet、EditServlet、UserDaoImpl等是开展JavaWeb实战训练、理解分层开发思想的理想参考案例。1. 这不是又一个“Hello World”博客JavaWeb个人博客管理系统源码是能跑通、能改、能上线的最小生产闭环你搜“JavaWeb个人博客管理系统 源码”点开一堆压缩包解压后看到web/src/WebContent/pom.xml甚至还有db.sql—— 但双击index.jsp打不开IDEA里右键 Run on Server 报错404或ClassNotFoundExceptionMySQL连不上登录页提交后跳转空白……这不是源码的问题是缺了一条「从文件到可运行服务」的完整链路。这个标题下的源码本质是一个基于 Servlet JSP JDBC或轻量级 ORM MySQL 的传统 JavaWeb 全栈闭环实践样本它不追求 Spring Boot 的自动装配也不堆砌 Vue 前端框架而是用最原始、最透明、最易调试的方式把 HTTP 请求怎么进、业务逻辑怎么走、SQL 怎么发、HTML 怎么吐一帧一帧拆给你看。适合刚学完《Java Web 编程技术》教材第 7 章、正在被 Tomcat 配置和 web.xml 绑架的在校生也适合想快速验证一个老系统改造可行性、需要剥离 Spring 复杂度做底层探针的运维/测试工程师。它解决的不是“高并发博客”而是“我写的 Java 类怎么真正在浏览器里变成一个能发文章、能查列表、能删评论的网页”——这是所有 JavaWeb 工程师绕不开的第一道实操门槛。2. 从解压到启动用 IDEA 跑通 JavaWeb 个人博客管理系统的最小命令与配置路径2.1 确认项目结构先别急着 run看清它是哪种 JavaWeb 项目范式拿到.zip后第一件事不是导入 IDEA而是用文本编辑器打开根目录下的pom.xml或web.xml快速判断项目类型有pom.xml且含packagingwar/packaging→ Maven 管理的 WAR 项目主流无pom.xml但有WEB-INF/web.xmlclasses/lib/→ 传统 Ant 构建或手动打包的 WAR 结构老派但稳定有src/main/java/src/main/webapp/→ 标准 Maven Web 项目布局推荐只有WebContent/目录里面直接放jsp和WEB-INF/→ Eclipse 时代经典结构需适配 IDEA提示绝大多数“JavaWeb个人博客管理系统源码”属于第 1 或第 4 类。若pom.xml存在但version是2.5或3.0说明它依赖 Servlet 2.5/3.0 规范必须配 Tomcat 7/8Tomcat 10 因 Jakarta EE 命名空间变更javax.*→jakarta.*会直接报NoClassDefFoundError—— 这是新手翻车第一坑先记下。2.2 IDEA 导入三步锁定部署路径拒绝“Artifact not configured”以 Maven 项目为例最常见在 IDEA 中操作File → Open → 选中解压后的根目录 → OK不要选pom.xml单独导入否则模块识别错乱等待 Maven 自动加载依赖后右键项目名 → Add Framework Support → Web Application勾选Web ApplicationVersion 选3.0匹配web.xml中web-app version3.0关键动作点击Web resource directory右侧的...定位到src/main/webappMaven或WebContentEclipse 结构—— 这个路径决定了index.jsp、css/、js/的实际访问根路径。配置 Tomcat ServerRun → Edit Configurations → → Tomcat Server → LocalApplication server指向你本地已下载的 Tomcat 8.5推荐兼容性最好Deployment → → Artifact → 选中项目名:war exploded注意这里必须选exploded解压模式不是war。因为开发阶段要热更新 JSP 和静态资源war包每次都要重打包。Application context填/blog或其他你喜欢的上下文路径如/表示根路径# 验证 Tomcat 是否就绪终端执行 $ $TOMCAT_HOME/bin/startup.sh # Linux/Mac $ $TOMCAT_HOME/bin/startup.bat # Windows # 访问 http://localhost:8080/看到 Apache Tomcat welcome page 即成功2.3 数据库初始化不是只执行 SQL而是打通连接池最后一公里源码包里通常附带db.sql或init.sql但直接执行往往不够。真实落地需三步建库与字符集CREATE DATABASE blog CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;执行建表语句db.sql内容注意检查 SQL 中是否含ENGINEInnoDB DEFAULT CHARSETutf8mb4;—— 若为utf8中文可能存成?务必替换。配置 JDBC 连接核心90% 启动失败源于此找到src/main/resources/jdbc.properties或WEB-INF/web.xml里的context-param确认以下三项jdbc.urljdbc:mysql://localhost:3306/blog?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8mb4serverTimezone必填否则 MySQL 8 报The server time zone value XXX is unrecognizedjdbc.usernamerootjdbc.passwordyour_password若用 Druid 或 C3P0 连接池还需检查druid.properties中driverClassNamecom.mysql.cj.jdbc.DriverMySQL 8或com.mysql.jdbc.DriverMySQL 5.x——驱动类名写错连数据库都连不上更别说报 404。3. 代码层拆解Servlet JSP 如何协作完成一篇博文的增删改查3.1 请求入口web.xml是整个系统的路由总控台不要跳过WEB-INF/web.xml它是 JavaWeb 项目的“宪法”。典型配置如下!-- web.xml -- servlet servlet-nameArticleServlet/servlet-name servlet-classcom.blog.servlet.ArticleServlet/servlet-class /servlet servlet-mapping servlet-nameArticleServlet/servlet-name url-pattern/article/url-pattern /servlet-mapping这意味着浏览器访问http://localhost:8080/blog/article?actionadd→ 触发ArticleServlet的doGet()方法ArticleServlet通过request.getParameter(action)判断操作类型add/update/delete/list关键逻辑Servlet 不负责拼 HTML只处理业务、调 DAO、设置 request 属性然后request.getRequestDispatcher(/list.jsp).forward(request, response);这就是 JSP 的价值把ListArticle丢给list.jsp它用c:forEach遍历输出表格。前后端职责清晰没有 Ajax 时这就是最朴素的 MVC。3.2 业务中枢ArticleServlet的标准写法与状态流转设计一个健壮的ArticleServlet至少包含 5 个分支且每个分支必须明确forward或redirect// ArticleServlet.java protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String action request.getParameter(action); switch (action) { case list: ListArticle articles articleDao.findAll(); request.setAttribute(articles, articles); request.getRequestDispatcher(/list.jsp).forward(request, response); break; case toAdd: request.getRequestDispatcher(/add.jsp).forward(request, response); break; case add: String title request.getParameter(title); String content request.getParameter(content); Article article new Article(title, content, new Date()); articleDao.save(article); response.sendRedirect(request.getContextPath() /article?actionlist); // 重定向防重复提交 break; case delete: int id Integer.parseInt(request.getParameter(id)); articleDao.delete(id); response.sendRedirect(request.getContextPath() /article?actionlist); break; default: response.sendError(HttpServletResponse.SC_NOT_FOUND); } }注意add和delete用sendRedirect()避免刷新页面重复提交list和toAdd用forward()保持 request 域内数据如articles可用。这是 JavaWeb 开发的“玄学”守则——错用就会出现“添加成功但页面没刷新”或“删除后列表仍存在”。3.3 数据持久JDBC 封装的 DAO 层为什么不用 MyBatis 也能稳如泰山源码中常见ArticleDao.java其核心是Connection获取与PreparedStatement参数绑定// ArticleDao.java public class ArticleDao { private static final String INSERT_SQL INSERT INTO t_article(title, content, create_time) VALUES(?, ?, ?); public void save(Article article) throws SQLException { Connection conn JdbcUtil.getConnection(); // 工具类获取连接 PreparedStatement ps conn.prepareStatement(INSERT_SQL); ps.setString(1, article.getTitle()); ps.setString(2, article.getContent()); ps.setTimestamp(3, new Timestamp(article.getCreateTime().getTime())); ps.executeUpdate(); // 关键必须 executeUpdate()不是 executeQuery() JdbcUtil.close(ps, conn); // 必须关闭否则连接泄漏 } }JdbcUtil是自定义工具类封装了DriverManager.getConnection()和try-with-resources逻辑。它比硬写Class.forName()更安全且统一管理连接关闭。很多源码崩溃是因为 DAO 层忘了close()导致 Tomcat 连接池耗尽后续所有请求卡死在getConnection()—— 这是血泪经验。4. 避坑指南JavaWeb个人博客管理系统源码运行中的5个高频翻车现场4.1 现象启动 Tomcat 后访问http://localhost:8080/blog/显示 404但http://localhost:8080/正常原因Application context配置错误或web.xml中welcome-file-list未指定默认首页。解决检查 IDEA 中 Tomcat 配置的Application context是否与项目名一致如项目名blogcontext 必须为/blog在web.xml中添加welcome-file-list welcome-fileindex.jsp/welcome-file /welcome-file-list并确认index.jsp真实存在于webapp/根目录下。4.2 现象登录页提交后跳转空白控制台无报错浏览器 Network 显示200 OK但 Response 为空原因response.sendRedirect()的路径写错或forward()时 JSP 路径不存在。解决sendRedirect()必须带上下文路径response.sendRedirect(request.getContextPath() /login.jsp);forward()的路径是相对于webapp/目录的request.getRequestDispatcher(/admin/index.jsp).forward(...)不能写成/webapp/admin/index.jsp。4.3 现象MySQL 连接成功但执行SELECT * FROM t_article报Table blog.t_article doesnt exist原因db.sql中建表语句未执行或执行时未选中blog库。解决登录 MySQL 命令行mysql -u root -p→USE blog;→SHOW TABLES;确认表存在若表名是article而非t_article检查 DAO 层 SQL 字符串是否硬编码了表名需同步修改。4.4 现象JSP 页面中文显示为??数据库存的是?原因MySQL 连接 URL 缺少characterEncodingutf8mb4或 Tomcat 的server.xml未配置 URI 编码。解决JDBC URL 补全?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8mb4修改$TOMCAT_HOME/conf/server.xml在Connector标签内加URIEncodingUTF-84.5 现象修改 JSP 后刷新页面无变化必须重启 Tomcat原因IDEA 未开启On update action的自动部署或 Tomcat 的reloadable未启用。解决IDEA 中Run → Edit Configurations → Tomcat Server → On update action → Update classes and resourcesserver.xml中Context标签加reloadabletrue仅开发环境生产禁用若仍无效清空$TOMCAT_HOME/work/Catalina/localhost/下对应项目的缓存文件夹。5. 进阶实战把个人博客管理系统从“能跑”升级为“能用”的3个硬核改造点5.1 改造一用 Filter 实现统一登录拦截告别每个 Servlet 里写 if(!login) redirectLoginFilter.java是提升工程规范性的第一块砖。它不侵入业务代码却能强制保护/admin/*下所有资源// LoginFilter.java public class LoginFilter implements Filter { Override public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; String uri request.getRequestURI(); // 放行登录页、登录接口、静态资源 if (uri.contains(/login.jsp) || uri.contains(/login) || uri.endsWith(.css) || uri.endsWith(.js)) { chain.doFilter(req, resp); return; } // 检查 session 中是否有 user HttpSession session request.getSession(false); if (session null || session.getAttribute(user) null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } chain.doFilter(req, resp); } }在web.xml中注册filter filter-nameLoginFilter/filter-name filter-classcom.blog.filter.LoginFilter/filter-class /filter filter-mapping filter-nameLoginFilter/filter-name url-pattern/admin/*/url-pattern /filter-mapping这个 Filter 的价值在于当你新增一个/admin/write.jsp无需改任何 Servlet只要 URL 匹配/admin/*就自动受保护。比在每个 Servlet 里写if(sessionnull) redirect干净十倍。5.2 改造二用 JSTL 替代 Scriptlet让 JSP 从“Java 混合页”变“纯视图模板”源码中常见% while(rs.next()) { %这种嵌套 Java 代码的 JSP维护性极差。换成 JSTL 后% taglib prefixc urihttp://java.sun.com/jsp/jstl/core % c:forEach items${articles} vararticle tr td${article.id}/td td${article.title}/td tdfmt:formatDate value${article.createTime} patternyyyy-MM-dd HH:mm//td td a hrefarticle?actiondeleteid${article.id}删除/a /td /tr /c:forEach落地步骤pom.xml加依赖dependency groupIdjstl/groupId artifactIdjstl/artifactId version1.2/version /dependencyJSP 顶部加% taglib prefixc urihttp://java.sun.com/jsp/jstl/core %EL 表达式${}直接取 request 属性无需%request.getAttribute(articles)%JSTL 不是语法糖它是视图层的“标准化协议”。用它你的 JSP 就能被前端工程师看懂也能被 IDE 正确高亮和校验。5.3 改造三用 Log4j2 记录操作日志把“谁在什么时候删了哪篇文章”变成可追溯证据log4j2.xml配置文件放在src/main/resources/下?xml version1.0 encodingUTF-8? Configuration statusWARN Appenders File nameBlogLog fileNamelogs/blog.log PatternLayout pattern%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n/ /File /Appenders Loggers Logger namecom.blog levelinfo additivityfalse AppenderRef refBlogLog/ /Logger Root levelerror AppenderRef refConsole/ /Root /Loggers /Configuration在ArticleServlet的delete分支中加日志// ArticleServlet.java private static final Logger logger LogManager.getLogger(ArticleServlet.class); // ... case delete: int id Integer.parseInt(request.getParameter(id)); articleDao.delete(id); String username (String) session.getAttribute(username); logger.info(用户 {} 删除文章 ID: {}, username, id); // 结构化日志 response.sendRedirect(...); break;日志文件logs/blog.log会按天滚动内容可直接 grep 查询“grep 删除文章 ID logs/blog.log | tail -20”。这比靠数据库create_time推断操作人靠谱得多——毕竟真正的线上问题永远发生在“昨天下午三点谁点了那个红色按钮”。我带过的实习生第一个月都在和web.xml、context.xml、server.xml打交道第二个月开始改 Filter 和 Log第三个月才敢碰 DAO 层事务隔离级别。这套 JavaWeb 个人博客管理系统源码不是让你速成架构师而是逼你亲手拧紧每一颗螺丝——当http://localhost:8080/blog/终于跳出你写的欢迎来到我的博客那一刻的踏实感是任何框架文档都给不了的。希望帮到你。本文还有配套的精品资源点击获取