企业官网建设流程全解析

简介：面向计算机及相关专业毕业设计的Java Web项目，以饥荒游戏论坛为载体，采用SSH框架（Struts+Spring+Hibernate）、JSP页面和MySQL数据库，支持JDK 1.8，并可在Eclipse、MyEclipse、STS或IDEA等工具中部署运行。系统覆盖前端论坛与后台管理，实现会员注册登录、浏览板块和帖子、发帖回帖、查看版主信息，以及管理员对用户权限、板块信息、帖子置顶和精华的管理。资源共293个文件，以92个JAR依赖包、37个JSP页面和24个Java源码为主体，另含数据库脚本、论文、环境工具包、同框架安装教程及界面素材，压缩包总大小约37.05MB，目录结构清晰，便于按模块理解和二次开发。核心代码包含动作类、表单类与数据库操作类，可直接对应功能模块进行学习；目前已有97人学习下载，适合毕业设计参考、SSH框架实战操练或论坛功能扩展。

1. 从选题到答辩：这类“Java JSP 饥荒游戏论坛 SSH 源码包”到底是什么，值不值得拿来做毕业设计

毕业设计选题选到“基于 JSP 的饥荒游戏论坛”时，大部分人的第一反应是问：这和“管理系统”有什么区别？结论先行：这本质上就是一个带用户体系的 BBS 论坛，核心功能是用户注册登录、按游戏板块浏览帖子、发表回复、管理员删帖置顶。它不碰在线对战、不碰交易系统，所以技术边界很清晰，Java Web 阶段学过的 JSP、Servlet、JDBC 全都用得上；而标题里的 SSH 也不是运维课里那个远程连接工具，而是 Struts2 + Spring + Hibernate 这组经典 Java 架构缩写。qkrp 这类后缀通常是源码发布者用来区分打包版本的自定义标识，对运行结果没有影响。源码包把项目工程、数据库脚本、说明文档和开发环境工具都收在一个压缩包里，意味着你拿到的是一整套可以直接启动的骨架，难点不在“从零实现”，而在“看懂结构、改对参数、能讲清楚”。这篇笔记会按框架拆解、核心功能实现、本地部署、常见坑、答辩前验证这条线讲完，适合正在做同类型选题的学生照着复现。

2. 先分清此“SSH”非彼“SSH”：框架职责与工程结构

2.1 为什么毕业设计还在用 SSH，而不是 SSM 或 Spring Boot

项目标题上写“ssh”，指的是 Struts2 + Spring + Hibernate。这套组合在七八年前几乎是 Java 企业级开发的标配：Struts2 负责接收 HTTP 请求并调用业务层，Spring 负责管理对象和事务，Hibernate 负责把数据库表映射成 Java 对象。现在业界新项目早已转向 Spring Boot + MyBatis/MyBatis Plus，但毕业设计仍然大量出现 SSH，原因很现实：学校题库没更新、指导老师熟、参考论文多、而且答辩时“你能讲清楚分层”比“你用了多新的框架”更占便宜。SSH 的分层非常教科书化，action、service、dao 三层边界清楚，Hibernate 的 ORM 机制也容易画图讲解，这些正好是答辩评审关心的内容。

和 SSM 相比，SSH 最大的差异在持久层：Hibernate 是完整的 ORM 框架，你操作的是 User 对象而不是 ResultSet；MyBatis 则把 SQL 写在 XML/注解里，更灵活但需要手写更多 SQL。论坛这种表结构简单、关联关系固定的场景，恰好在 Hibernate 舒适区内，不需要写复杂 SQL，CRUD 基本能由框架代劳。所以从学习和演示角度，SSH 不“过时”，只是“经典”。你要做的不是推翻它，而是把它运行起来并且能在讲解时说明白。

这里顺便给一个选型判断标准：如果你的源码包里的实体类上标的都是@Entity、@Table这类注解，说明它用的是 Hibernate 注解版，配置量比 XML 映射少，读起来也直观；如果实体类旁边还躺着一堆 .hbm.xml 文件，那属于更早的写法，但原理完全一样。不少人在答辩被问到“Hibernate 和 JDBC 有什么区别”时只会背概念，其实你可以直接指着源码说：我只需要操作对象，不用手写 ResultSet 遍历，这就是 ORM 的价值。这句话比你背十句定义都管用。

2.2 一个请求从 JSP 到数据库的完整链路

要改源码，先背下来一条请求的走向：浏览器访问user_login.action，Struts2 核心过滤器根据 struts.xml 找到 UserAction 的 login 方法；UserAction 从页面表单拿到 username 和 password 参数，调用 userService.login()；Service 层通过 userDao.findByUsername() 让 Hibernate 生成一条 SQL 查出用户记录；返回结果层层上传后，Struts2 把 Action 里设置的字段传到 JSP 页面渲染。

这条链路里每个环节都有明确的“文件落点”，排查问题时特别管用：参数不对查 JSP 表单的 name 和 Action 属性；请求没到方法查 struts.xml；业务报错查 Service 和 Dao；数据查不出来查 Hibernate 映射和数据库。很多新手拿到源码第一件事是到处找“主函数”，但 Web 项目没有 main 方法，入口是 web.xml 里的过滤器配置，理解请求链路比看懂每个文件更重要。链路背下来之后，你在 IDE 里按 Ctrl 点击方法名就能一层层跳下去，调试时打断点的位置也就清楚了：Action 方法入口断点看参数，Dao 方法入口断点看 SQL 是否执行，JSP 页面不用打断点，直接看输出结构。

2.3 源码包里的典型目录结构：先建立全局地图

常规的 SSH 论坛工程会按 src 和 web 两个根目录组织，src 下面按 com.forum 包名拆出 action、service、dao、entity 四个包，web 下面是 JSP 页面和 WEB-INF 配置目录。拿到源码包后，先花十分钟建立这张地图：“三层结构”是骨架；实体写在哪，数据库表对应哪些类；配置文件集中在 src 下的 applicationContext.xml 和 web 下的 struts.xml，web.xml 放在 WEB-INF 下。

forum-ssh/ ├── src/ │ ├── com.forum.entity/ # Hibernate 实体类：User、Board、Post、Reply │ ├── com.forum.dao/ # DAO 接口和实现：IUserDao、UserDaoImpl │ ├── com.forum.service/ # 业务逻辑：UserService、PostService │ ├── com.forum.action/ # Struts2 Action：UserAction、PostAction │ ├── com.forum.util/ # 分页工具、字符串处理 │ ├── applicationContext.xml # Spring 核心配置：数据源、事务、Bean 装配 │ └── struts.xml # Struts2 路由和结果映射（也可放 web 目录） ├── web/ │ ├── jsp/ # login.jsp、register.jsp、post_list.jsp、post_detail.jsp │ ├── WEB-INF/web.xml # 项目入口，配置过滤器与监听器 │ └── index.jsp # 论坛首页，通常做重定向或展示板块列表 └── sql/ └── forum.sql # 建库建表脚本和初始数据

这个结构有三个必须记住的约定：实体类名和数据库表名不一定相同，靠注解或配置文件映射；Action 在 struts.xml 里注册，方法名直接写在 URL 中；applicationContext.xml 负责把 Dao、Service、Action 串起来。改代码前先确认你动的是哪一层，改完按链路自测，基本不会把项目改崩。

关于 Spring 装配，常见做法是 applicationContext.xml 开启组件扫描<context:component-scan base-package="com.forum" />，然后在 Dao 实现类上标@Repository、Service 实现类上标@Service、Action 上标@Controller，依赖注入用@Autowired。这套注解组合如果你见过，说明源码用的是注解配置方式，比老式 XML 配 Bean 省事得多；如果看到一大段<bean id="userDao" class="...">也不要慌，只是写法不同，最终效果一样。答辩时被问“Spring 怎么管理对象”，最简单的回答就是：Spring 启动时扫描包，把标了注解的类实例化放进容器，要用的地方通过 @Autowired 自动注入。这句话足够解释你项目里任何一个对象是怎么被创建和串起来的。

3. 饥荒游戏论坛核心功能拆解：从数据表到 JSP 的完整实现路径

3.1 论坛的数据模型设计：先设计好这四张表，写代码才有底

论坛系统的表结构很典型，绕不开四类数据：用户、板块、帖子、回复。具体的字段设计可以看 src 里对应的实体类，但更建议直接看 sql/forum.sql，这才是数据库的真实面貌。先看用户表和板块表是理解一切的基础，用户表承载注册登录，板块表承载帖子分类。

CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT '用户ID', username VARCHAR(30) NOT NULL UNIQUE COMMENT '登录名', password VARCHAR(64) NOT NULL COMMENT '登录密码，一般存摘要值', nickname VARCHAR(30) COMMENT '昵称，页面展示用', avatar VARCHAR(255) COMMENT '头像图片路径', role TINYINT DEFAULT 0 COMMENT '0普通用户，1管理员', create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '注册时间' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE t_board ( board_id INT PRIMARY KEY AUTO_INCREMENT, board_name VARCHAR(50) NOT NULL COMMENT '板块名，比如：MOD讨论、联机求助', board_desc VARCHAR(255) COMMENT '板块简介', sort_order INT DEFAULT 0 COMMENT '排序权重' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE t_post ( post_id INT PRIMARY KEY AUTO_INCREMENT, board_id INT NOT NULL COMMENT '所属板块', user_id INT NOT NULL COMMENT '发帖人', title VARCHAR(100) NOT NULL, content TEXT COMMENT '帖子内容，支持换行', view_count INT DEFAULT 0, reply_count INT DEFAULT 0 COMMENT '回复数，用于列表排序', post_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE t_reply ( reply_id INT PRIMARY KEY AUTO_INCREMENT, post_id INT NOT NULL COMMENT '所属帖子', user_id INT NOT NULL, content TEXT, reply_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

这四个表的关系很典型：t_post 通过 board_id 关联板块，通过 user_id 关联用户；t_reply 通过 post_id 关联帖子。列表页需要展示作者昵称、帖子标题、回复数、发布时间，所以 SQL 查询中要 join t_user 取 nickname，这条 join 逻辑会贯穿整个帖子列表接口。字段设计上要注意 password 字段的类型：无论有没有用加密工具类，类型都建议 VARCHAR(64)，为接入 MD5/SHA 摘要算法预留长度；如果源码里的 password 是 VARCHAR(20) 且存的明文，那就是老项目的典型痕迹，可以在整改时顺手优化。字符集统一用 utf8mb4，因为论坛内容天然包含 emoji 表情，用 utf8 会直接报错或在页面上变成问号。

3.2 用户模块：注册登录与权限判断的标准写法

用户模块是论坛的门面，代码量不大但涉及三层全部代码。拿登录来说，典型实现是 UserService 里定义 login 方法：先按 username 查用户，再比对密码，两件事分离，避免“用户名不存在”和“密码错误”混在一起。

@Service("userService") @Transactional public class UserServiceImpl implements IUserService { @Autowired private IUserDao userDao; @Override public User login(String username, String password) { if (username == null || password == null) { return null; } User user = userDao.findByUsername(username); if (user != null && user.getPassword().equals(hashPassword(password))) { return user; } return null; } private String hashPassword(String raw) { // 常见做法是把密码做摘要后再入库，工具包里一般有工具类 return DigestUtils.md5Hex(raw + "forum_salt"); } }

这里有个关键约定：login 方法返回 User 对象而不是 boolean。程序调用后，UserAction 把返回的 User 放进 Session，后续帖子页面要显示当前登录人，直接用 Session 里这个 User 的 nickname 即可。如果返回 boolean，不少人都要在 Action 里再查一遍用户，白白多一次数据库访问。密码比对用常量盐拼接，虽然不算高强度，但比存明文强得多，也足够在答辩中解释“为什么不能存明文”：数据库一旦泄露，明文密码直接暴露，加盐摘要后至少不能反推出原始密码。

UserAction 这边，核心是声明属性并暴露 getter/setter，Struts2 才能注入表单字段：

@Controller("userAction") @Scope("prototype") public class UserAction extends ActionSupport { @Autowired private IUserService userService; private String username; private String password; private User user; // login 成功后放入 session public String login() { User u = userService.login(username, password); if (u == null) { addActionError("用户名或密码错误"); return ERROR; } user = u; return SUCCESS; } // getter and setter for username/password/user }

Action 的类上标了@Scope("prototype")，这是 Spring 整合 Struts2 时最不能省略的注解：Action 默认不能是单例，因为每个请求要独立携带参数。如果漏写，并发请求会相互污染 username，页面上会频繁出现“串号”。登录成功后，struts.xml 里把返回的 SUCCESS 映射到首页或登录成功页，用户信息就会在页面显示出来。实际调试中“页面拿不到登录用户”的问题，九成出在返回值映射写错，或者 Action 里的 user 属性没有被放入 session 而页面却从 session 里取。

3.3 帖子模块：分页查询、Java 排序与回复数的列表展示

帖子列表是论坛最有技术含量的一个页面，因为它同时涉及分页、排序和关联查询三件事。列表页一般按两种方式排序：按发帖时间倒序，或者按最后回复时间倒序。后者是“Java 排序”最常见的用武之地：要么在 SQL 里 order by，要么把查出来的 List 丢给一个实现 Comparator 的排序工具。小论坛用 SQL 排省心；当列表需要混合板块展示、需要跨表复杂排序时，先查询再内存排序更灵活。

分页逻辑的标准实现是 Page 工具类：记录总数 totalCount、每页条数 pageSize、当前页码 pageNo，根据这三者算出总页数和偏移量。传给 Hibernate 的方法一般长这样：

public Page<Post> findPostPage(int boardId, int pageNo, int pageSize) { Session session = getSession(); Query<Post> q = session.createQuery( "from Post where boardId = :boardId order by postTime desc", Post.class); q.setParameter("boardId", boardId); q.setFirstResult((pageNo - 1) * pageSize); q.setMaxResults(pageSize); List<Post> list = q.list(); CriteriaBuilder cb = session.getCriteriaBuilder(); CriteriaQuery<Long> cq = cb.createQuery(Long.class); cq.select(cb.count(cq.from(Post.class))); Long total = session.createQuery(cq).getSingleResult(); return new Page<>(list, pageNo, pageSize, total.intValue()); }

setFirstResult 和 setMaxResults 是 Hibernate 分页的核心，setMaxResults 传多大直接决定最终 SQL 的 LIMIT 语句。pageSize 建议做成常量，比如每页 10 条；pageNo 从 JSP 请求参数传入后必须做数字校验，防止负数或超界导致查询异常。totalCount 的 count 查询每次列表请求都会执行一次，数据量小没关系，论坛帖子过十万后再考虑缓存。答辩时如果被问“分页为什么不用 MySQL 的 limit”，你完全可以答：Hibernate 会根据数据库方言自动生成对应的分页 SQL，这正是 ORM 屏蔽差异的价值。

发帖和回复是同样的套路：Action 接收表单参数，Service 组装 Post 实体并设置 postTime 和 user_id，Dao 调用 session.save()。保存之后，同步把 t_post 上的 reply_count 加一，或者从回复数量重新统计。这里用普通 update 即可，因为毕业设计规模不需要考虑并发扣减。如果喜欢表现一下，用update t_post set reply_count = reply_count + 1 where post_id = ?就能避免并发下的计数误差，答辩时可以说你考虑到了原子更新。

3.4 JSP 与 Struts2 配置：页面怎么拿到数据

JSP 是论坛系统的最后出口，也是整个项目里最容易被“嫌弃”却又绕不开的部分。因为用的是 SSH，JSP 页面上会大量出现 Struts2 标签和 JSTL 混用的情况，这两者各管一摊：Struts2 标签迭代 Action 存入的数据，JSTL 负责普通变量输出。列表页的典型写法是 setFirstResult 方法返回的 Page 对象放进 request 后，用 s:iterator 循环输出：

<%@ taglib prefix="s" uri="/struts-tags" %> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <table> <tr><th>标题</th><th>作者</th><th>回复</th><th>时间</th></tr> <s:iterator value="page.list" var="p"> <tr> <td><a href="post_detail.action?postId=${p.postId}">${p.title}</a></td> <td>${p.user.nickname}</td> <td>${p.replyCount}</td> <td><s:date name="#p.postTime" format="yyyy-MM-dd HH:mm" /></td> </tr> </s:iterator> </table>

s:iterator 的 value 指向 Action 中的 page.list，var="p" 定义了循环变量，循环体内通过 ${p.title} 直接读取 Post 的字段。${p.user.nickname} 会触发 Hibernate 的懒加载，因为查询帖子时并没有把 User 对象一并查出，如果项目没有处理这个关联，页面在这一行就会抛 LazyInitializationException，这个问题留到第 5 章展开。帖子列表的及时性还依赖 user 关联不能为空，数据库里的历史脏数据会让页面直接 500，所以初始化脚本里最好把测试用户和帖子绑定好。

struts.xml 的配置决定了上面这些页面如何被找到，一个典型路由片段是：

<package name="forum" namespace="/" extends="struts-default"> <action name="post_*" class="postAction" method="{1}"> <result name="list">/jsp/post_list.jsp</result> <result name="detail">/jsp/post_detail.jsp</result> <result name="input">/jsp/post_list.jsp</result> </action> </package>

post_* 是 Struts2 通配符映射，URL 写成 post_list.action，就会去找 postAction 的 list 方法；result 里的 list、detail 是方法返回的字符串，和 Action 里的 SUCCESS、INPUT 对应。这个文件是“改 URL 找不着页面”时的唯一排查地。理解了三层代码和这台“路由机器”，你改功能就有下手点，而不是看见 JSP 就一头扎进去。面试官或答辩老师问你“Struts2 和 Servlet 有什么区别”，标准回答是：Struts2 把 Servlet API 封装了，你不需要写 doGet/doPost，只需要在 Action 里定义方法，由框架完成请求分发和参数封装。

4. 把源码在本地跑起来：从环境准备到部署的参数清单

4.1 环境版本怎么配：JDK、Tomcat、MySQL 缺一不可

本地跑起 SSH 项目，第一步是环境版本的匹配。这类源码大多按 JDK 1.7 或 1.8 编写，配合 Tomcat 7/8/9 和 MySQL 5.x。如今笔记本上基本都是 JDK 8 以上，运行没问题，但要注意数据库驱动版本：MySQL 5.x 用com.mysql.jdbc.Driver，MySQL 8.x 必须改成com.mysql.cj.jdbc.Driver，URL 还要加 serverTimezone 参数，否则启动时或首次查询就会报时区错误。这个改动看似微小，却是新手最常见的“跑不起来”原因。建议统一按“JDK 1.8 + Tomcat 8.5 + MySQL 5.7”搭配，从工具包里的文档确认作者用的版本，和你的环境一致时问题最少。工具包一般包含 JDK、Tomcat、MySQL 的安装包和 IDE 配置说明，都是网络公开资源，版本以你自己机器为准。

如果本机已经装了 MySQL 8 不想换，可以只改驱动类名和 URL，不需要重装数据库。MySQL 8 的驱动类名变成com.mysql.cj.jdbc.Driver，URL 变成jdbc:mysql://localhost:3306/forum?characterEncoding=utf8&serverTimezone=Asia/Shanghai。这两处改完，绝大多数时区异常都能解决。另外，SSH 项目用 Maven 构建的话，依赖版本都在 pom.xml 里，不建议手改 jar 包，直接改 pom 然后刷新比较稳妥。

4.2 建库建表与数据源配置：先让 Hibernate 有库可用

拿到源码包后按顺序做三件事：新建一个数据库实例，用 SQL 脚本初始化表结构，改数据源配置。MySQL 命令行或图形化工具导入都行，导入后先数一数表数量，并在 t_user 里查一下初始数据，确认脚本跑通。

mysql -uroot -p < sql/forum.sql mysql -uroot -p -e "use forum; show tables; select * from t_user;"

第一条命令把脚本里的建库建表语句全部执行，第二条验证表和初始数据是否存在。如果 show tables 为空，说明脚本里没有 use 语句且当前数据库选错，手动执行use forum;再跑一次脚本即可。

数据库连接配置在 src/applicationContext.xml 里，典型内容：

<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource"> <property name="driverClassName" value="com.mysql.jdbc.Driver" /> <property name="url" value="jdbc:mysql://localhost:3306/forum?characterEncoding=utf8" /> <property name="username" value="root" /> <property name="password" value="123456" /> </bean>

driverClassName、url、username、password 四个就是必须按本地环境修改的参数。characterEncoding=utf8 要保留，否则页面和数据库之间会互相乱码；MySQL 8 则把驱动改为 com.mysql.cj.jdbc.Driver，URL 加 serverTimezone=Asia/Shanghai。不要在密码里出现&这类特殊字符，如果有，先给数据库账号改一个简单的密码再继续，这是规避一整类连接配置问题的快捷方式。

4.3 Spring 与 Struts2 的整合检查点

SSH 项目整体能跑，除了配置数据源，还要确认 web.xml 里三个东西：Struts2 过滤器、Spring 上下文监听器、字符编码过滤器。Struts2 的过滤器是 StrutsPrepareAndExecuteFilter，Spring 需要一个 ContextLoaderListener 从 classpath 加载 applicationContext.xml，编码过滤器则把请求统一转成 UTF-8。三者缺一不可，缺哪个就对应出哪类问题：请求找不到对应 Action、Spring Bean 没有被注入、页面中文乱码。

<filter> <filter-name>struts2</filter-name> <filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class> </filter> <filter-mapping> <filter-name>struts2</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener>

Tomcat 部署方式常用的有两种：把项目打成 war 放到 webapps，或在 IDEA/Eclipse 里配置 Tomcat Server 指向项目。毕业设计阶段建议直接在 IDE 里启动，随手能改能加断点；到写文档、录演示视频时再打 war 放到本机 Tomcat 的 webapps 下，效果一样。war 包部署有一个关键约束：数据库 URL 里的 localhost 不能被换掉，如果部署到别的机器，需要确认目标机器的数据库账号和密码也能从 localhost 访问。

4.4 部署后的第一步自测：从首页到发帖的一条龙

启动 Tomcat 后浏览器访问http://localhost:8080/forum/，看到的应该是板块列表而不是报错页。自测建议按“注册 → 登录 → 发帖 → 回复 → 退出登录 → 管理员登录删帖”的顺序走一遍，把每一步的 URL 和页面结果记录下来，作为答辩时的演示脚本。这个自测脚本的价值比任何口头介绍都大，它按照流程还原了完整链路，大概率在答辩现场能直接做出“能跑也能讲”的效果。

另一个容易忽视的是静态资源路径：JSP 里引用 CSS、JS 用的是相对路径，如果部署后页面没有样式，检查页面 URL 和资源路径。常见做法是把资源放在 web 根目录的 static 或 css 目录下，用<%=request.getContextPath()%>拼接绝对路径，这样不管部署在什么上下文，资源都能被正确定位。这一行代码能省掉换路径时的大量资源 404 排查。

5. 避坑清单：SSH 论坛项目运行中最高频的五个问题排查记录

5.1 帖子页报 LazyInitializationException：懒加载在 JSP 触雷

现象：列表页能打开，但点击标题进详情页后直接 500，控制台报 org.hibernate.LazyInitializationException，提示访问 user 属性时 session 已关闭。

原因：Hibernate 默认懒加载关联对象，Post 的 getTitle、getContent 是自身字段，没有关系；但访问post.getUser().getNickname()时，User 是代理对象，需要打开 Session 才能查出来。典型情况是 Service 方法标了 @Transactional，事务在方法返回时结束，JSP 渲染时 Session 已经关闭，于是访问代理对象就抛异常。

解决：最简单的做法是给需要的关联属性改成即时加载，或者在查询方法里用 join fetch 一次查出关联用户。另一种更省事的是配置 OpenSessionInView 过滤器，把 Session 生命周期拉长到整个请求结束，页面不用动，所有懒加载问题一起消失。毕业设计里推荐后者，但要注意它只在开发/演示场景友好，生产上会带来数据库连接释放延迟，答辩时可以把这两面都讲清楚，反而显得你考虑过取舍。我自己处理这个坑时一般先看源码里 spring 配置文件有没有配 OpenSessionInViewFilter，没有就补一个，五分钟解决问题。

5.2 上传的图片刷新后全部丢失：写入路径在发布目录

现象：管理员上传板块图标、用户改完头像当时正常，第二天再访问图片却 404，重新部署项目后图片直接消失。

原因：代码里把文件写到了request.getServletContext().getRealPath("/upload")，这个目录在项目的发布目录（Tomcat 的 webapps 下），每次重新部署、清理 target 都会被删掉。数据库里存的只是路径字符串，实际文件根本没进数据库，路径指向的文件已经被清掉了。

解决：把上传路径设置为一个硬盘绝对路径，比如D:/forum_upload，数据库里存/upload/xxx.jpg，再通过 Tomcat 的虚拟路径把/upload/**映射到那个外部目录。配置虚拟路径的常见做法是在 server.xml 的 Host 节点加 Context 或配置映射；对 SSH 项目，最可靠的是改 Tomcat 的 server.xml。无论用哪种，核心原则都是“用户文件不能住进发布目录”，这是和后台文件相关的项目中必须养成的一个习惯，否则演示前重新部署一次项目就翻车。

5.3 Tomcat 启动报 NoClassDefFoundError / LinkageError：javassist 版本冲突

现象：启动时控制台报java.lang.NoClassDefFoundError: javassist/ClassPool或java.lang.LinkageError，偶尔伴随 Hibernate 的 SessionFactory 创建失败。

原因：Hibernate 3/4 要 javassist 3.x，而 Struts2 或其它依赖组件使用 javassist 4.x，classpath 里两个版本互相打架。这是典型的“黑匣子”场景，在多个 jar 包里藏着一个版本冲突，靠肉眼逐个检查很累。

解决：打开项目的 lib 目录，把重复的 javassist jar 只留一个高版本；用 Maven 管理的项目，就在 pom.xml 里排除传递依赖，统一版本。这类包冲突问题的排查思路是“先看 class 文件从哪个 jar 来”，启动参数加-verbose:class可以输出类加载来源，一条命令省下半天瞎找。如果你第一次遇到，直接搜索项目里所有javassist*.jar，高版本通常命名为 javassist-3.20.0-GA.jar 这类，留下版本号最大的即可。

5.4 明明数据库有记录，登录却提示“用户不存在或密码错误”

现象：注册成功后重新登录，始终提示用户名或密码错误。到数据库查，记录确实存在，字段值也对着，手动改数据库里的密码却能登录。

原因：注册和登录走了不同的密码处理逻辑。最常见的是注册时数据库写入的是加密后的值，登录时却拿明文比对；或 SQL 里 username 条件拼接了空格字符，条件值前后不一致导致查不到。另一个高发原因是页面表单的 name 属性写错，用户名传成了 nickname，Struts2 注入时没有收到值，查询条件变成了 NULL。

解决：先在 Action 的 login 方法第一行打印 username、password 的实际值，判断参数是否正常接收。然后查表里 password 字段实际存的是明文还是摘要，确认比对双方是不是同一个摘要算法。这个“两边对照着查”的排查动作几乎是通用排查法，所有登录失败案例都能用它定位到具体环节。改完之后顺手做一件事：把密码明文输出从日志里去掉，答辩演示时也别把密码明文打到控制台，这是安全习惯问题。

5.5 中文内容全部变成问号：字符集链路断了

现象：页面显示正常，发一帖含中文标题的帖子，列表页显示“???”，数据库字段里存的就是一串问号。

原因：编码问题贯穿 JSP、过滤器、数据库连接、表结构四层，任何一层字符集不一致就会乱码。比较典型的坑是 JSP 页面头部的 pageEncoding 写的是 ISO-8859-1，或数据库连接 URL 少了 characterEncoding=utf8。代码和页面都正常，但传输链路上某一层把中文转成了错误编码。

解决：按下边顺序统一修：JSP 页头写<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>；web.xml 加 CharacterEncodingFilter；数据库连接 URL 带 characterEncoding=utf8；表结构字符集用 utf8mb4。四处改完重启 Tomcat，通常乱码消失。排查乱码时不要猜，直接在 JSP 里输出一句话、经过过滤器后打印一次、再到数据库 SELECT 一次，看它“在哪一段变坏”。这个“分段打点”的方法同样能解决表单提交中文变乱码的问题，一次定位到具体断层。

6. 进阶玩法：答辩前用四个实操验证把项目讲出层次

代码跑通只是及格线，毕业设计是同行评审，能讲出“为什么这么设计”才有优势。答辩前按四个维度做一次自查。第一，数据层面验证：把 t_post 表手工插入几千条数据，测试分页在 pageNo 超界时的容错。很多源码的分页逻辑没处理“页码超过总页数”，演示时一旦有人手滑点下一页就会直接 500，这是典型的答辩翻车现场。改法可以在 Service 里加判断，也可以在 Page 构造函数里限制 pageNo 不小于 1 且不大于总页数。

第二，安全层面演示：故意在搜索框输入<script>alert("xss")</script>，如果页面弹窗说明没有做转义，JSP 里要按 c:out 或 s:property 输出用户内容。开发中常见做法是引入一个简单的 HTML 过滤工具，或者至少把所有用户输入的位置加上 escape。答辩现场来一次“我输入了这一段，你看它是文本而不是脚本”，比讲十页理论都有说服力。

第三，性能层面：给帖子列表加一个“热门回复排序”按钮，用 reply_count 倒序排列，这可能是源码里没有的功能。实现方式很简单：复制现有分页查询方法，把 order by post_time 改成 order by reply_count desc，再在 JSP 加一个链接参数 sort=hot。这个自主改功能的过程让你真正碰了一次“改代码 → 调试 → 演示”的闭环，答辩时老师问“你做过什么扩展”就有具体案例讲。

第四，文档层面：把部署步骤、自测脚本、数据库设计说明合并成一份 README，放进源码根目录。工具包自带的文档是模板，真正属于你的是这个更新版。答辩评审大概率会问“如果换一台机器，多久能跑起来”，按 README 现场演示从建库到启动的过程，直接回答这个问题，比你临场回忆命令强得多。

我个人一直带的习惯是：“跑得起来”只占一半分数，“讲得清楚”占另一半。一份源码包拿回来，别急着打包上交，先做一次完整自测，再挑一个模块动手改，最后把改动过程写进文档——这个过程会让你的项目从“网上下的源码”变成“我自己维护的项目”。希望这个思路能帮到你，至少在临近提交时不至于对着一个黑匣子心慌。

本文还有配套的精品资源，点击获取