简介这是一份基于JavaWeb的博客系统毕业设计项目源码采用前后端分离架构适合作为毕业设计、期末大作业参考也便于Java初学者上手实操。压缩包共1139个文件、10.16MB核心包括Java源码与编译类.java/.class、JavaScript416个、HTML326个、CSS128个以及SQL数据库脚本、配置文件、字体图标等能清晰看到前后端模块结构。目前已有2109人学习下载说明项目热度较高且验证可行。源码附带完善注释覆盖文章管理、用户登录等典型博客功能配合Dao、Servlet等分层设计可帮助理解业务逻辑与请求处理流程同时目录规整便于直接运行调试与二次扩展对完成课程设计或提升JavaWeb实践能力都很有价值。1. 拿到这套 JavaWeb 博客系统源码先别急着改作者名很多同学下载了这份「基于 JavaWeb 的博客系统毕业设计项目源码完美注释高分必看.zip」第一反应是解压、改页脚、然后直接打包交差。等到了答辩现场老师随口问一句“你的过滤器是怎么写的”“评论功能为什么不用 Ajax”你就只能站在那里笑。这套源码的价值不在于“能跑”而在于它是少见的、注释覆盖到业务层和工具类的毕设代码包——从登录注册、文章发布到评论管理整个流程都能对上 JavaWeb 课程设计的标准三层结构。这篇文章会把导入 IDEA、配置数据库、跑通首启、读懂注释逻辑、避开常见坑这几个步骤完整拆开让你既能交出一份能演示的博客系统也能在回答“为什么这么写”的时候心里有底。全文面向两类人拿它做毕业设计的学生以及想快速搭一个 JavaWeb 博客原型、再往里面加自己思路的开发者。2. 导入 IDEA 之前先看懂这套 JavaWeb 博客系统的技术栈与目录结构2.1 用 Maven 还是手动导包先看根目录有没有 pom.xml解压 zip 之后第一件事不是双击打开 IDEA而是先看一眼根目录里有没有pom.xml。这套博客系统如果是 Maven 工程导入方式完全不同。常见的情况是项目里既有src目录也有.idea或.classpath这样的 Eclipse 痕迹说明作者可能在不同 IDE 之间切换过。我的做法是先把解压后的文件夹重命名为全英文路径比如D:\graducation_blog避免中文路径和空格导致 Tomcat 部署失败。接下来确认目录结构blog-system/ ├── pom.xml ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/xxx/blog/ │ │ │ ├── controller/ # Servlet 控制器层 │ │ │ ├── service/ # 业务逻辑接口与实现 │ │ │ ├── dao/ # MyBatis 或 JDBC 数据访问层 │ │ │ ├── entity/ # 实体类 │ │ │ └── util/ # 工具类 │ │ ├── resources/ │ │ │ ├── jdbc.properties │ │ │ ├── mybatis-config.xml │ │ │ └── mapper/ │ │ └── webapp/ │ │ ├── WEB-INF/web.xml │ │ ├── static/ │ │ ├── jsp/ │ │ └── index.jsp │ └── test/ └── sql/ └── blog.sql这套结构对应的就是 JavaWeb 最经典的 SSM 组合Spring 管对象、Spring MVC 管请求分发、MyBatis 管数据库。如果你看到的是没有pom.xml的版本那多半是 Servlet JSP JDBC 的纯 JavaWeb 项目导入方式是在 IDEA 里选New - Project from Existing Sources然后手动添加lib目录下的 jar 包。两者没有优劣之分但判断错类型会导致后面一整串报错。2.2 IDEA 导入 Maven 版源码的完整步骤确认有pom.xml后按这个顺序操作能省掉大量折腾时间打开 IDEA选择File - New - Project from Existing Sources定位到解压后的根目录选择pom.xmlIDEA 会以 Maven 方式导入。弹窗里Import Maven projects automatically保持勾选JDK选择 1.8。别选 11 或 17Tomcat 插件和老版本 Spring 在更高 JDK 下容易出现IllegalAccessError。导入后打开Maven Projects工具窗口点击刷新图标让依赖下载。如果下载缓慢在Settings - Build Tools - Maven里把镜像换成阿里云仓库否则spring-webmvc这类大包可能要等很久。配置 TomcatRun - Edit Configurations - - Tomcat Server - Local在Deployment选项卡里点 - Artifact选择war exploded格式然后在Server选项卡的On Update里选择Update classes and resources。启动前把Application context改成/blog这样访问路径就是http://localhost:8080/blog和源码里 basePath 的写法保持一致。Tomcat 版本建议用 8.5 或 9.0。这套源码如果用的是javax.servlet包名10.1 以上的 Tomcat 会直接报ClassNotFoundException因为 Jakarta EE 已经把包名改成了jakarta.servlet。Tomcat 8.5 是兼容性最稳的选择这算是我在这个项目上最想让你记住的一条经验。2.3 resources 目录里藏着整个项目的命门src/main/resources是整个项目最容易出错的地方里面三个文件决定着系统能不能连上数据库、能不能被 Spring 容器正常加载jdbc.properties存放数据库连接信息包不齐会导致Cannot create PoolableConnectionFactory。mybatis-config.xml是 MyBatis 全局配置里面通常会配置别名包路径和驼峰映射。mapper目录下是每个实体对应的 SQL 映射文件比如UserMapper.xml、ArticleMapper.xml。我一般会先打开jdbc.properties确认数据库名、用户名、密码是否和本机 MySQL 一致。很多同学报 500 错误问题就出在这里。这套源码在注释里会写清楚每个字段的用途但不会帮你自动适配本地数据库所以这份文件属于必改项。3. 本地把博客系统跑起来数据库初始化、Tomcat 配置与首启验证3.1 用 Navicat 或命令行导入 blog.sql源码包里通常会附带sql目录里面是建库建表脚本。用 Navicat 导入是最快的新建数据库命名为blog_db或脚本里指定的库名字符集选utf8mb4排序规则选utf8mb4_general_ci然后右键运行 SQL 文件选中blog.sql执行即可。如果你的机器上没装 Navicat用命令行也完全可以mysql -u root -p create database blog_db default character set utf8mb4; use blog_db; source D:/graducation_blog/sql/blog.sql;导入完成后可以用这三条命令快速验证表是否齐全show tables; select * from sys_user limit 5; select count(*) from blog_article;如果blog_article表里已经有几条测试文章数据说明导入成功。这里有个容易忽略的参数SQL 文件里的DROP TABLE IF EXISTS语句默认启用。也就是说重复导入会把已有数据全部清掉。调试阶段无所谓如果你已经在系统里发布过文章再执行一次导入就等于删库没有后悔药。所以我建议导入前先把blog.sql备份一份。3.2 修改 jdbc.properties 的 3 个参数打开resources/jdbc.properties你会看到类似这样的内容jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/blog_db?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456需要改的就是jdbc.url里的数据库名、jdbc.username和jdbc.password。如果你本机 MySQL 是 8.x 版本驱动要换成com.mysql.cj.jdbc.Driver并且serverTimezone参数必须保留否则会报时区错误。5.7 版本用原来的com.mysql.jdbc.Driver就行。改完配置后在 IDEA 里执行Build - Rebuild Project确保target目录下的classes里生成了最新的.properties文件。很多人改了配置发现还是连不上旧库就是因为没重新编译Tomcat 加载的还是旧 class 文件。3.3 Tomcat 启动后的三段式验证启动 Tomcat 后看到Server startup in xxx ms只是第一步。我的习惯是按顺序做三个验证访问http://localhost:8080/blog/login.jsp确认页面能打开且 CSS 样式正常。如果样式全丢按 F12 看 Network 面板静态资源 404 基本是web.xml里 servlet-mapping 把/static/*拦截了。用blog.sql里的管理员账号登录后台进入文章管理页能列表展示说明 MyBatis 映射正常。发一篇文章标题含中文和英文混合提交后看是否能正常回显。这一步同时验证了请求编码和数据库连接的字符集。三条全部通过这套博客系统才算在你的机器上真正跑通。首启成功后再去看代码逻辑状态完全不同——你至少知道哪段代码对应哪个页面。4. 核心功能代码拆读登录拦截、文章发布与评论的注释逻辑4.1 登录逻辑从 LoginServlet 看懂 Controller 层写法这套源码的注释做得最用心的部分是登录功能。打开controller/LoginServlet.java你会看到类似下面的代码结构WebServlet(/login) public class LoginServlet extends HttpServlet { private UserService userService new UserService(); Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { // 1. 获取表单提交的用户名和密码 String username req.getParameter(username); String password req.getParameter(password); // 2. 调用业务层查询用户这里做了一层封装 // 返回的 User 对象里包含了 id、昵称、角色等信息 User user userService.login(username, password); // 3. 判断结果并跳转 if (user ! null) { // 密码正确把用户信息放进 session方便之后做登录拦截 HttpSession session req.getSession(); session.setAttribute(loginUser, user); resp.sendRedirect(req.getContextPath() /admin/index); } else { // 密码错误回登录取并携带提示信息 req.setAttribute(errorMsg, 用户名或密码错误); req.getRequestDispatcher(/login.jsp).forward(req, resp); } } }这段代码逻辑很朴素但注释把每一层的职责说明白了。你在答辩时被问到“登录是怎么实现的”照着注释里三步走回答就行——先取参数再调 Service最后按结果分流。这里有一个值得注意的参数resp.sendRedirect用的是req.getContextPath() /admin/index而不是写死/blog/admin/index这样项目改部署名后依然能正常工作。如果你想把这段代码改造成更规范的写法可以引入 BaseServlet 统一处理请求分发避免每个 Servlet 都重写一遍doGet和doPost。但作为毕设保持现状完全够用老师要看到的是你对三层架构的理解不是炫技。4.2 登录拦截器Filter 的全过程注释filter/LoginFilter.java是评委必看的一个类。因为它回答了一个核心问题为什么直接访问后台管理页会被踢回登录页。WebFilter(/admin/*) public class LoginFilter implements Filter { Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; HttpServletResponse resp (HttpServletResponse) response; // 1. 放行登录请求本身否则会死循环 String uri req.getRequestURI(); if (uri.contains(/login) || uri.contains(/captcha)) { chain.doFilter(request, response); return; } // 2. 判断 session 中是否存在登录用户 HttpSession session req.getSession(false); Object loginUser (session ! null) ? session.getAttribute(loginUser) : null; // 3. 没有登录就重定向到登录页带上原始请求地址 if (loginUser null) { resp.sendRedirect(req.getContextPath() /login.jsp?redirect req.getRequestURI()); } else { chain.doFilter(request, response); } } }这段代码的注释清楚标注了三个分支。面试官问“过滤器为什么要排除/login”答案就在注释里如果过滤器把登录请求也拦了用户永远进不了系统逻辑上形成死循环。至于session.getSession(false)这个参数的意思是“拿不到就不创建新 session”避免未登录请求也占用服务端内存这算是一个小亮点。4.3 Mapper 层MyBatis 参数绑定再往下看dao/ArticleMapper.xml你会发现 SQL 注释告诉你每个查询的用途。比如分页查询文章的片段是这样写的select idselectArticlePage resultTypecom.xxx.blog.entity.Article SELECT a.id, a.title, a.summary, a.cover_image, a.create_time, u.nickname AS authorName FROM blog_article a LEFT JOIN blog_user u ON a.author_id u.id where if testkeyword ! null and keyword ! AND a.title LIKE CONCAT(%, #{keyword}, %) /if /where ORDER BY a.create_time DESC LIMIT #{offset}, #{pageSize} /select#{offset}和#{pageSize}是 MyBatis 的预编译参数能有效防 SQL 注入。而CONCAT(%, #{keyword}, %)写的模糊查询比直接传%${keyword}%安全得多后者会有注入风险。这套源码里的注释特别在 SQL 上方标明了“防止 SQL 注入”之类的关键字答辩时你可以主动提这一点能让老师对你的安全意识印象加分。5. 避坑与常见问题JavaWeb 博客系统最容易翻车的 6 个位置5.1 访问路径 404Context Path 配错现象是 Tomcat 正常启动但访问http://localhost:8080/blog/login.jsp直接 404IDEA 控制台没有报错。原因是 Tomcat 的Application context不是/blog。如果设置成/那你访问的时候就要去掉博客系统路径直接http://localhost:8080/login.jsp。源码里的basePath如果是绝对路径也会因为部署名不一致导致跳转后 404。解决方法是回到Run - Edit Configurations - Tomcat Server - Deployment把Application context改为与web.xml中项目路径一致的值。最容易的做法是统一改成/blog同时检查 JSP 页面顶部的这段代码% String basePath request.getScheme() :// request.getServerName() : request.getServerPort() request.getContextPath() /; %这样所有静态资源引用都以%basePath%开头部署名怎么改都不会断链。5.2 MySQL 连接失败密码正确却报拒绝访问现象是项目启动时报Access denied for user rootlocalhost。原因有三个高频来源第一jdbc.properties里的密码写错第二MySQL 8.x 的认证插件是caching_sha2_password老版本 MySQL Connector 驱动不认第三用户权限只允许 localhost而 Tomcat 通过 127.0.0.1 连接。解决时先打开命令行用mysql -u root -p验证本地能进然后在jdbc.properties里把驱动改成com.mysql.cj.jdbc.DriverURL 确保有useSSLfalse。如果还不行执行下面这条 SQL 刷新权限ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码; FLUSH PRIVILEGES;5.3 中文乱码页面显示问号现象是前台文章标题显示正常但后台新增文章后页面上全是???问号。原因是三个环节有一个字符集没用 utf8mb4数据库表结构、JDBC 连接 URL、JSP 页面编码。数据库表可能在导入blog.sql时用了默认的 latin1。解决办法是把表批量转换ALTER TABLE blog_article CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;然后在jdbc.properties的 URL 里确认有characterEncodingutf8再检查 JSP 顶部有没有% page contentTypetext/html;charsetUTF-8 %。三条链路只要断一条就会翻车。5.4 静态资源 404图片和 CSS 加载不出来现象是页面结构在但 CSS 全丢图片裂开控制台报GET /blog/static/css/style.css 404。原因是web.xml里的DispatcherServlet把*.do或/映射了导致对静态资源的请求也走 Servlet而 Servlet 里没有对应方法就返回 404。解决方法是确认spring-mvc.xml里配置了资源映射mvc:resources location/static/ mapping/static/**/ mvc:annotation-driven/如果这套源码是纯 Servlet 没接 Spring MVC那就在web.xml里看看有没有servlet-mapping拦截/static/*有就去掉。改完后记得Rebuild并重启 TomcatIDEA 有时候没有自动同步 webapp 目录的改动。5.5 IDEA 热部署失效修改 JSP 后页面不更新现象是改了 JSP 文件刷新浏览器还是旧页面。原因是 Tomcat 集成配置里的On frame deactivation没有选择Update resources。IDEA 默认是Do nothing导致 JSP 修改后不会自动拷贝到target/classes或 Tomcat 的 webapp 目录只能重启 Tomcat。解决方法是打开Run - Edit Configurations - Server - On frame deactivation选择Update classes and resources。这样每次切换到 IDEA 窗口时修改过的 JSP、图片、CSS 会被自动发布到 Tomcat省掉大量重启等待时间。不过有个坑如果只改了 Java 类还是需要手动Build - Rebuild热部署对新增方法不一定生效。5.6 日志看不到 SQL 输出现象是项目运行正常但控制台看不到 MyBatis 执行的 SQL排查数据问题时无从下手。原因是log4j.properties或mybatis-config.xml里没有开启日志级别。解决方法是把 MyBatis 的日志级别设到 DEBUG。在log4j.properties中加入log4j.logger.com.xxx.blog.daoDEBUGcom.xxx.blog.dao要换成你项目实际的 Mapper 包路径。这样执行任何数据库操作时控制台都会打印预编译的 SQL 和参数列表在排查“为什么查不到数据”时几乎是玄学变科学的关键一步。6. 答辩前值得做的 3 个扩展点与验证清单如果你的答辩时间充裕我建议在现有源码基础上加一个原创小功能哪怕很小也比原封不动更能体现工作量。最容易的是在文章列表加一个全站搜索框。前台表单提交关键词到SearchServlet直接复用ArticleMapper.xml里已经写好的selectArticlePage传一个keyword进去就完成了约等于把注释里已有的能力暴露到页面上。如果你想在代码层面体现一点深度可以给评论功能加上预审核开关在评论表加一个status字段默认 0后台管理页面增加“通过/删除”两个按钮。这个功能改动量不大但会涉及表结构、DAO、Service、Controller、JSP 五个层面答辩时你能完整说出一条数据链路比空泛地说“我熟悉 SSM”有说服力得多。项目跑通后我建议你花 20 分钟按这个清单把所有功能走一遍注册新用户、登录、修改个人资料、发文章、编辑文章、删除文章、发表评论、退出登录。每走一步在纸上记下对应 URL这就是你答辩时的演示脚本。当年我帮忙审过几份毕设代码发现很多学生只演示了登录和看文章列表老师一问“我记得你系统里有评论管理你展示一下”现场打开来却发现评论列表页 500气氛直接凝固。我希望这个坑你别踩。这套 JavaWeb 博客系统源码确实称得上“注释完美”但注释是作者的做完这些扩展你才能真正把它叫成自己的项目。祝你顺利希望这篇笔记能帮到你。本文还有配套的精品资源点击获取 JavaWeb博客系统源码导入与配置实战：从IDEA到Tomcat部署避坑指南
简介这是一份基于JavaWeb的博客系统毕业设计项目源码采用前后端分离架构适合作为毕业设计、期末大作业参考也便于Java初学者上手实操。压缩包共1139个文件、10.16MB核心包括Java源码与编译类.java/.class、JavaScript416个、HTML326个、CSS128个以及SQL数据库脚本、配置文件、字体图标等能清晰看到前后端模块结构。目前已有2109人学习下载说明项目热度较高且验证可行。源码附带完善注释覆盖文章管理、用户登录等典型博客功能配合Dao、Servlet等分层设计可帮助理解业务逻辑与请求处理流程同时目录规整便于直接运行调试与二次扩展对完成课程设计或提升JavaWeb实践能力都很有价值。1. 拿到这套 JavaWeb 博客系统源码先别急着改作者名很多同学下载了这份「基于 JavaWeb 的博客系统毕业设计项目源码完美注释高分必看.zip」第一反应是解压、改页脚、然后直接打包交差。等到了答辩现场老师随口问一句“你的过滤器是怎么写的”“评论功能为什么不用 Ajax”你就只能站在那里笑。这套源码的价值不在于“能跑”而在于它是少见的、注释覆盖到业务层和工具类的毕设代码包——从登录注册、文章发布到评论管理整个流程都能对上 JavaWeb 课程设计的标准三层结构。这篇文章会把导入 IDEA、配置数据库、跑通首启、读懂注释逻辑、避开常见坑这几个步骤完整拆开让你既能交出一份能演示的博客系统也能在回答“为什么这么写”的时候心里有底。全文面向两类人拿它做毕业设计的学生以及想快速搭一个 JavaWeb 博客原型、再往里面加自己思路的开发者。2. 导入 IDEA 之前先看懂这套 JavaWeb 博客系统的技术栈与目录结构2.1 用 Maven 还是手动导包先看根目录有没有 pom.xml解压 zip 之后第一件事不是双击打开 IDEA而是先看一眼根目录里有没有pom.xml。这套博客系统如果是 Maven 工程导入方式完全不同。常见的情况是项目里既有src目录也有.idea或.classpath这样的 Eclipse 痕迹说明作者可能在不同 IDE 之间切换过。我的做法是先把解压后的文件夹重命名为全英文路径比如D:\graducation_blog避免中文路径和空格导致 Tomcat 部署失败。接下来确认目录结构blog-system/ ├── pom.xml ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/xxx/blog/ │ │ │ ├── controller/ # Servlet 控制器层 │ │ │ ├── service/ # 业务逻辑接口与实现 │ │ │ ├── dao/ # MyBatis 或 JDBC 数据访问层 │ │ │ ├── entity/ # 实体类 │ │ │ └── util/ # 工具类 │ │ ├── resources/ │ │ │ ├── jdbc.properties │ │ │ ├── mybatis-config.xml │ │ │ └── mapper/ │ │ └── webapp/ │ │ ├── WEB-INF/web.xml │ │ ├── static/ │ │ ├── jsp/ │ │ └── index.jsp │ └── test/ └── sql/ └── blog.sql这套结构对应的就是 JavaWeb 最经典的 SSM 组合Spring 管对象、Spring MVC 管请求分发、MyBatis 管数据库。如果你看到的是没有pom.xml的版本那多半是 Servlet JSP JDBC 的纯 JavaWeb 项目导入方式是在 IDEA 里选New - Project from Existing Sources然后手动添加lib目录下的 jar 包。两者没有优劣之分但判断错类型会导致后面一整串报错。2.2 IDEA 导入 Maven 版源码的完整步骤确认有pom.xml后按这个顺序操作能省掉大量折腾时间打开 IDEA选择File - New - Project from Existing Sources定位到解压后的根目录选择pom.xmlIDEA 会以 Maven 方式导入。弹窗里Import Maven projects automatically保持勾选JDK选择 1.8。别选 11 或 17Tomcat 插件和老版本 Spring 在更高 JDK 下容易出现IllegalAccessError。导入后打开Maven Projects工具窗口点击刷新图标让依赖下载。如果下载缓慢在Settings - Build Tools - Maven里把镜像换成阿里云仓库否则spring-webmvc这类大包可能要等很久。配置 TomcatRun - Edit Configurations - - Tomcat Server - Local在Deployment选项卡里点 - Artifact选择war exploded格式然后在Server选项卡的On Update里选择Update classes and resources。启动前把Application context改成/blog这样访问路径就是http://localhost:8080/blog和源码里 basePath 的写法保持一致。Tomcat 版本建议用 8.5 或 9.0。这套源码如果用的是javax.servlet包名10.1 以上的 Tomcat 会直接报ClassNotFoundException因为 Jakarta EE 已经把包名改成了jakarta.servlet。Tomcat 8.5 是兼容性最稳的选择这算是我在这个项目上最想让你记住的一条经验。2.3 resources 目录里藏着整个项目的命门src/main/resources是整个项目最容易出错的地方里面三个文件决定着系统能不能连上数据库、能不能被 Spring 容器正常加载jdbc.properties存放数据库连接信息包不齐会导致Cannot create PoolableConnectionFactory。mybatis-config.xml是 MyBatis 全局配置里面通常会配置别名包路径和驼峰映射。mapper目录下是每个实体对应的 SQL 映射文件比如UserMapper.xml、ArticleMapper.xml。我一般会先打开jdbc.properties确认数据库名、用户名、密码是否和本机 MySQL 一致。很多同学报 500 错误问题就出在这里。这套源码在注释里会写清楚每个字段的用途但不会帮你自动适配本地数据库所以这份文件属于必改项。3. 本地把博客系统跑起来数据库初始化、Tomcat 配置与首启验证3.1 用 Navicat 或命令行导入 blog.sql源码包里通常会附带sql目录里面是建库建表脚本。用 Navicat 导入是最快的新建数据库命名为blog_db或脚本里指定的库名字符集选utf8mb4排序规则选utf8mb4_general_ci然后右键运行 SQL 文件选中blog.sql执行即可。如果你的机器上没装 Navicat用命令行也完全可以mysql -u root -p create database blog_db default character set utf8mb4; use blog_db; source D:/graducation_blog/sql/blog.sql;导入完成后可以用这三条命令快速验证表是否齐全show tables; select * from sys_user limit 5; select count(*) from blog_article;如果blog_article表里已经有几条测试文章数据说明导入成功。这里有个容易忽略的参数SQL 文件里的DROP TABLE IF EXISTS语句默认启用。也就是说重复导入会把已有数据全部清掉。调试阶段无所谓如果你已经在系统里发布过文章再执行一次导入就等于删库没有后悔药。所以我建议导入前先把blog.sql备份一份。3.2 修改 jdbc.properties 的 3 个参数打开resources/jdbc.properties你会看到类似这样的内容jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/blog_db?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456需要改的就是jdbc.url里的数据库名、jdbc.username和jdbc.password。如果你本机 MySQL 是 8.x 版本驱动要换成com.mysql.cj.jdbc.Driver并且serverTimezone参数必须保留否则会报时区错误。5.7 版本用原来的com.mysql.jdbc.Driver就行。改完配置后在 IDEA 里执行Build - Rebuild Project确保target目录下的classes里生成了最新的.properties文件。很多人改了配置发现还是连不上旧库就是因为没重新编译Tomcat 加载的还是旧 class 文件。3.3 Tomcat 启动后的三段式验证启动 Tomcat 后看到Server startup in xxx ms只是第一步。我的习惯是按顺序做三个验证访问http://localhost:8080/blog/login.jsp确认页面能打开且 CSS 样式正常。如果样式全丢按 F12 看 Network 面板静态资源 404 基本是web.xml里 servlet-mapping 把/static/*拦截了。用blog.sql里的管理员账号登录后台进入文章管理页能列表展示说明 MyBatis 映射正常。发一篇文章标题含中文和英文混合提交后看是否能正常回显。这一步同时验证了请求编码和数据库连接的字符集。三条全部通过这套博客系统才算在你的机器上真正跑通。首启成功后再去看代码逻辑状态完全不同——你至少知道哪段代码对应哪个页面。4. 核心功能代码拆读登录拦截、文章发布与评论的注释逻辑4.1 登录逻辑从 LoginServlet 看懂 Controller 层写法这套源码的注释做得最用心的部分是登录功能。打开controller/LoginServlet.java你会看到类似下面的代码结构WebServlet(/login) public class LoginServlet extends HttpServlet { private UserService userService new UserService(); Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { // 1. 获取表单提交的用户名和密码 String username req.getParameter(username); String password req.getParameter(password); // 2. 调用业务层查询用户这里做了一层封装 // 返回的 User 对象里包含了 id、昵称、角色等信息 User user userService.login(username, password); // 3. 判断结果并跳转 if (user ! null) { // 密码正确把用户信息放进 session方便之后做登录拦截 HttpSession session req.getSession(); session.setAttribute(loginUser, user); resp.sendRedirect(req.getContextPath() /admin/index); } else { // 密码错误回登录取并携带提示信息 req.setAttribute(errorMsg, 用户名或密码错误); req.getRequestDispatcher(/login.jsp).forward(req, resp); } } }这段代码逻辑很朴素但注释把每一层的职责说明白了。你在答辩时被问到“登录是怎么实现的”照着注释里三步走回答就行——先取参数再调 Service最后按结果分流。这里有一个值得注意的参数resp.sendRedirect用的是req.getContextPath() /admin/index而不是写死/blog/admin/index这样项目改部署名后依然能正常工作。如果你想把这段代码改造成更规范的写法可以引入 BaseServlet 统一处理请求分发避免每个 Servlet 都重写一遍doGet和doPost。但作为毕设保持现状完全够用老师要看到的是你对三层架构的理解不是炫技。4.2 登录拦截器Filter 的全过程注释filter/LoginFilter.java是评委必看的一个类。因为它回答了一个核心问题为什么直接访问后台管理页会被踢回登录页。WebFilter(/admin/*) public class LoginFilter implements Filter { Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; HttpServletResponse resp (HttpServletResponse) response; // 1. 放行登录请求本身否则会死循环 String uri req.getRequestURI(); if (uri.contains(/login) || uri.contains(/captcha)) { chain.doFilter(request, response); return; } // 2. 判断 session 中是否存在登录用户 HttpSession session req.getSession(false); Object loginUser (session ! null) ? session.getAttribute(loginUser) : null; // 3. 没有登录就重定向到登录页带上原始请求地址 if (loginUser null) { resp.sendRedirect(req.getContextPath() /login.jsp?redirect req.getRequestURI()); } else { chain.doFilter(request, response); } } }这段代码的注释清楚标注了三个分支。面试官问“过滤器为什么要排除/login”答案就在注释里如果过滤器把登录请求也拦了用户永远进不了系统逻辑上形成死循环。至于session.getSession(false)这个参数的意思是“拿不到就不创建新 session”避免未登录请求也占用服务端内存这算是一个小亮点。4.3 Mapper 层MyBatis 参数绑定再往下看dao/ArticleMapper.xml你会发现 SQL 注释告诉你每个查询的用途。比如分页查询文章的片段是这样写的select idselectArticlePage resultTypecom.xxx.blog.entity.Article SELECT a.id, a.title, a.summary, a.cover_image, a.create_time, u.nickname AS authorName FROM blog_article a LEFT JOIN blog_user u ON a.author_id u.id where if testkeyword ! null and keyword ! AND a.title LIKE CONCAT(%, #{keyword}, %) /if /where ORDER BY a.create_time DESC LIMIT #{offset}, #{pageSize} /select#{offset}和#{pageSize}是 MyBatis 的预编译参数能有效防 SQL 注入。而CONCAT(%, #{keyword}, %)写的模糊查询比直接传%${keyword}%安全得多后者会有注入风险。这套源码里的注释特别在 SQL 上方标明了“防止 SQL 注入”之类的关键字答辩时你可以主动提这一点能让老师对你的安全意识印象加分。5. 避坑与常见问题JavaWeb 博客系统最容易翻车的 6 个位置5.1 访问路径 404Context Path 配错现象是 Tomcat 正常启动但访问http://localhost:8080/blog/login.jsp直接 404IDEA 控制台没有报错。原因是 Tomcat 的Application context不是/blog。如果设置成/那你访问的时候就要去掉博客系统路径直接http://localhost:8080/login.jsp。源码里的basePath如果是绝对路径也会因为部署名不一致导致跳转后 404。解决方法是回到Run - Edit Configurations - Tomcat Server - Deployment把Application context改为与web.xml中项目路径一致的值。最容易的做法是统一改成/blog同时检查 JSP 页面顶部的这段代码% String basePath request.getScheme() :// request.getServerName() : request.getServerPort() request.getContextPath() /; %这样所有静态资源引用都以%basePath%开头部署名怎么改都不会断链。5.2 MySQL 连接失败密码正确却报拒绝访问现象是项目启动时报Access denied for user rootlocalhost。原因有三个高频来源第一jdbc.properties里的密码写错第二MySQL 8.x 的认证插件是caching_sha2_password老版本 MySQL Connector 驱动不认第三用户权限只允许 localhost而 Tomcat 通过 127.0.0.1 连接。解决时先打开命令行用mysql -u root -p验证本地能进然后在jdbc.properties里把驱动改成com.mysql.cj.jdbc.DriverURL 确保有useSSLfalse。如果还不行执行下面这条 SQL 刷新权限ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码; FLUSH PRIVILEGES;5.3 中文乱码页面显示问号现象是前台文章标题显示正常但后台新增文章后页面上全是???问号。原因是三个环节有一个字符集没用 utf8mb4数据库表结构、JDBC 连接 URL、JSP 页面编码。数据库表可能在导入blog.sql时用了默认的 latin1。解决办法是把表批量转换ALTER TABLE blog_article CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;然后在jdbc.properties的 URL 里确认有characterEncodingutf8再检查 JSP 顶部有没有% page contentTypetext/html;charsetUTF-8 %。三条链路只要断一条就会翻车。5.4 静态资源 404图片和 CSS 加载不出来现象是页面结构在但 CSS 全丢图片裂开控制台报GET /blog/static/css/style.css 404。原因是web.xml里的DispatcherServlet把*.do或/映射了导致对静态资源的请求也走 Servlet而 Servlet 里没有对应方法就返回 404。解决方法是确认spring-mvc.xml里配置了资源映射mvc:resources location/static/ mapping/static/**/ mvc:annotation-driven/如果这套源码是纯 Servlet 没接 Spring MVC那就在web.xml里看看有没有servlet-mapping拦截/static/*有就去掉。改完后记得Rebuild并重启 TomcatIDEA 有时候没有自动同步 webapp 目录的改动。5.5 IDEA 热部署失效修改 JSP 后页面不更新现象是改了 JSP 文件刷新浏览器还是旧页面。原因是 Tomcat 集成配置里的On frame deactivation没有选择Update resources。IDEA 默认是Do nothing导致 JSP 修改后不会自动拷贝到target/classes或 Tomcat 的 webapp 目录只能重启 Tomcat。解决方法是打开Run - Edit Configurations - Server - On frame deactivation选择Update classes and resources。这样每次切换到 IDEA 窗口时修改过的 JSP、图片、CSS 会被自动发布到 Tomcat省掉大量重启等待时间。不过有个坑如果只改了 Java 类还是需要手动Build - Rebuild热部署对新增方法不一定生效。5.6 日志看不到 SQL 输出现象是项目运行正常但控制台看不到 MyBatis 执行的 SQL排查数据问题时无从下手。原因是log4j.properties或mybatis-config.xml里没有开启日志级别。解决方法是把 MyBatis 的日志级别设到 DEBUG。在log4j.properties中加入log4j.logger.com.xxx.blog.daoDEBUGcom.xxx.blog.dao要换成你项目实际的 Mapper 包路径。这样执行任何数据库操作时控制台都会打印预编译的 SQL 和参数列表在排查“为什么查不到数据”时几乎是玄学变科学的关键一步。6. 答辩前值得做的 3 个扩展点与验证清单如果你的答辩时间充裕我建议在现有源码基础上加一个原创小功能哪怕很小也比原封不动更能体现工作量。最容易的是在文章列表加一个全站搜索框。前台表单提交关键词到SearchServlet直接复用ArticleMapper.xml里已经写好的selectArticlePage传一个keyword进去就完成了约等于把注释里已有的能力暴露到页面上。如果你想在代码层面体现一点深度可以给评论功能加上预审核开关在评论表加一个status字段默认 0后台管理页面增加“通过/删除”两个按钮。这个功能改动量不大但会涉及表结构、DAO、Service、Controller、JSP 五个层面答辩时你能完整说出一条数据链路比空泛地说“我熟悉 SSM”有说服力得多。项目跑通后我建议你花 20 分钟按这个清单把所有功能走一遍注册新用户、登录、修改个人资料、发文章、编辑文章、删除文章、发表评论、退出登录。每走一步在纸上记下对应 URL这就是你答辩时的演示脚本。当年我帮忙审过几份毕设代码发现很多学生只演示了登录和看文章列表老师一问“我记得你系统里有评论管理你展示一下”现场打开来却发现评论列表页 500气氛直接凝固。我希望这个坑你别踩。这套 JavaWeb 博客系统源码确实称得上“注释完美”但注释是作者的做完这些扩展你才能真正把它叫成自己的项目。祝你顺利希望这篇笔记能帮到你。本文还有配套的精品资源点击获取