农村公益活动管理系统：SSM+MySQL源码解析与毕业设计改造

发布时间：2026/10/26 17:46:36
农村公益活动管理系统：SSM+MySQL源码解析与毕业设计改造

简介：面向计算机专业毕业生的农村社会性公益活动管理系统源代码，基于SSM（Spring、SpringMVC、MyBatis）框架与MySQL数据库构建，涵盖用户登录、活动发布、报名审核、活动管理、捐款管理、日程提醒、数据统计、用户反馈、留言管理及后台用户管理等功能模块，可用于毕业设计选题参考、JavaWeb综合实战或相关课程设计。压缩包共796个文件，以jsp页面、java源码、class文件、jar依赖库为主，同时包含css/js前端样式、xml配置、gif/png图片素材，并附sql数据库脚本、说明文档、LW设计说明及答辩PPT，整体大小约34.53MB，部署后即可运行完整系统。目前已有46人学习下载，包内目录结构清晰，前后台页面分离，方便对照源码和文档快速搭建运行环境。系统内置提醒与统计模块，支持任务日程弹窗提醒和活动数据可视化统计，逻辑完整；对正在准备毕业设计或希望掌握SSM框架开发流程的读者而言，这份资料提供了可直接复用的工程结构、数据库设计以及文档撰写参考，能有效降低开发起步成本。

1. 这套“java农村社会性公益活动管理系统源代码（ssm+mysql+说明文档+LW+PPT）计算机毕业设计源码.zip”值得拆开吗

不少同学拿到“java农村社会性公益活动管理系统源代码（ssm+mysql+说明文档+LW+PPT）计算机毕业设计源码.zip”这个包，第一反应是解压、找 README、照网上的 SSM 教程配环境。结果往往是：代码一行没看，环境先浪费一个通宵。这套源码的本质是一套标准的 SSM 三层架构项目，数据库用 MySQL，附带说明文档、LW（论文）和答辩 PPT，属于毕设圈最常见的“半成品交付包”。它的价值不在于代码写得有多精妙，而在于把毕业设计的地基已经打好；你要做的不是读懂每一行，而是跑通它、吃透核心业务，再往上加自己的功能。适合 Java 基础一般、时间紧、想在一个可靠底座上做二次开发的学生。一句话：这不是给你抄的成品，是给你改的起点。

2. 先把骨架看懂：SSM + MySQL 公益管理系统的分层结构与核心表设计

不要急着启动，先花一个小时把解压后的目录结构看明白。SSM 项目的标准结构是：src/main/java下面按controller、service、mapper（有的叫 dao）、entity（有的叫 pojo）分包；resources里放 Spring 和 MyBatis 配置；webapp下放 JSP 和静态资源。我见过有人拿到的源码src下只有一个包，所有类堆在一起，那种建议直接放弃，分层不清的项目改起来全是坑。这套“农村社会性公益活动管理系统”如果是按正常毕设指导规范写的，你会看到五个核心包：控制层接收请求、业务层写逻辑、持久层操作数据库、实体类映射表、工具包放通用方法。先把包名和类名列出来，画一张粗糙的调用关系图，比什么都强。

2.1 一个活动发布请求在 SSM 里怎么走完

我习惯用一个最小功能——发布公益活动——把整条链路讲清楚。用户在前端 JSP 表单里填活动标题、内容、地点、时间，点提交，请求进入 SpringMVC 的DispatcherServlet，它根据@RequestMapping找到对应的 Controller 方法。Controller 只负责接参数、调服务、决定跳转哪个页面，不写 SQL。业务逻辑在 Service 层做，Service 层调用 Mapper 接口，Mapper 接口通过 MyBatis 的 XML 映射文件执行最终 SQL。下面是最常见的三段代码。

@Controller @RequestMapping("/activity") public class ActivityController { @Autowired private ActivityService activityService; @RequestMapping(value = "/publish", method = RequestMethod.POST) public String publish(Activity activity) { activityService.addActivity(activity); return "redirect:/activity/list"; } }

Controller 里的@Autowired是 Spring 的依赖注入，把 Service 实例交进来，不需要自己 new。redirect:/activity/list是重定向到活动列表接口，防止表单重复提交。参数对象Activity直接接收表单字段，字段名要和 JSP 里 input 的 name 对应，这是 SSM 项目里最容易被忽略的约定。

@Service public class ActivityServiceImpl implements ActivityService { @Autowired private ActivityMapper activityMapper; @Override @Transactional public int addActivity(Activity activity) { activity.setCreateTime(new Date()); activity.setStatus(0); // 0 待审核，1 已发布，2 已结束，3 已取消 return activityMapper.insert(activity); } }

@Service把这个类交给 Spring 容器托管。@Transactional声明事务，方法里任何一步抛 RuntimeException，前面的数据库操作都会回滚。这里要强调：MySQL 事务处理默认隔离级别是 REPEATABLE READ，对公益活动报名这种并发场景够用，不需要去调隔离级别。setStatus(0)是给新增活动一个初始状态，否则数据库里的状态字段会为 NULL，后面审核逻辑就没法判断。

public interface ActivityMapper { int insert(Activity activity); }
<insert id="insert" parameterType="com.example.entity.Activity"> INSERT INTO activity(title, content, location, start_time, end_time, need_num, sign_num, status, publisher_id, create_time) VALUES(#{title}, #{content}, #{location}, #{startTime}, #{endTime}, #{needNum}, 0, #{status}, #{publisherId}, #{createTime}) </insert>

Mapper 接口只定义方法，真正的 SQL 写在 XML 里。#{}是 MyBatis 的预编译占位符，等价于 JDBC 的PreparedStatement，能有效防 SQL 注入；别写${}，那是字符串拼接，风险很大。sign_num插入时直接写死 0，活动刚发布没人报名。parameterType是传入参数类型，现在新版 MyBatis 也可以不写，但老项目里留着自己能看懂。注意insert的返回值是影响行数，一般 1 就是成功，0 就是没插进去，Service 里可以拿这个值判断。

2.2 公益活动系统的数据库表：字段怎么定，关系怎么连

公益管理系统绕不开三个核心实体：用户、活动、报名记录。用户包括管理员、志愿者、组织者，活动由组织者发布，志愿者报名参加。报名关系是一张中间表，因为一个志愿者可以报多个活动，一个活动也可以被多个志愿者报名。下面是我认为毕设里最合理的建表 SQL，你直接对着源码里已有的rural_welfare.sql比对就行。

CREATE TABLE sys_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, real_name VARCHAR(50), role TINYINT DEFAULT 2 COMMENT '1 管理员，2 志愿者，3 组织者', phone VARCHAR(20), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE activity ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(100) NOT NULL, content TEXT, location VARCHAR(100), start_time DATETIME, end_time DATETIME, need_num INT DEFAULT 0, sign_num INT DEFAULT 0, status TINYINT DEFAULT 0 COMMENT '0 待审核，1 已发布，2 已结束，3 已取消', publisher_id INT, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (publisher_id) REFERENCES sys_user(id) ); CREATE TABLE sign_up ( id INT PRIMARY KEY AUTO_INCREMENT, activity_id INT NOT NULL, user_id INT NOT NULL, apply_time DATETIME DEFAULT CURRENT_TIMESTAMP, status TINYINT DEFAULT 0 COMMENT '0 待确认，1 已确认，2 已取消', UNIQUE KEY uk_activity_user (activity_id, user_id), FOREIGN KEY (activity_id) REFERENCES activity(id), FOREIGN KEY (user_id) REFERENCES sys_user(id) );

三个表的逻辑关系很明确：activity.publisher_id指向sys_user.id，代表哪个组织者发起的；sign_up表用(activity_id, user_id)联合唯一索引保证同一个用户不能重复报名同一活动，这个唯一键是防重的最底层保障。字段类型上，用户 ID 和活动 ID 都用INT，状态用TINYINT而不是字符串，原因很简单：字符串 '0' 和数字 0 容易混，而且 TINYINT 占空间小、查询快。时间字段统一用DATETIME，不要用TIMESTAMP，因为后者有 2038 年问题，毕设虽然跑不到那时候，但答辩老师会问。need_num和sign_num是报名上限和已报名人数，后面做并发控制要拿这两个字段做判断。

如果你拿到的 SQL 里没有这三个表，或者表名不叫sys_user、activity、sign_up，你就要花时间自己建。注意外键约束在毕设里可以加，但在实际线上项目一般会去掉外键，因为影响插入删除性能。这里加上是为了让 ER 图画起来好看，答辩加分。password字段长度 64，是因为很多源码里存的是 MD5（32 位）或 SHA-256（64 位），按长不按短设计，省得后面加密算法升级要改表结构。

2.3 配置文件里藏着哪些关键参数

SSM 项目里配置文件比代码更容易翻车。一般至少有三个配置文件需要检查：web.xml、spring-mvc.xml、mybatis-config.xml（有的项目把 MyBatis 配置合到 Spring 里）。web.xml里配置DispatcherServlet和字符编码过滤器，CharacterEncodingFilter必须配在第一个，否则你页面传中文到后端就是乱码。spring-mvc.xml里要配组件扫描和视图解析器，下面这段是最基本的模板。

<context:component-scan base-package="com.example.controller" /> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/views/" /> <property name="suffix" value=".jsp" /> </bean>

base-package只扫描 controller 包，Service 和 Mapper 的扫描放在applicationContext.xml里，这是 SSM 的老规矩。视图解析器的前缀后缀决定 Controller 返回字符串时去哪个目录找 JSP，比如 return "activity/list"，就会去找/WEB-INF/views/activity/list.jsp。如果你的 JSP 放在 webapp 根目录而不是 WEB-INF 下，这个配置就得改，否则一直报 404。

MyBatis 的配置里，最容易被忽略的是 Mapper XML 的扫描路径。我见过一个真实翻车现场：mybatis-config.xml里只写了别名和设置，没写mapperLocations，结果一运行就报 “Invalid bound statement (not found)”，原因就是 Spring 不知道去哪里找 XML 文件。正确做法是在 Spring 的配置里加一行：

<property name="mapperLocations" value="classpath:mapper/*.xml" />

意思是把resources/mapper目录下所有 MyBatis XML 文件都加载进来，让每个 Mapper 接口和对应 XML 绑定。这一行的位置放错，整个项目的所有 SQL 都会失效，排查起来极其隐蔽。

3. 把源码跑起来：MySQL 5.7 + JDK 1.8 + Tomcat 8.5 的组合拳

我在帮人看毕设源码时，发现一个规律：70% 的 “跑不起来” 都不是代码问题，而是环境版本不匹配。这套 SSM 项目如果按照 2019 年前后写的，用 JDK 1.8 + Maven 3.6.x + Tomcat 8.5 + MySQL 5.7 是最稳妥的，千万别为了赶时髦上 JDK 17 和 Tomcat 10，Spring 4 的老项目在 Tomcat 10 上会因为javax.*包名改成jakarta.*直接启动失败。至于 MySQL，网上一搜“mysql 5.7.44 安装过程详细”能找到一堆教程，但重点不是装，而是装完后的驱动和字符集。

3.1 数据库连接配置：mysql 安装完后第一件事是改 jdbc.properties

解压后的源码src/main/resources下一般会有jdbc.properties，或者数据库配置写在 Spring 的 XML 里。打开看一眼，内容大概是这样：

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/rural_welfare?useUnicode=true&characterEncoding=utf8&useSSL=false jdbc.username=root jdbc.password=123456

jdbc.driver这里有个大坑：如果你用的是 MySQL 8.0，驱动类名要改成com.mysql.cj.jdbc.Driver，老驱动/com.mysql.jdbc.Driver在 8.0 里会报警告甚至直接报ClassNotFoundException。如果你的 mysql 下载地址是 MySQL 8.0.46 这种新版本，强烈建议改驱动名。jdbc.url里useUnicode=true&characterEncoding=utf8是防止中文乱码的，useSSL=false是关掉 SSL 握手，老驱动连 MySQL 8.0 会在 SSL 协商时卡住报Public Key Retrieval is not allowed，所以这两个参数别删。账号密码改成你自己本地 MySQL 的 root 密码，我不知道你源码包里写的是什么，但 90% 的包会写123456，不改成自己的必连不上。

如果你拿到的是 MySQL 8.0，还可以在驱动后加allowPublicKeyRetrieval=true。这是老项目踩坑后的后悔药：新版 MySQL 默认缓存 SHA2 密码插件，老驱动连接时需要向后端要公钥，不显式允许就会抛异常。改完jdbc.properties后用命令行测试一下：

mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS rural_welfare DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;"

这条命令里DEFAULT CHARACTER SET utf8很关键，如果建库时不指定，MySQL 会用默认字符集，很多时候是 latin1，后面重新导入中文数据全是乱码。执行时-p会提示输入密码，输入你自己的 root 密码即可。如果这台机器从来没装过 MySQL，先去官网下安装包，Windows 上安装时选“Developer Default”太慢，选Server only就行；安装完记得把bin目录加到 PATH，不然命令行找不到mysql。

3.2 导入 SQL 源码数据和启动 Tomcat 的完整流程

数据库建好后，把源码包里的rural_welfare.sql导进去。常见的操作是用 mysql 命令：

mysql -u root -p rural_welfare < rural_welfare.sql

<是重定向，代表把 SQL 文件里的语句逐行送进 MySQL 执行。如果这个 SQL 文件里已经有CREATE DATABASE和USE语句，上面建库的步骤可以省，但会留下一个问题：SQL 里指定的库名不一定叫rural_welfare，你要和 jdbc.properties 里的库名对齐。我见过有人 jdbc URL 写的是rural_welfare，SQL 文件里建的是welfare，结果两张皮，连不上。稳妥做法是打开 SQL 文件看前 10 行，确认它USE哪个库。

导入成功后，下一步是编译项目。如果你的源码包里有完整的 pom.xml，用 Maven 打一个 war 包：

mvn clean package -DskipTests

clean清掉之前构建的旧产物，package打成 jar 或 war，-DskipTests跳过测试，因为毕设项目里的单元测试经常依赖数据库，不跳过会在构建时报错。如果mvn命令提示找不到，说明你没装 Maven 或没配环境变量。装完 Maven 后，第一次构建会下载大量依赖，这是网络问题高发区，后面避坑章节我会说怎么配镜像。

构建成功后，target目录下会出现一个.war文件，把它复制到 Tomcat 的webapps目录，然后启动 Tomcat：

cd /path/to/tomcat/bin ./startup.sh # Linux / Mac startup.bat # Windows

启动后打开浏览器访问http://localhost:8080/项目名/，比如http://localhost:8080/rural_welfare/。如果你是直接用 IDEA 导入源码，建议在 Project Structure 里把 Artifact 设置为 war exploded，然后配置 Tomcat Server，Deployment 里加这个 artifact，这样改代码后热部署更快，不用每次手动复制 war。无论哪种方式，启动日志里看到 “Startup in XXX ms” 就说明跑起来了。如果日志里出现Address already in use，那就是 Tomcat 默认的 8080 端口被别的进程占了，后面避坑章节我会讲不改代码的处理方法。

4. 按毕业设计需求改功能：志愿者报名、审核状态机与统计报表

源码跑通只是第一步，答辩时老师要看到你自己的东西。我不建议推倒重来，那样工作量太大且容易翻车。合理的做法是在现有 SSM 骨架上加三个高频功能：志愿者报名（涉及事务和并发）、活动审核（涉及状态流转）、数据统计（涉及 SQL 聚合）。这三个功能基本覆盖了大部分公益系统必备业务，而且每一块都有技术点可讲。

4.1 志愿者报名：事务边界、唯一约束与原子自增

报名功能最容易出的问题就是“超报”：活动限制 20 人，结果第 21 个人也能报名成功。根源是报名人数和报名记录是两条操作，先查sign_num再插入，中间被其他事务插队。解决办法有两个思路：第一，给sign_up表的唯一键兜底，同一个用户重复报名直接抛异常；第二，使用 MySQL 的原子自增来更新报名人数，避免先查后改。下面是我推荐的 Service 层写法。

@Override @Transactional(rollbackFor = Exception.class) public boolean signUp(Integer activityId, Integer userId) { // 1. 校验活动是否存在且已发布 Activity activity = activityMapper.selectById(activityId); if (activity == null || activity.getStatus() != 1) { throw new RuntimeException("活动不存在或未发布"); } // 2. 检查是否已经报过名 int count = signUpMapper.selectCount(activityId, userId); if (count > 0) { throw new RuntimeException("请勿重复报名"); } // 3. 插入报名记录 SignUp signUp = new SignUp(); signUp.setActivityId(activityId); signUp.setUserId(userId); signUp.setStatus(0); // 待确认 signUpMapper.insert(signUp); // 4. 原子更新报名人数，SQL 里写 sign_num = sign_num + 1 int rows = activityMapper.increaseSignNum(activityId); if (rows == 0) { throw new RuntimeException("活动人数已满"); } return true; }

这段代码的核心在最后一步：increaseSignNum在 Mapper XML 里写成UPDATE activity SET sign_num = sign_num + 1 WHERE id = #{id} AND sign_num < need_num。这条 SQL 在数据库层面同时做了两件事：自增报名人数，并且用sign_num < need_num条件保证没有超报。当人数已满时，MySQL 更新影响行数为 0，Service 层拿到 0 就抛出异常，事务回滚，刚刚插入的sign_up记录也会被撤销。这就是 MySQL 事务处理和行锁的典型应用。如果用 Java 代码先select sign_num判断再 update，两个请求并发时都读到 19，然后都去报名，就会变成 21 人，这种问题在答辩时被老师提“并发超卖”是很尴尬的。

还需要说一句：@Transactional(rollbackFor = Exception.class)比只写@Transactional更稳，因为 Spring 默认只回滚 RuntimeException，而有些代码会习惯性抛出受检异常，如果不指定rollbackFor，事务不会回滚，数据就半残了。这也是 java 面试题里经常问的点，你答出来会让老师觉得你真是自己写的。

4.2 活动审核状态机：用字段状态控制流转而不是删数据

公益活动发布后，组织者或管理员要审核。很多初学者会直接把活动记录 delete 掉，或者用 is_deleted 软删除，但审核本质不是删除，而是状态迁移。我建议给活动表设计一个明确的状态机：0 待审核、1 已发布（审核通过）、2 已结束、3 已取消。每次审核只做合法迁移，非法迁移直接拒绝。代码可以这样写。

private static final List<Integer> VALID_AUDIT_STATUS = Arrays.asList(1, 3); public int auditActivity(Integer id, Integer targetStatus) { Activity activity = activityMapper.selectById(id); if (activity == null) { throw new RuntimeException("活动不存在"); } Integer current = activity.getStatus(); // 只有待审核的活动才能变成发布或取消 if (current != 0 || !VALID_AUDIT_STATUS.contains(targetStatus)) { throw new RuntimeException("非法的状态流转：当前状态不能变为目标状态"); } return activityMapper.updateStatus(id, targetStatus); }

在 MyBatis 的 XML 文件里，updateStatus可以写成：

<update id="updateStatus"> UPDATE activity SET status = #{status} WHERE id = #{id} </update>

这里要说明的是，状态机的硬校验放在 Java 代码里比放在 SQL 里更直观，而且便于写清业务规则。为什么不直接用UPDATE activity SET status = 1 WHERE id = ?一条 SQL？因为你无法保证这个活动当前确实处于待审核状态。如果活动已经结束了，把它的状态改回发布，界面上的“进行中”列表会混进过期数据。用状态机虽然多写几行 if，但能保证数据始终在业务约束内。

在实现时，我一般会把状态机和枚举配合起来用。定义一个枚举ActivityStatus：

public enum ActivityStatus { PENDING(0, "待审核"), PUBLISHED(1, "已发布"), FINISHED(2, "已结束"), CANCELED(3, "已取消"); private final int code; private final String desc; ActivityStatus(int code, String desc) { this.code = code; this.desc = desc; } public int getCode() { return code; } }

这样 JSP 页面里显示状态时就调用ActivityStatus.PUBLISHED.getDesc()，不会出现一串没人懂的数字。答辩时如果老师问“为什么用枚举”，你就说为了让状态可读、可扩展，再往列表加一个状态只需要加枚举项，不用改数据库。

4.3 统计报表：用一条 SQL 聚合代替 Java 循环

公益活动管理系统在答辩时通常要展示数据统计，比如每月报名人数、活动类型分布。很多新手会在 Service 里查全表，再用 Java 的 for 循环累加，这种写法能跑，但数据量一上来就慢，而且代码臃肿。正确做法是让 MySQL 先聚合好，只把结果集返回给 Java。下面这条 SQL 是统计每个月的报名数。

SELECT DATE_FORMAT(apply_time, '%Y-%m') AS month, COUNT(*) AS total FROM sign_up GROUP BY month ORDER BY month;

在 MyBatis 里，我需要定义一个统计结果对象，或者直接用Map<String, Object>接收。

<select id="selectSignUpMonthly" resultType="java.util.HashMap"> SELECT DATE_FORMAT(apply_time, '%Y-%m') AS month, COUNT(*) AS total FROM sign_up GROUP BY month ORDER BY month </select>

resultType写成java.util.HashMap后，MyBatis 会把每一行变成一个 Map，month和total是 key。前端拿到这个 List 后，用 ECharts 画折线图或者柱状图都方便。这里的DATE_FORMAT是 MySQL 专有函数，把DATETIME类型的apply_time格式化到月份，再分组。需要注意：如果用 MySQL 5.7 的 ONLY_FULL_GROUP_BY 模式，SELECT后面的非聚合字段必须出现在GROUP BY里，这条 SQL 只有month和COUNT(*)，不违反。如果以后要加更多维度，比如按活动分类统计，就把activity_id也加进GROUP BY。

另外推荐一个加分统计：每个活动报名人数与需求人数比，即参与率。

SELECT a.title, a.need_num, a.sign_num, ROUND(a.sign_num * 100.0 / a.need_num, 2) AS participation_rate FROM activity a WHERE a.need_num > 0 ORDER BY participation_rate DESC;

ROUND(..., 2)控制保留两位小数，a.need_num > 0防止除零。这条 SQL 展示的是 MySQL 计算能力，答辩时可以引出“索引的重要性”：如果活动表数据量大，ORDER BY participation_rate DESC会做文件排序，要优化就得在need_num、sign_num上建联合索引。

5. 避坑排查：SSM 公益系统源码跑不通时的五类现场

这部分全是我带毕设时遇到的高频问题，每条按“现象 → 原因 → 解决”的顺序说，你可以当成排查手册用。真出了问题，按顺序查，不要怀疑人生。

5.1 数据库连接失败，MySQL 服务没启动或账号密码错

现象：启动 Tomcat 后，日志里报Cannot create PoolableConnectionFactory (Access denied for user 'root'@'localhost')或者Communications link failure。原因分两种：MySQL 服务没起来，或者jdbc.properties里的账号密码与本地不一致。解决：先在命令行跑mysql -u root -p，能进去说明服务正常，那就是密码错；进不去，感受一下具体报错。如果密码连续输错三次，MySQL 会把连接拒掉，你需要去my.ini里找到skip-grant-tables临时跳过权限检查，或者用安装时设置的 root 密码登录。Windows 下检查服务状态常用命令是：

net start mysql

如果提示服务名无效，说明你安装时的服务名不叫 mysql，运行services.msc看一下服务列表，找到 MySQL 相关的名字，手动启动。还有个常见问题是端口被防火墙挡住，Tomcat 在云服务器上，数据库连不上，先ping一下对方 IP，再查云安全组是否放行 3306。

5.2 页面中文乱码，数据库存进去就是问号

现象：活动标题显示成???或活娨，特别像乱码。原因有三个层次：Tomcat 接收表单请求编码不对、MySQL 连接 URL 没指定字符集、数据库表本身是 latin1。依次排查。第一步，在jdbc.properties里确认有characterEncoding=utf8，没有就加。第二步，检查数据库字符集设置，用 mysql 数据库常用命令查：

SHOW VARIABLES LIKE 'character_set%';

如果看到character_set_server是latin1，就要在建表语句或启动参数里改正。最省事的方式是删库重建，建库时明确：

CREATE DATABASE rural_welfare DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

第三步，检查 JSP 页面头部是否写了pageEncoding="UTF-8"，web.xml里的CharacterEncodingFilter是否配置。这三个都对齐了，乱码基本绝迹。顺带一提，MySQL 8.0 默认字符集已是 utf8mb4，比 utf8 更全，但老项目用 utf8 也兼容。

5.3 启动报 Invalid bound statement (not found)

现象：项目能编译，Tomcat 也起来了，但一访问某个列表接口，控制台就抛Invalid bound statement (not found): com.example.mapper.ActivityMapper.selectList。原因：MyBatis 的 Mapper 接口找到了，但对应的 XML 没加载，接口和 SQL 没绑定成功。解决：检查 Spring 配置里有没有把mapperLocations指向classpath*:mapper/*.xml。如果没有，加上；如果加了但还不行，看看 XML 文件的 namespace 是否和接口全限定名一致。一个典型的 namespace 错误是把com.example.mapper.ActivityMapper写成了ActivityMapper，MyBatis 会匹配失败。另一个隐蔽点：如果你的 XML 文件放在src/main/java而不是resources，Maven 默认不会把.xml复制到target/classes，所以打包后找不到。解决是在 pom.xml 里加一句：

<resources> <resource> <directory>src/main/java</directory> <includes> <include>**/*.xml</include> </includes> </resource> </resources>

这种问题属于典型的“黑匣子”，因为报错信息只告诉你没绑定，不会告诉你 XML 在哪丢的。排查时先确认target/classes/mapper/下有没有对应 XML 文件。

5.4 Tomcat 8080 端口被占用，Address already in use

现象：启动 Tomcat 时，命令行直接抛出Port 8080 required by Tomcat v8.5 Server at localhost is already in use。原因：之前残留的 Tomcat 进程没杀干净，或者别的服务占用了 8080。解决：Windows 下用netstat -ano | findstr 8080找到占用端口的进程 PID，然后taskkill /PID 对应数字 /F。注意这条命令需要用管理员权限执行。如果不想杀进程，改 Tomcat 端口更快：编辑conf/server.xml，把<Connector port="8080"改成 8081，重启 Tomcat，访问地址也改成 8081。改端口后 jdbc.properties 不用动，因为那连的是 MySQL 的 3306，不是 Tomcat 的 8080。

5.5 Maven 依赖下载慢或卡死，构建一直停在 downloading

现象：执行mvn clean package后，进度一直卡在Downloading: https://repo.maven.apache.org/...，十几分钟没动静，最后报超时。原因：Maven 默认中央仓库在国外，国内网络访问慢。解决：在settings.xml里配置阿里云镜像。这个文件在 Maven 安装目录的conf/settings.xml，打开编辑，在<mirrors>标签内加：

<mirror> <id>aliyunmaven</id> <name>aliyun maven</name> <url>https://maven.aliyun.com/repository/public</url> <mirrorOf>central</mirrorOf> </mirror>

<mirrorOf>central</mirrorOf>表示只对中央仓库镜像，其他三方仓库不受影响。改完重启 Maven。如果项目里还有不入库的本地 jar（有些毕设源码会把 jstl 的 jar 放在lib目录），你要确认 pom.xml 里有没有把它们设成systemscope，否则打 war 包时这些 jar 不会带进去，运行时会报ClassNotFoundException。这种“源码里带 lib”的项目在导师电脑上能跑，到你这就缺包，是最玄学的一类问题。

6. 让答辩更稳：源码里的 LW 和 PPT 怎么快速改成自己的思路

源码包里带的那份说明文档和 LW（论文），大概率是别人家的故事，光改个名字交上去是不行的，答辩老师一问技术细节就露馅。我的做法是：先把论文里的系统架构图改成本项目真实的分层结构，然后对照核心表把 ER 图画一遍，最后把论文里“技术介绍”那一章删了，换成我从实际代码里抽出来的技术点。PPT 只讲四条主线——项目背景、SSM 架构、核心业务表、一个亮点功能，每一条配一张截图或一张流程图。我当年就是没把技术讲清楚，被老师连续追问事务和 AOP 之间关系，场面一度很尴尬。这里给你补两个能顺利接住提问的修正方向：一是说清楚 Spring 的事务是 AOP 的典型应用，@Transactional是在方法外层生成代理对象来开启和提交事务；二是主动提 MySQL 的事务隔离级别对报名并发的影响，说明你是怎么用sign_num = sign_num + 1这个原子操作规避超报的。这些点比任何华丽界面都经得起问。再有一个低成本加分项：给系统加一个 ECharts 统计页，展示每月报名趋势，把数据源换成前面统计 SQL，模板的痕迹就淡了很多。源码是自己的，能解释清楚工作原理，答辩就稳了。希望这些踩坑经验能帮你少走一点弯路，祝顺利。

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