简介这是一套基于Java Web技术开发的博客系统完整源码包面向需要完成课程设计、大作业或毕业设计的计算机专业学生也可作为Web开发入门的实战练习素材。压缩包共629个文件大小约18.43MB包含55个Java源文件、20个JSP页面、36个JAR依赖库、32个XML配置、2个SQL数据库脚本以及HTML/CSS/JS前端资源和大量GIF/JPG/PNG图片素材便于直观了解系统界面与交互流程。源码采用Servlet控制层、JSP表现层、Service业务逻辑层、DAO数据访问层的分层结构覆盖文章发布、相册管理、图片上传、用户信息、留言板、RSS订阅等典型功能模块并配有数据库表设计与配置文件便于在MySQL等环境下快速部署调试。目前已有676人学习参考对于希望通过完整项目理解Java Web全流程的开发者来说是一份结构清晰、内容详实的参考资料。借助清晰的目录结构和分层设计学习者能快速定位并复用文章、相册、留言等模块代码便于二次开发与功能扩展。1. 这个博客系统源码包里到底有什么先别急着跑从类名反推架构下载一个“基于Java Web的博客系统源码.zip”之后打开压缩包的人大概率会先头晕一阵一眼看去既有 .java 文件又有 .class 文件还有 .jsp、.xml 甚至 .cfm 混在里面。抛开“把代码塞进 IDEA 就能跑”的直觉这套源码真正值钱的地方在于它是一份完整的、可拆解的 Java Web 学习标本——Servlet 管请求、JSP 管展示、ServerImpl 管业务、DAO 管数据目录结构把今天很多流行框架刻意藏起来的分层又摆回了明面上。这篇文章就按这个思路拆穿它合适的人能拿它交课程设计、应付毕业设计答辩、备考 java 基础面试题不合适的人也能从里面对照出一个传统 Java Web 应用从请求到响应的完整生命周期。2. 先按名字给源码“验明正身”Action、ServerImpl 与 JSP 的分层关系2.1 从类名反推出来的 MVC 骨架打开压缩包看文件名会发现命名风格高度一致ArticleAction、UserInfoAction、LeavemsgAction 这类以 Action 结尾的类管请求分发ArticleServerImpl、AlbumServerImpl 这类以 ServerImpl 结尾的类管业务逻辑。这个命名习惯很典型——它不是 Spring Boot 那种一个注解搞定一切的风格而是 Servlet JSP 时代最常见的“控制器 - 业务 - 数据”三层手写实现。我把项目正文里出现的类名按职责分了个类这张表可以直接用来做课设答辩的架构说明典型类名推断职责对应技术点ArticleAction、UserInfoAction、LeavemsgAction请求接收与页面跳转Servlet / Controller 层ArticleServerImpl、AlbumServerImpl业务规则与事务边界Service 层接口实现AlbumAjaxAction异步数据交互入口Ajax JSON 响应UploadImgAction文件上传处理文件 IO 与表单解析PictureCheckCode图形验证码生成Java 2D 绘图与 SessionRssBuilderRSS 订阅生成XML 输出与流处理spellchecker.cfm前端拼写检查页面片段表单辅助脚本2.2 JSP 页面与后台类之间怎么对上号这套项目是 JSP 做表现层所以 WAR 包里必然会有一整排 .jsp 页面和上面的 Action 一一对应。用户修改个人资料时浏览器把表单 POST 给 UserInfoActionAction 把参数绑进 User 对象再丢给 UserServerImpl 做更新最后 forward 回“修改成功”页面。理解这条链路对新手特别重要因为很多课程设计只做到“数据库增删改查能通”但讲不清楚一次请求到底经过了几个 Java 文件。这套源码里有一个值得单独提的点AlbumAjaxAction。说明它做了 AJAX 异步交互评论区点赞、相册翻页这类操作不需要整页刷新。这意味着它的前端部分是 HTML CSS JavaScript 和 JSP 混合着写的而不是一个纯 JSP 套页面。如果你要在答辩里讲“前端交互”这就是最好的素材。2.3 技术栈选型的合理性和学习价值有人会问都什么年代了为什么不直接用 Spring Boot道理很简单——课程设计和毕业设计的要求通常限定在“Java Web 课程范围”而 Servlet JSP JSTL EL 才是 Java Web 课程大纲里真正要考的东西。Spring Boot 把 Tomcat 内嵌、依赖管理、自动配置全部包办之后学生反而看不到请求是怎么进容器的。这套源码里你能亲眼看到 web.xml 里的 Servlet 映射、Filter 配置、监听器声明这些恰恰是 java 基础面试题里最高频的考点。另外这些类的命名方式也能看出系统功能边界Article 管文章、Album 管相册、Leavemsg 管留言、UserInfo 管用户。也就是说这个博客系统不只是“发文章 评论”还带着相册和留言板模块功能面比普通课设要宽一截。2.4 这套源码不能直接干什么说句实在话这套源码的定位是学习教具不是生产系统。没有做 XSS 过滤的完整方案没有 SQL 注入的系统性防护密码大概率是 MD5 加密而不是 BCrypt文件上传也没做类型白名单校验。这不是源码作者的锅而是 JSP 时代项目的普遍水平。你要做的是把它当作“骨架”在二次开发时把 Filter 过滤器、参数校验、安全编码补上去。3. 把项目跑起来JDK、Tomcat 与 IDEA 的版本匹配和部署步骤3.1 环境版本怎么选才不给自己挖坑Java Web 老项目的部署第一大坑就是版本错配。根据项目里出现的 Servlet、JSP 类名和 web.xml 特征这个项目的年代应该在 JDK 7 到 JDK 8 之间对应 Tomcat 7 或 8.5。我一般建议统一用 JDK 8 Tomcat 8.5 IDEA 2020 之后的版本这是兼容性最好的组合。JDK 8 是 Java 生态的“钉子户”Tomcat 8.5 支持 Servlet 3.1两个搭配基本不会出现类加载冲突。MySQL 这边用 5.7 或 8.0 都行但驱动选择有讲究MySQL 5.7 用 mysql-connector-java 5.1.49MySQL 8.0 用 8.0.x 驱动。两者的 JDBC 驱动类名不一样8.x 需要在连接串里加 serverTimezone 参数。这个细节下面会单独讲项目跑不起来的原因十有八九在这。3.2 IDEA 导入项目的标准操作流程如果压缩包里包含 pom.xml就用 Maven 方式导入如果没有 pom.xml而是 WEB-INF/lib 下直接放着 jar 包就用普通 Java Enterprise 项目方式导入。判断标准很简单解压后在根目录搜一下 pom.xml 或 build.gradle。下面是 Maven 方式的导入步骤# 解压源码包注意路径不要带中文和空格 unzip 基于Java Web的博客系统源码.zip -d /Users/yourname/projects/blog-system # 检查关键文件是否存在 ls /Users/yourname/projects/blog-system # 期望看到 pom.xml、src/main/java、src/main/webappIDEA 打开方式File → Open → 选中解压目录下的 pom.xml → 选择 Open as Project。首次打开会花几分钟下载依赖这时候不要手滑关掉 IDEA等右下角进度条消失。如果你的网络拉 Maven 中央仓库很慢就在项目根目录的 .mvn 或 settings.xml 里配阿里云镜像。导入完成后确认 Project Structure 里的 Project SDK 是 1.8Language Level 是 8。如果 IDEA 自动给你选了 11 或 17大概率会在编译阶段报出 javax.servlet 包不存在之类的错误——实际上包是存在的只是 JDK 版本把模块系统搞复杂了。3.3 配置 Tomcat 并启动项目IDEA 里要先把 Artifact 配好否则 Tomcat 跑起来也是空转。操作顺序是Run → Edit Configurations → 左上角 → Tomcat Server → Local。在 Deployment 页签里点 选择 Artifact类型选 war explodedApplication context 我习惯改成/这样访问路径就是 http://localhost:8080/不用带项目名。启动前还要改数据库连接配置。这个项目里数据库配置一般在 src/main/resources 下的 db.properties 或 jdbc.properties也可能是 src/database 里的 .sql 文件。常见配置形如jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/blog_db?useUnicodetruecharacterEncodingUTF-8 jdbc.usernameroot jdbc.password123456如果你用的是 MySQL 8.0第一行的驱动类名要换成com.mysql.cj.jdbc.Driver连接串末尾加上serverTimezoneAsia/Shanghai。否则会报Unsupported timezone或者找不到驱动类。数据库先建好再点 Tomcat 的启动按钮。启动成功的标志不是 IDEA 控制台绿了而是日志里出现INFO: Server startup in [xxxx] milliseconds。3.4 访问路径和后台入口的区分普通用户入口是首页路径按 web.xml 里的 welcome-file 决定一般是 index.jsp 或 IndexAction。后台管理入口一般在 /admin/login.jsp 或 /manager/login.jsp用管理员账号登录。这套源码里有 PictureCheckCode 类说明登录页带图形验证码验证码校验失败会返回“验证码错误”的提示。验证码图片如果出不来去看 Tomcat 日志里有没有java.awt.AWTError: Cant connect to X11 window server有的话下文排查章节会给出解法。4. 数据库设计与初始化用户、文章、评论与相册的建表 SQL4.1 博客系统最少需要几张表从类名反推数据库结构这个系统至少需要五张核心表用户表、文章表、评论表、相册表、图片表。RssBuilder 类说明文章要有发布时间和摘要字段AlbumAlbumAjaxAction 说明相册要有独立的封面和描述字段LeavemsgAction 说明留言不是挂在文章下面而是独立的留言板。下面是按博客系统常见需求整理的建表 SQL字段命名和类型兼容 MySQL 5.7 和 8.0CREATE DATABASE IF NOT EXISTS blog_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE blog_db; CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, nickname VARCHAR(50), email VARCHAR(100), avatar VARCHAR(255), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB; CREATE TABLE t_article ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, title VARCHAR(200) NOT NULL, content MEDIUMTEXT, summary VARCHAR(500), category VARCHAR(50), views INT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, CONSTRAINT fk_article_user FOREIGN KEY (user_id) REFERENCES t_user(id) ) ENGINEInnoDB; CREATE TABLE t_comment ( id INT PRIMARY KEY AUTO_INCREMENT, article_id INT NOT NULL, user_id INT NOT NULL, parent_id INT DEFAULT NULL, content VARCHAR(1000) NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, CONSTRAINT fk_comment_article FOREIGN KEY (article_id) REFERENCES t_article(id), CONSTRAINT fk_comment_user FOREIGN KEY (user_id) REFERENCES t_user(id) ) ENGINEInnoDB;这里要说明两个容易在答辩时被追问的设计决策。第一个是parent_id字段它实现评论的楼中楼回复顶级评论的 parent_id 为空子评论指向父评论的 id。这是一张表实现无限层级评论的经典做法。第二个是views字段文章阅读量直接冗余在文章表里而不是单独建一张访问日志表。对课设来说这个设计够用也简单直观。如果要做高并发统计再拆表那是另一个层面的问题。4.2 相册模块的两张表相册是这套源码比普通博客系统多出来的模块对应 AlbumServerImpl 和 AlbumAjaxAction。相册和图片是一对多的关系所以要拆两张表CREATE TABLE t_album ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, album_name VARCHAR(100) NOT NULL, description VARCHAR(255), cover_url VARCHAR(255), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB; CREATE TABLE t_photo ( id INT PRIMARY KEY AUTO_INCREMENT, album_id INT NOT NULL, photo_url VARCHAR(255) NOT NULL, upload_time DATETIME DEFAULT CURRENT_TIMESTAMP, CONSTRAINT fk_photo_album FOREIGN KEY (album_id) REFERENCES t_album(id) ) ENGINEInnoDB;cover_url存的是相册封面图的 URLphoto_url存的是单张图片的访问路径。UploadImgAction 类负责接收上传的图片文件把文件写到服务器磁盘某个目录再把相对路径存进数据库。这里有一个典型坑上传目录如果用相对路径IDEA 里启动的 Tomcat 会把文件写到 Tomcat 的 bin 目录下而不是项目目录下。解决方法是配置一个绝对路径的上传目录或者使用System.getProperty(user.dir)动态获取当前工作目录。4.3 初始化数据怎么处理源码包里通常附带一个 .sql 文件路径可能叫 blog.sql 或 init.sql。按顺序执行mysql -uroot -p blog.sql执行完用show tables;验证五张核心表都在就说明库建好了。如果没有附带 .sql 文件就用上面的建表语句手工建再往 t_user 表插入一个管理员账号用来登录后台INSERT INTO t_user (username, password, nickname) VALUES (admin, MD5(123456), 管理员);password 字段这里用了 MD5(123456)。其实很多 JSP 项目的登录校验是取出密文再比对所以数据库里存 MD5 值才符合校验逻辑。你如果直接把明文 123456 塞进去登录时永远提示密码错误。这个细节我在帮人调试时见过不下五次十个课设里至少三个挂在密码加密方式不一致上。动手前先打开 UserServerImpl 的源码看一眼它用的是什么加密再决定初始化数据怎么插。4.4 字符集与排序规则的中文坑建库时字符集一定要用utf8mb4而不是utf8因为 utf8 在 MySQL 里实际是 utf8mb3存不了 emoji 和生僻字评论里出现表情符号会直接报Incorrect string value错误。排序规则用utf8mb4_general_ci对中文场景够用而且性能比utf8mb4_unicode_ci略好。表已建成 utf8 的执行下面语句批量转换ALTER TABLE t_article CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;连接串里记得带useUnicodetruecharacterEncodingUTF-8这两个参数缺一个JDBC 层写入的数据就可能和表字符集不一致最终表现为页面乱码但数据库控制台正常或者反过来。5. 常见问题排查Tomcat 部署翻车率最高的五个点5.1 页面 404 且 Tomcat 日志没有报错现象Tomcat 成功启动打开 http://localhost:8080/ 显示 404控制台也没有异常堆栈。原因IDEA 部署时 Application context 和实际访问路径不匹配。默认情况下 context 是/项目名_war_exploded你访问根路径当然找不到。解决Run → Edit Configurations → Deployment 页签把 Application context 改成/然后重启 Tomcat。注意 deployment 里如果同时挂了两个 artifact改成/会冲突只保留一个 Web 项目。5.2 控制台日志中文全部乱码现象Tomcat 启动日志里中文全是乱码页面输出倒是正常的。原因IDEA 的控制台编码和 Tomcat 日志输出编码不一致。Windows 上 IDEA 默认用 GBK 读控制台Tomcat 9 输出的是 UTF-8。解决Help → Edit Custom VM Options加一行-Dfile.encodingUTF-8重启 IDEA。同时检查 conf/logging.properties 里java.util.logging.ConsoleHandler.encoding是否等于 UTF-8。页面乱码则是另一回事重点看 JSP 头部是否有% page contentTypetext/html;charsetUTF-8 languagejava %没有就逐页补上。5.3 数据库连接报 ClassNotFoundException现象启动时抛java.lang.ClassNotFoundException: com.mysql.jdbc.Driver或者Cannot create PoolableConnectionFactory。原因MySQL 驱动版本和连接串不匹配。MySQL 5.x 的驱动类名是com.mysql.jdbc.DriverMySQL 8.x 改成了com.mysql.cj.jdbc.Driver。Maven 依赖里的 connector 版本如果和连接串不一致就会在加载驱动这一步翻车。解决先确认 pom.xml 里的 mysql-connector-java 版本再看 db.properties。两者必须配套。8.x 驱动还要在连接串里补serverTimezoneAsia/Shanghai否则报时区错误。改完记得 Maven Reload Project把新依赖拉下来再重启。5.4 验证码图片显示为红叉或空白现象登录页能打开但验证码图片区域是红叉或点击刷新后变空白。Tomcat 控制台出现java.awt.AWTError: Cant connect to X11 window server。原因PictureCheckCode 类用 java.awt 的 BufferedImage 生成图片在 Linux 服务器无显示器环境下AWT 默认尝试连接 X Server连接失败就抛异常。Windows 本地开发一般没有这问题部署到服务器才暴露。解决在 IDEA 的 Tomcat 配置里VM options 加-Djava.awt.headlesstrue。这个参数告诉 JVM 以无头模式运行不依赖显示器也能生成图片。服务器部署时在 startup.sh 的 CATALINA_OPTS 里同样加上这个参数。5.5 表单提交后 Action 拿不到参数现象登录或发文章的表单填完点提交页面跳转后显示“参数为空”或者 Action 里 request.getParameter(username) 返回 null。原因两种可能。第一JSP 表单里 input 的 name 属性和 Action 里获取参数的 key 不一致JSP 里写的是 userServlet 里取的是 username对不上。第二POST 请求体的编码不是 UTF-8中文字段解析后变成乱码或截断。JSP 时代的经典错误就是忘了在请求入口设置编码Tomcat 8 以后 GET 请求的 URI 默认 UTF-8但 POST 请求体仍然是 ISO-8859-1。解决打开源码里的核心 Servlet 或全局 Filter确认有没有这段代码public class EncodingFilter implements Filter { public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { request.setCharacterEncoding(UTF-8); response.setCharacterEncoding(UTF-8); chain.doFilter(request, response); } }如果没有这个 Filter自行补一个并在 web.xml 注册url-pattern写成/*。然后对照 JSP 页面的 name 属性和 Java 类里获取参数的 key把不一致的地方统一掉。6. 二次开发切入点登录拦截、富文本编辑器与分页改造6.1 给后台加一个真正能用的登录拦截器这个项目的后台页面目前大概率是“登录后才能访问”的设定但你如果直接输入后台页面的 URL可能还能打开——因为缺少过滤器拦截。补一个 Filter 是最有性价比的改造既能答答辩时的“安全设计”问题又能让代码更规范。WebFilter(/admin/*) public class LoginFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; HttpSession session request.getSession(); Object user session.getAttribute(loginUser); if (user null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } chain.doFilter(request, response); } }逻辑说明WebFilter注解的路径是/admin/*代表所有以 /admin 开头的请求先过过滤器。过滤器从 Session 里取 loginUser 对象没有就跳回登录页。这个改动的核心思路是“先拦截后放行”而不是在每个页面里重复判断登录状态。注意如果你还想接管静态资源路径要一起处理否则图片和 CSS 被拦了就尴尬。6.2 把文章编辑框从 textarea 换成富文本编辑器原始项目里发文章大概率用的是 textarea写长文很难受。换成一个开源的富文本编辑器工作量大约两个小时。我一般推荐 wangEditor因为它不需要后端配合引入 JS 和 CSS 就能用。在编辑页面里替换 textareadiv ideditor/div script src${pageContext.request.contextPath}/js/wangEditor.min.js/script script const E window.wangEditor; const editor new E(#editor); editor.config.uploadImgServer ${pageContext.request.contextPath}/UploadImgAction; editor.create(); /script参数说明uploadImgServer是图片上传的后端地址指向项目里现成的 UploadImgAction这样编辑器插入图片时会自动走一遍已有的上传逻辑。提交表单时记得在 form 的 submit 事件里把编辑器内容同步回隐藏域否则后端拿不到富文本 HTMLdocument.getElementById(content).value editor.txt.html();这里有个安全注意点富文本内容是 HTML入库后在前台展示如果直接%content%输出会被浏览器解析执行脚本。要过滤掉script标签或者在展示页用 JSTL 的c:out配合 escapeXml 属性转义输出。6.3 文章列表分页从全量查询改成 LIMIT 分页原项目文章列表如果是一次性查全表文章一多页面就卡。分页是课程设计答辩时老师几乎必问的点顺手改成 LIMIT 分页。后端 SQL 改造SELECT id, title, summary, create_time, views FROM t_article ORDER BY create_time DESC LIMIT #{offset}, #{pageSize};对应 Java 侧要算好 offset我一般用这个公式int offset (currentPage - 1) * pageSize; int totalCount articleServer.getArticleCount(); int totalPages (int) Math.ceil((double) totalCount / pageSize);参数说明currentPage是当前页码前端通过?page2传进来pageSize每页条数博客场景一般设 8 到 10 条totalPages用于渲染底部分页按钮。分页查询要配一个 count 查询否则总页数只能靠猜。这是“先查总数再查本页数据”两步走的标准套路也符合现在主流框架里 PageHelper 的工作方式。我开始动手前也以为这种老项目很难跑起来结果真正卡住我的不是 Java 代码而是 MySQL 驱动版本和 IDEA 的编码配置。从那以后我每次导入这类 Java Web 老项目都会强制走一遍“看 pom 版本 → 查连接串 → 配项目编码”的三步流程十分钟内就能让项目进入可改代码的状态。希望今天的这些记录能帮你省掉同样的一圈弯路。本文还有配套的精品资源点击获取
Java Web博客系统源码全解析：从部署到二次开发实战
简介这是一套基于Java Web技术开发的博客系统完整源码包面向需要完成课程设计、大作业或毕业设计的计算机专业学生也可作为Web开发入门的实战练习素材。压缩包共629个文件大小约18.43MB包含55个Java源文件、20个JSP页面、36个JAR依赖库、32个XML配置、2个SQL数据库脚本以及HTML/CSS/JS前端资源和大量GIF/JPG/PNG图片素材便于直观了解系统界面与交互流程。源码采用Servlet控制层、JSP表现层、Service业务逻辑层、DAO数据访问层的分层结构覆盖文章发布、相册管理、图片上传、用户信息、留言板、RSS订阅等典型功能模块并配有数据库表设计与配置文件便于在MySQL等环境下快速部署调试。目前已有676人学习参考对于希望通过完整项目理解Java Web全流程的开发者来说是一份结构清晰、内容详实的参考资料。借助清晰的目录结构和分层设计学习者能快速定位并复用文章、相册、留言等模块代码便于二次开发与功能扩展。1. 这个博客系统源码包里到底有什么先别急着跑从类名反推架构下载一个“基于Java Web的博客系统源码.zip”之后打开压缩包的人大概率会先头晕一阵一眼看去既有 .java 文件又有 .class 文件还有 .jsp、.xml 甚至 .cfm 混在里面。抛开“把代码塞进 IDEA 就能跑”的直觉这套源码真正值钱的地方在于它是一份完整的、可拆解的 Java Web 学习标本——Servlet 管请求、JSP 管展示、ServerImpl 管业务、DAO 管数据目录结构把今天很多流行框架刻意藏起来的分层又摆回了明面上。这篇文章就按这个思路拆穿它合适的人能拿它交课程设计、应付毕业设计答辩、备考 java 基础面试题不合适的人也能从里面对照出一个传统 Java Web 应用从请求到响应的完整生命周期。2. 先按名字给源码“验明正身”Action、ServerImpl 与 JSP 的分层关系2.1 从类名反推出来的 MVC 骨架打开压缩包看文件名会发现命名风格高度一致ArticleAction、UserInfoAction、LeavemsgAction 这类以 Action 结尾的类管请求分发ArticleServerImpl、AlbumServerImpl 这类以 ServerImpl 结尾的类管业务逻辑。这个命名习惯很典型——它不是 Spring Boot 那种一个注解搞定一切的风格而是 Servlet JSP 时代最常见的“控制器 - 业务 - 数据”三层手写实现。我把项目正文里出现的类名按职责分了个类这张表可以直接用来做课设答辩的架构说明典型类名推断职责对应技术点ArticleAction、UserInfoAction、LeavemsgAction请求接收与页面跳转Servlet / Controller 层ArticleServerImpl、AlbumServerImpl业务规则与事务边界Service 层接口实现AlbumAjaxAction异步数据交互入口Ajax JSON 响应UploadImgAction文件上传处理文件 IO 与表单解析PictureCheckCode图形验证码生成Java 2D 绘图与 SessionRssBuilderRSS 订阅生成XML 输出与流处理spellchecker.cfm前端拼写检查页面片段表单辅助脚本2.2 JSP 页面与后台类之间怎么对上号这套项目是 JSP 做表现层所以 WAR 包里必然会有一整排 .jsp 页面和上面的 Action 一一对应。用户修改个人资料时浏览器把表单 POST 给 UserInfoActionAction 把参数绑进 User 对象再丢给 UserServerImpl 做更新最后 forward 回“修改成功”页面。理解这条链路对新手特别重要因为很多课程设计只做到“数据库增删改查能通”但讲不清楚一次请求到底经过了几个 Java 文件。这套源码里有一个值得单独提的点AlbumAjaxAction。说明它做了 AJAX 异步交互评论区点赞、相册翻页这类操作不需要整页刷新。这意味着它的前端部分是 HTML CSS JavaScript 和 JSP 混合着写的而不是一个纯 JSP 套页面。如果你要在答辩里讲“前端交互”这就是最好的素材。2.3 技术栈选型的合理性和学习价值有人会问都什么年代了为什么不直接用 Spring Boot道理很简单——课程设计和毕业设计的要求通常限定在“Java Web 课程范围”而 Servlet JSP JSTL EL 才是 Java Web 课程大纲里真正要考的东西。Spring Boot 把 Tomcat 内嵌、依赖管理、自动配置全部包办之后学生反而看不到请求是怎么进容器的。这套源码里你能亲眼看到 web.xml 里的 Servlet 映射、Filter 配置、监听器声明这些恰恰是 java 基础面试题里最高频的考点。另外这些类的命名方式也能看出系统功能边界Article 管文章、Album 管相册、Leavemsg 管留言、UserInfo 管用户。也就是说这个博客系统不只是“发文章 评论”还带着相册和留言板模块功能面比普通课设要宽一截。2.4 这套源码不能直接干什么说句实在话这套源码的定位是学习教具不是生产系统。没有做 XSS 过滤的完整方案没有 SQL 注入的系统性防护密码大概率是 MD5 加密而不是 BCrypt文件上传也没做类型白名单校验。这不是源码作者的锅而是 JSP 时代项目的普遍水平。你要做的是把它当作“骨架”在二次开发时把 Filter 过滤器、参数校验、安全编码补上去。3. 把项目跑起来JDK、Tomcat 与 IDEA 的版本匹配和部署步骤3.1 环境版本怎么选才不给自己挖坑Java Web 老项目的部署第一大坑就是版本错配。根据项目里出现的 Servlet、JSP 类名和 web.xml 特征这个项目的年代应该在 JDK 7 到 JDK 8 之间对应 Tomcat 7 或 8.5。我一般建议统一用 JDK 8 Tomcat 8.5 IDEA 2020 之后的版本这是兼容性最好的组合。JDK 8 是 Java 生态的“钉子户”Tomcat 8.5 支持 Servlet 3.1两个搭配基本不会出现类加载冲突。MySQL 这边用 5.7 或 8.0 都行但驱动选择有讲究MySQL 5.7 用 mysql-connector-java 5.1.49MySQL 8.0 用 8.0.x 驱动。两者的 JDBC 驱动类名不一样8.x 需要在连接串里加 serverTimezone 参数。这个细节下面会单独讲项目跑不起来的原因十有八九在这。3.2 IDEA 导入项目的标准操作流程如果压缩包里包含 pom.xml就用 Maven 方式导入如果没有 pom.xml而是 WEB-INF/lib 下直接放着 jar 包就用普通 Java Enterprise 项目方式导入。判断标准很简单解压后在根目录搜一下 pom.xml 或 build.gradle。下面是 Maven 方式的导入步骤# 解压源码包注意路径不要带中文和空格 unzip 基于Java Web的博客系统源码.zip -d /Users/yourname/projects/blog-system # 检查关键文件是否存在 ls /Users/yourname/projects/blog-system # 期望看到 pom.xml、src/main/java、src/main/webappIDEA 打开方式File → Open → 选中解压目录下的 pom.xml → 选择 Open as Project。首次打开会花几分钟下载依赖这时候不要手滑关掉 IDEA等右下角进度条消失。如果你的网络拉 Maven 中央仓库很慢就在项目根目录的 .mvn 或 settings.xml 里配阿里云镜像。导入完成后确认 Project Structure 里的 Project SDK 是 1.8Language Level 是 8。如果 IDEA 自动给你选了 11 或 17大概率会在编译阶段报出 javax.servlet 包不存在之类的错误——实际上包是存在的只是 JDK 版本把模块系统搞复杂了。3.3 配置 Tomcat 并启动项目IDEA 里要先把 Artifact 配好否则 Tomcat 跑起来也是空转。操作顺序是Run → Edit Configurations → 左上角 → Tomcat Server → Local。在 Deployment 页签里点 选择 Artifact类型选 war explodedApplication context 我习惯改成/这样访问路径就是 http://localhost:8080/不用带项目名。启动前还要改数据库连接配置。这个项目里数据库配置一般在 src/main/resources 下的 db.properties 或 jdbc.properties也可能是 src/database 里的 .sql 文件。常见配置形如jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/blog_db?useUnicodetruecharacterEncodingUTF-8 jdbc.usernameroot jdbc.password123456如果你用的是 MySQL 8.0第一行的驱动类名要换成com.mysql.cj.jdbc.Driver连接串末尾加上serverTimezoneAsia/Shanghai。否则会报Unsupported timezone或者找不到驱动类。数据库先建好再点 Tomcat 的启动按钮。启动成功的标志不是 IDEA 控制台绿了而是日志里出现INFO: Server startup in [xxxx] milliseconds。3.4 访问路径和后台入口的区分普通用户入口是首页路径按 web.xml 里的 welcome-file 决定一般是 index.jsp 或 IndexAction。后台管理入口一般在 /admin/login.jsp 或 /manager/login.jsp用管理员账号登录。这套源码里有 PictureCheckCode 类说明登录页带图形验证码验证码校验失败会返回“验证码错误”的提示。验证码图片如果出不来去看 Tomcat 日志里有没有java.awt.AWTError: Cant connect to X11 window server有的话下文排查章节会给出解法。4. 数据库设计与初始化用户、文章、评论与相册的建表 SQL4.1 博客系统最少需要几张表从类名反推数据库结构这个系统至少需要五张核心表用户表、文章表、评论表、相册表、图片表。RssBuilder 类说明文章要有发布时间和摘要字段AlbumAlbumAjaxAction 说明相册要有独立的封面和描述字段LeavemsgAction 说明留言不是挂在文章下面而是独立的留言板。下面是按博客系统常见需求整理的建表 SQL字段命名和类型兼容 MySQL 5.7 和 8.0CREATE DATABASE IF NOT EXISTS blog_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE blog_db; CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, nickname VARCHAR(50), email VARCHAR(100), avatar VARCHAR(255), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB; CREATE TABLE t_article ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, title VARCHAR(200) NOT NULL, content MEDIUMTEXT, summary VARCHAR(500), category VARCHAR(50), views INT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, CONSTRAINT fk_article_user FOREIGN KEY (user_id) REFERENCES t_user(id) ) ENGINEInnoDB; CREATE TABLE t_comment ( id INT PRIMARY KEY AUTO_INCREMENT, article_id INT NOT NULL, user_id INT NOT NULL, parent_id INT DEFAULT NULL, content VARCHAR(1000) NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, CONSTRAINT fk_comment_article FOREIGN KEY (article_id) REFERENCES t_article(id), CONSTRAINT fk_comment_user FOREIGN KEY (user_id) REFERENCES t_user(id) ) ENGINEInnoDB;这里要说明两个容易在答辩时被追问的设计决策。第一个是parent_id字段它实现评论的楼中楼回复顶级评论的 parent_id 为空子评论指向父评论的 id。这是一张表实现无限层级评论的经典做法。第二个是views字段文章阅读量直接冗余在文章表里而不是单独建一张访问日志表。对课设来说这个设计够用也简单直观。如果要做高并发统计再拆表那是另一个层面的问题。4.2 相册模块的两张表相册是这套源码比普通博客系统多出来的模块对应 AlbumServerImpl 和 AlbumAjaxAction。相册和图片是一对多的关系所以要拆两张表CREATE TABLE t_album ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, album_name VARCHAR(100) NOT NULL, description VARCHAR(255), cover_url VARCHAR(255), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB; CREATE TABLE t_photo ( id INT PRIMARY KEY AUTO_INCREMENT, album_id INT NOT NULL, photo_url VARCHAR(255) NOT NULL, upload_time DATETIME DEFAULT CURRENT_TIMESTAMP, CONSTRAINT fk_photo_album FOREIGN KEY (album_id) REFERENCES t_album(id) ) ENGINEInnoDB;cover_url存的是相册封面图的 URLphoto_url存的是单张图片的访问路径。UploadImgAction 类负责接收上传的图片文件把文件写到服务器磁盘某个目录再把相对路径存进数据库。这里有一个典型坑上传目录如果用相对路径IDEA 里启动的 Tomcat 会把文件写到 Tomcat 的 bin 目录下而不是项目目录下。解决方法是配置一个绝对路径的上传目录或者使用System.getProperty(user.dir)动态获取当前工作目录。4.3 初始化数据怎么处理源码包里通常附带一个 .sql 文件路径可能叫 blog.sql 或 init.sql。按顺序执行mysql -uroot -p blog.sql执行完用show tables;验证五张核心表都在就说明库建好了。如果没有附带 .sql 文件就用上面的建表语句手工建再往 t_user 表插入一个管理员账号用来登录后台INSERT INTO t_user (username, password, nickname) VALUES (admin, MD5(123456), 管理员);password 字段这里用了 MD5(123456)。其实很多 JSP 项目的登录校验是取出密文再比对所以数据库里存 MD5 值才符合校验逻辑。你如果直接把明文 123456 塞进去登录时永远提示密码错误。这个细节我在帮人调试时见过不下五次十个课设里至少三个挂在密码加密方式不一致上。动手前先打开 UserServerImpl 的源码看一眼它用的是什么加密再决定初始化数据怎么插。4.4 字符集与排序规则的中文坑建库时字符集一定要用utf8mb4而不是utf8因为 utf8 在 MySQL 里实际是 utf8mb3存不了 emoji 和生僻字评论里出现表情符号会直接报Incorrect string value错误。排序规则用utf8mb4_general_ci对中文场景够用而且性能比utf8mb4_unicode_ci略好。表已建成 utf8 的执行下面语句批量转换ALTER TABLE t_article CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;连接串里记得带useUnicodetruecharacterEncodingUTF-8这两个参数缺一个JDBC 层写入的数据就可能和表字符集不一致最终表现为页面乱码但数据库控制台正常或者反过来。5. 常见问题排查Tomcat 部署翻车率最高的五个点5.1 页面 404 且 Tomcat 日志没有报错现象Tomcat 成功启动打开 http://localhost:8080/ 显示 404控制台也没有异常堆栈。原因IDEA 部署时 Application context 和实际访问路径不匹配。默认情况下 context 是/项目名_war_exploded你访问根路径当然找不到。解决Run → Edit Configurations → Deployment 页签把 Application context 改成/然后重启 Tomcat。注意 deployment 里如果同时挂了两个 artifact改成/会冲突只保留一个 Web 项目。5.2 控制台日志中文全部乱码现象Tomcat 启动日志里中文全是乱码页面输出倒是正常的。原因IDEA 的控制台编码和 Tomcat 日志输出编码不一致。Windows 上 IDEA 默认用 GBK 读控制台Tomcat 9 输出的是 UTF-8。解决Help → Edit Custom VM Options加一行-Dfile.encodingUTF-8重启 IDEA。同时检查 conf/logging.properties 里java.util.logging.ConsoleHandler.encoding是否等于 UTF-8。页面乱码则是另一回事重点看 JSP 头部是否有% page contentTypetext/html;charsetUTF-8 languagejava %没有就逐页补上。5.3 数据库连接报 ClassNotFoundException现象启动时抛java.lang.ClassNotFoundException: com.mysql.jdbc.Driver或者Cannot create PoolableConnectionFactory。原因MySQL 驱动版本和连接串不匹配。MySQL 5.x 的驱动类名是com.mysql.jdbc.DriverMySQL 8.x 改成了com.mysql.cj.jdbc.Driver。Maven 依赖里的 connector 版本如果和连接串不一致就会在加载驱动这一步翻车。解决先确认 pom.xml 里的 mysql-connector-java 版本再看 db.properties。两者必须配套。8.x 驱动还要在连接串里补serverTimezoneAsia/Shanghai否则报时区错误。改完记得 Maven Reload Project把新依赖拉下来再重启。5.4 验证码图片显示为红叉或空白现象登录页能打开但验证码图片区域是红叉或点击刷新后变空白。Tomcat 控制台出现java.awt.AWTError: Cant connect to X11 window server。原因PictureCheckCode 类用 java.awt 的 BufferedImage 生成图片在 Linux 服务器无显示器环境下AWT 默认尝试连接 X Server连接失败就抛异常。Windows 本地开发一般没有这问题部署到服务器才暴露。解决在 IDEA 的 Tomcat 配置里VM options 加-Djava.awt.headlesstrue。这个参数告诉 JVM 以无头模式运行不依赖显示器也能生成图片。服务器部署时在 startup.sh 的 CATALINA_OPTS 里同样加上这个参数。5.5 表单提交后 Action 拿不到参数现象登录或发文章的表单填完点提交页面跳转后显示“参数为空”或者 Action 里 request.getParameter(username) 返回 null。原因两种可能。第一JSP 表单里 input 的 name 属性和 Action 里获取参数的 key 不一致JSP 里写的是 userServlet 里取的是 username对不上。第二POST 请求体的编码不是 UTF-8中文字段解析后变成乱码或截断。JSP 时代的经典错误就是忘了在请求入口设置编码Tomcat 8 以后 GET 请求的 URI 默认 UTF-8但 POST 请求体仍然是 ISO-8859-1。解决打开源码里的核心 Servlet 或全局 Filter确认有没有这段代码public class EncodingFilter implements Filter { public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { request.setCharacterEncoding(UTF-8); response.setCharacterEncoding(UTF-8); chain.doFilter(request, response); } }如果没有这个 Filter自行补一个并在 web.xml 注册url-pattern写成/*。然后对照 JSP 页面的 name 属性和 Java 类里获取参数的 key把不一致的地方统一掉。6. 二次开发切入点登录拦截、富文本编辑器与分页改造6.1 给后台加一个真正能用的登录拦截器这个项目的后台页面目前大概率是“登录后才能访问”的设定但你如果直接输入后台页面的 URL可能还能打开——因为缺少过滤器拦截。补一个 Filter 是最有性价比的改造既能答答辩时的“安全设计”问题又能让代码更规范。WebFilter(/admin/*) public class LoginFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; HttpSession session request.getSession(); Object user session.getAttribute(loginUser); if (user null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } chain.doFilter(request, response); } }逻辑说明WebFilter注解的路径是/admin/*代表所有以 /admin 开头的请求先过过滤器。过滤器从 Session 里取 loginUser 对象没有就跳回登录页。这个改动的核心思路是“先拦截后放行”而不是在每个页面里重复判断登录状态。注意如果你还想接管静态资源路径要一起处理否则图片和 CSS 被拦了就尴尬。6.2 把文章编辑框从 textarea 换成富文本编辑器原始项目里发文章大概率用的是 textarea写长文很难受。换成一个开源的富文本编辑器工作量大约两个小时。我一般推荐 wangEditor因为它不需要后端配合引入 JS 和 CSS 就能用。在编辑页面里替换 textareadiv ideditor/div script src${pageContext.request.contextPath}/js/wangEditor.min.js/script script const E window.wangEditor; const editor new E(#editor); editor.config.uploadImgServer ${pageContext.request.contextPath}/UploadImgAction; editor.create(); /script参数说明uploadImgServer是图片上传的后端地址指向项目里现成的 UploadImgAction这样编辑器插入图片时会自动走一遍已有的上传逻辑。提交表单时记得在 form 的 submit 事件里把编辑器内容同步回隐藏域否则后端拿不到富文本 HTMLdocument.getElementById(content).value editor.txt.html();这里有个安全注意点富文本内容是 HTML入库后在前台展示如果直接%content%输出会被浏览器解析执行脚本。要过滤掉script标签或者在展示页用 JSTL 的c:out配合 escapeXml 属性转义输出。6.3 文章列表分页从全量查询改成 LIMIT 分页原项目文章列表如果是一次性查全表文章一多页面就卡。分页是课程设计答辩时老师几乎必问的点顺手改成 LIMIT 分页。后端 SQL 改造SELECT id, title, summary, create_time, views FROM t_article ORDER BY create_time DESC LIMIT #{offset}, #{pageSize};对应 Java 侧要算好 offset我一般用这个公式int offset (currentPage - 1) * pageSize; int totalCount articleServer.getArticleCount(); int totalPages (int) Math.ceil((double) totalCount / pageSize);参数说明currentPage是当前页码前端通过?page2传进来pageSize每页条数博客场景一般设 8 到 10 条totalPages用于渲染底部分页按钮。分页查询要配一个 count 查询否则总页数只能靠猜。这是“先查总数再查本页数据”两步走的标准套路也符合现在主流框架里 PageHelper 的工作方式。我开始动手前也以为这种老项目很难跑起来结果真正卡住我的不是 Java 代码而是 MySQL 驱动版本和 IDEA 的编码配置。从那以后我每次导入这类 Java Web 老项目都会强制走一遍“看 pom 版本 → 查连接串 → 配项目编码”的三步流程十分钟内就能让项目进入可改代码的状态。希望今天的这些记录能帮你省掉同样的一圈弯路。本文还有配套的精品资源点击获取
