SSM大学生心理健康平台毕设开发全指南：框架搭建到部署避坑

简介：这是一份基于SSM（Spring+SpringMVC+MyBatis）框架的大学生心理健康平台项目源码，面向Java毕业设计、课程设计及SSM初学者，完整呈现了大学生、心理咨询师、管理员三类角色的在线预约与健康知识管理场景。平台涵盖大学生管理、心理咨询师管理、站内新闻、心理测试、健康知识、心理咨询、心灵驿站等模块，后台采用Java与MySQL实现数据持久化，前台辅以Vue、JavaScript、HTML/CSS构建交互页面。压缩包共1620个文件，大小80.62MB，以js、svg、java、class、vue、css、html等为主，同时包含sql数据库脚本、xml/yml配置文件、maven相关文件及可执行bat脚本，便于直接导入IDE运行与二次开发。内容中还提供心理测试、健康知识专题、心灵驿站发帖等业务逻辑参考，可帮助深入理解SSM整合、用户权限控制、心理咨询预约流程及数据表设计等关键实现。当前已有290人学习下载，适合作为毕业设计选题参考、课程设计模板或SSM项目实战练手资源。

1. SSM大学生心理健康平台：这个毕设题背后到底在考察什么

每年毕业季，不少学生选题选了“基于SSM的大学生心理健康平台”，却不知道从哪下手。这个题目表面是一个项目，本质是考察你能不能跑通一套经典Java Web开发流程——SSM三个框架的组合、前后端交互、以及心理健康业务的数据建模。心理平台要处理的场景很清晰：学生做心理测评、看评估结果、预约咨询师，管理员维护咨询师信息、发布文章、看测评统计。难点不在某个功能多复杂，而在于整个链路：从数据库表设计到Controller路由，从MyBatis映射到权限拦截，任何一个环节断掉，项目就跑不起来。

适合谁做？计算机相关专业的学生在毕设或课计上选了这个题，或者想熟悉SSM框架实际用法的初级开发，都值得做——一周内就能摸清主流Java Web项目的基本骨架，之后切Spring Boot也不发憷。

2. 为什么选SSM框架组合：技术选型逻辑与项目骨架搭建

2.1 SSM框架的分工逻辑：Spring容器、SpringMVC路由与MyBatis持久层

首先要回答一个问题：心理平台这种项目，为什么要把SSM当成默认组合？因为SSM是Java Web开发中一套久经考验的“三件套”，SSM框架三个成员各管一段：Spring负责管理对象也就是Bean，解决业务对象之间的依赖关系；SpringMVC负责接收HTTP请求，把用户点击映射到对应的Controller方法；MyBatis负责和MySQL打交道，把数据库里的记录转换成Java对象。

常见做法是把业务分成三层：Controller层接收请求并返回页面或JSON，Service层写业务逻辑，Mapper层操作数据库。以“学生提交心理测评问卷”为例，请求先到Controller，Controller调Service，Service调Mapper，Mapper执行SQL把问卷内容写入测评记录表。这套分层逻辑不只在SSM里成立，在Spring Boot项目里也是一样——这也是为什么很多公司招聘时还愿意问SSM，因为它能反映出你对分层架构的基本理解。

和Spring Boot对比，SSM的配置过程更繁琐，但好处是每一步都看得见：数据源配置、事务管理、拦截器注册，全都在XML或注解里显式出现。这种“看得到配置”的特点，在教学和毕设答辩里很有价值，因为你能讲清楚每个配置的作用。下面列出了两者的核心差别。

这个表不是说Spring Boot不好，而是提醒你：在选型的时候别盲目追新，要看你手上的项目环境。如果是课程设计和毕业设计，用SSM反而更“耐问”，评委常问的IoC、AOP、动态代理都能在项目里找到落脚点。

2.2 用Maven搭建项目骨架：目录结构与pom.xml关键依赖

确定了SSM框架组合之后，第一步不是写Controller，而是把你的项目目录结构立起来。我用的是Maven标准目录：src/main/java放Java源码，src/main/resources放配置文件，src/main/webapp放JSP页面和静态资源。这个结构是约定，同时也决定了后面配置文件的扫描路径，一开始就摆正能省掉很多后期调整的麻烦。

常见做法是先在IDEA里创建Maven项目，然后手动补上web目录结构。下面是搭建好的项目根目录结构，你可以照着逐级创建：

ssm-psychology/ ├── pom.xml ├── src │ ├── main │ │ ├── java │ │ │ └── com/example/psy │ │ │ ├── controller │ │ │ ├── service │ │ │ ├── mapper │ │ │ ├── entity │ │ │ └── interceptor │ │ ├── resources │ │ │ ├── jdbc.properties │ │ │ ├── spring-mybatis.xml │ │ │ ├── spring-mvc.xml │ │ │ └── com/example/psy/mapper │ │ │ ├── StudentMapper.xml │ │ │ └── QuestionnaireMapper.xml │ │ └── webapp │ │ ├── WEB-INF │ │ │ ├── web.xml │ │ │ └── jsp │ │ └── static │ │ ├── css │ │ ├── js │ │ └── images

这个目录结构对应了SSM的最基本分层：controller放SpringMVC的处理器，service放业务逻辑，mapper放MyBatis接口与XML映射，entity放数据表对应的实体类。很多人栽在resources目录下的mapper子目录和java目录下的mapper包之间——它们都叫mapper，但前者放的是XML，后者放的是Java接口，两者必须保持同名同路径才能被MyBatis自动扫描绑定。

目录建好之后，pom.xml是项目的心脏。下面是本次SSM项目的最小依赖集合，包含了Spring全家桶、SpringMVC、MyBatis以及MySQL驱动和Druid连接池：

<dependencies> <!-- Spring核心 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>5.3.23</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>5.3.23</version> </dependency> <!-- MyBatis与Spring整合包 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.13</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>2.1.0</version> </dependency> <!-- MySQL驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.31</version> </dependency> <!-- 连接池 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.2.16</version> </dependency> <!-- 视图解析：JSTL --> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>4.0.1</version> <scope>provided</scope> </dependency> </dependencies>

这段pom.xml里有几个参数值得记一下：spring-webmvc和spring-jdbc的版本必须保持一致，否则容易出现NoSuchMethodError这类隐蔽的兼容性问题；mysql-connector-java建议用8.x，因为8.0之后驱动类名改成了com.mysql.cj.jdbc.Driver，用老的5.x驱动连接新版MySQL会直接报Failed to load driver；Druid的版本没有硬性要求，但1.2.x是当前维护线，建议跟着小版本走。

还有一点容易翻车：javax.servlet-api的scope是provided，意思是编译时需要、但部署时不打包，因为Tomcat自带了Servlet容器。如果你把它漏掉，本地跑的时候依赖缺失会报错；如果你把scope改成了compile，部署到Tomcat时会和容器自带的Servlet类冲突，出现java.lang.LinkageError。这个细节不致命，但每次遇到都会浪费半小时排查。

3. 心理健康平台的核心数据模型：表结构设计与MyBatis映射

3.1 5张核心表的设计思路：学生、咨询师、测评问卷、预约记录、测评结果

心理平台的数据模型决定了后续所有功能能否顺畅实现。我的经验是：不要一开始就设计一大堆表，先把业务主链路拆出来。这个系统里最核心的流程是“学生测评→生成结果→预约咨询师→记录咨询结果”，所以我们至少需要学生表、咨询师表、测评问卷表、测评结果表、预约记录表这五张表。

先看学生和咨询师两张基础的账号表，通常用角色字段来区分权限。下面是精简版的学生表建表SQL，省略了部分扩展字段以保持清晰：

CREATE TABLE `student` ( `id` INT PRIMARY KEY AUTO_INCREMENT COMMENT '学生ID', `student_no` VARCHAR(20) NOT NULL UNIQUE COMMENT '学号', `password` VARCHAR(64) NOT NULL COMMENT '登录密码(MD5加密)', `name` VARCHAR(32) NOT NULL COMMENT '姓名', `gender` TINYINT DEFAULT 0 COMMENT '0未知 1男 2女', `college` VARCHAR(64) DEFAULT NULL COMMENT '学院', `grade` VARCHAR(16) DEFAULT NULL COMMENT '年级', `phone` VARCHAR(11) DEFAULT NULL COMMENT '手机号', `status` TINYINT DEFAULT 1 COMMENT '账号状态 1正常 0冻结', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='学生表';

这条建表语句的细节都值得讲。password字段长度设为64是给MD5之后的32位密文和未来的SHA-256升级留余量；status字段设成TINYINT而不是VARCHAR，是因为程序里更方便写判断逻辑；create_time用DATETIME DEFAULT CURRENT_TIMESTAMP，让数据库自动维护创建时间，避免每个新增接口都写一遍当前时间。

测评问卷表需要支持选择题目的通用结构。常见做法是：question表存题目，option表存选项，answer表存学生答案，但这会让表数量膨胀。考虑到毕设场景，我建议用两张表：一张questionnaire表记录测评基本信息，一张question表记录题目内容、选项JSON和计分规则。下面是question表的简化结构：

CREATE TABLE `question` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `questionnaire_id` INT NOT NULL COMMENT '所属问卷ID', `content` VARCHAR(255) NOT NULL COMMENT '题目内容', `options` JSON NOT NULL COMMENT '选项，格式[{"label":"A","score":1}]', `score_type` TINYINT DEFAULT 1 COMMENT '1正向计分 2反向计分', `sort_order` INT DEFAULT 0 COMMENT '排序号', KEY `idx_questionnaire` (`questionnaire_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评题目表';

这里用JSON类型存选项是一种取舍：好处是写起来简单，一条记录就是一整道题；坏处是MyBatis取出来要手动转换成Java对象。常见的处理是写一个TypeHandler，或者在Mapper里直接查出来当字符串处理，然后在Service层用Fastjson解析。对于毕设项目，我倾向于后者，少一层配置就少一个坑。

预约记录表则需要考虑一个关键参数：预约状态。它必须能表达“已提交、已受理、已完成、已取消”这四种状态，否则学生在测评后预约了咨询师，管理员根本不知道下一步该做什么。

CREATE TABLE `appointment` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `student_id` INT NOT NULL COMMENT '学生ID', `counselor_id` INT NOT NULL COMMENT '咨询师ID', `appointment_date` DATE NOT NULL COMMENT '预约日期', `time_slot` VARCHAR(10) NOT NULL COMMENT '时段 如09:00-10:00', `reason` VARCHAR(255) DEFAULT NULL COMMENT '咨询缘由', `status` TINYINT DEFAULT 0 COMMENT '0已提交 1已受理 2已完成 3已取消', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP, KEY `idx_student_date` (`student_id`, `appointment_date`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='预约记录表';

status用数字而不是字符串，是为了索引效率和程序判断简单。要注意并发场景下的坑：如果两个学生同时预约同一个咨询师的同一个时间槽，程序层面没有做唯一约束，就会出现“座位超卖”。最稳妥的方案是在appointment表上建唯一索引，把counselor_id、appointment_date、time_slot三个字段联合起来设为UNIQUE KEY，这样数据库层面就能挡住重复预约。

3.2 MyBatis动态SQL场景：查询测评结果列表与状态统计

表结构确定后，进入MyBatis映射阶段。心理平台里最常见的查询是“按学生ID查他的历史测评结果和对应问卷名称”，这涉及两张表的联查。我一般在Mapper接口里定义方法，在XML里写联查SQL，而不是在实体类上叠加太多注解，因为XML更容易排查SQL问题。

先写Mapper接口：

package com.example.psy.mapper; import com.example.psy.entity.ResultVO; import org.apache.ibatis.annotations.Param; import java.util.List; public interface ResultMapper { // 查某学生的历史测评结果，包含问卷标题、总分、测评时间 List<ResultVO> selectResultsByStudent(@Param("studentId") Integer studentId); }

对应的XML文件里，用join把测评结果表和问卷表关联起来：

<mapper namespace="com.example.psy.mapper.ResultMapper"> <select id="selectResultsByStudent" resultType="com.example.psy.entity.ResultVO"> SELECT r.id AS resultId, q.title AS questionnaireTitle, r.total_score AS totalScore, r.level AS level, r.create_time AS createTime FROM assessment_result r INNER JOIN questionnaire q ON r.questionnaire_id = q.id WHERE r.student_id = #{studentId} ORDER BY r.create_time DESC </select> </mapper>

这里有个MyBatis中非常关键的参数绑定细节：方法参数上加了@Param("studentId")，XML里就用#{studentId}引用。如果方法只有一个参数，@Param可以省略；一旦方法里出现两个及以上参数，强烈建议每个都加上@Param，否则MyBatis只能用arg0、param1这样的别扭方式取值，代码可读性直线下降。

resultType使用的是ResultVO对象，它是一个专门给前端展示用的视图对象，字段名和SQL的别名一一对应。这比直接查实体类更干净，因为实体类里有password之类不该返回给前端的字段。写MyBatis的常见习惯是：查询多表只用返回少量字段时，不去改动实体类，而是新建一个VO类，保证各层职责清晰。

如果你的查询条件里需要支持“管理员按日期筛选测评记录”，这时SQL里就要用动态SQL标签了。MyBatis的if和where组合是动态查询的主力，这里的sortOrder字段是个易错点：

<select id="selectResultsByCondition" resultType="com.example.psy.entity.ResultVO"> SELECT r.id AS resultId, s.name AS studentName, q.title AS questionnaireTitle, r.total_score AS totalScore, r.create_time AS createTime FROM assessment_result r LEFT JOIN student s ON r.student_id = s.id LEFT JOIN questionnaire q ON r.questionnaire_id = q.id <where> <if test="studentName != null and studentName != ''"> AND s.name LIKE CONCAT('%', #{studentName}, '%') </if> <if test="level != null"> AND r.level = #{level} </if> <if test="startTime != null"> AND r.create_time &gt;= #{startTime} </if> <if test="endTime != null"> AND r.create_time &lt;= DATE_ADD(#{endTime}, INTERVAL 1 DAY) </if> </where> ORDER BY r.create_time DESC </select>

这份动态SQL里有三个值得记忆的参数处理习惯。第一，LIKE查询的模糊匹配需要显式拼CONCAT('%', #{studentName}, '%')，而不是直接写成'%#{studentName}%'，后者会被MyBatis当成字符串字面量，百分号里包着的是参数名本身，查出来永远是空结果。第二，时间范围查询里用DATE_ADD(#{endTime}, INTERVAL 1 DAY)，这是为了把结束日期往前延一天，保证用户选的当天记录也能被查出来——这个问题在MySQL里很隐蔽，日期类型和datetime类型比较时，如果你传入的是'2024-05-20'而库里存的是'2024-05-20 15:30:00'，直接用=是查不到的。第三，XML里的小于号必须写成<，因为XML解析器会把<识别成标签开始，直接写<会报org.xml.sax.SAXParseException。

4. 从登录到测评预约：用SpringMVC把业务串成完整闭环

4.1 Controller层设计：URL规划与参数绑定技巧

SSM项目的Controller不仅负责把请求转发给Service，还承担了URL规划和参数校验的职责。以心理健康平台为例，常见的URL风格是/res/student/list、/res/student/detail等，在页面和接口之间保持一致的命名规范。我会把Controller分成两类：一类是页面跳转Controller，返回JSP视图名；另一类是数据接口Controller，返回JSON，配合页面上的AJAX请求使用。

以“学生提交测评答案”为例，前端把问卷答案组装成JSON字符串，通过AJAX POST给后端。Controller接收参数时，常见做法是定义一个ReqVO来承接：

package com.example.psy.controller; import com.example.psy.service.AssessmentService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.*; import java.util.HashMap; import java.util.Map; @Controller @RequestMapping("/assessment") public class AssessmentController { @Autowired private AssessmentService assessmentService; // 浏览器访问测评页面，返回JSP视图 @GetMapping("/page") public String page() { return "assessment/index"; } // 接收前端提交的测评答案 @PostMapping("/submit") @ResponseBody public Map<String, Object> submit(@RequestBody AssessmentReqVO reqVO) { Map<String, Object> result = new HashMap<>(); if (reqVO.getAnswers() == null || reqVO.getAnswers().isEmpty()) { result.put("code", 400); result.put("msg", "测评答案不能为空"); return result; } int resultId = assessmentService.submitAssessment(reqVO); result.put("code", 200); result.put("msg", "提交成功"); result.put("data", resultId); return result; } }

这段代码里有几个SpringMVC绑定的关键点。@RequestBody注解要求前端请求头里带的Content-Type是application/json，如果你的前端用表单方式提交，这个注解会直接报HttpMediaTypeNotSupportedException，改成用@RequestParam接单个字段或者定义一个表单对象接收才行。@ResponseBody注解负责把返回的Map序列化成JSON字符串，少了它SpringMVC会尝试去找名为“result”的JSP视图，然后给你一个404。

返回结果里我统一用code、msg、data三个字段，这是前后端分离场景里最常见的约定。前端拿到响应后，先判断code是否等于200，再决定是跳转还是弹出提示。这种规范不需要额外引依赖，自己用Map组装就够了，代码量也不大。

页面跳转方法返回的是字符串类型，SpringMVC会交给视图解析器处理。在spring-mvc.xml中配置InternalResourceViewResolver时，前缀设为/WEB-INF/jsp/，后缀设为.jsp，这样return "assessment/index"实际指向的是/WEB-INF/jsp/assessment/index.jsp。把JSP放在WEB-INF目录下面是一个安全习惯，因为用户无法通过URL直接访问WEB-INF内的文件，所有页面都必须走Controller转发，这在心理平台这种含敏感数据的系统里更护得住隐私。

4.2 登录会话与权限拦截：拦截器配置里的两个必调参数

心理平台有三个角色：学生、咨询师、管理员。如果不做权限控制，任何登录用户都能看到别人的测评结果，这在心理健康场景里属于严重的数据泄漏。SSM框架里做权限控制最直接的手段就是SpringMVC拦截器，它能在请求进入Controller之前先判断当前用户是否登录、角色是否匹配。

下面是一个登录拦截器的核心实现：

package com.example.psy.interceptor; import org.springframework.web.servlet.HandlerInterceptor; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; public class LoginInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 从session中获取登录用户 Object user = request.getSession().getAttribute("loginUser"); // 如果未登录，重定向到登录页 if (user == null) { response.sendRedirect(request.getContextPath() + "/login"); return false; } // 已登录，放行请求 return true; } }

preHandle方法返回true则放行，返回false则拦截，同时可以在这个方法里做重定向。把loginUser存进session的动作发生在登录Controller中——User user = userService.login(username, password); request.getSession().setAttribute("loginUser", user); 这套逻辑是SSM的经典会话管理模式，比用Cookie存用户ID要安全得多，因为sessionId是HttpOnly的，脚本拿不到。

光有拦截器类还不行，必须注册到SpringMVC的配置里，否则拦截器就是一团死代码。下面是spring-mvc.xml里的拦截器注册片段：

<mvc:interceptors> <mvc:interceptor> <!-- 拦截所有请求 --> <mvc:mapping path="/**"/> <!-- 放行登录接口和静态资源 --> <mvc:exclude-mapping path="/login"/> <mvc:exclude-mapping path="/css/**"/> <mvc:exclude-mapping path="/js/**"/> <mvc:exclude-mapping path="/images/**"/> </mvc:interceptor> </mvc:interceptors>

这个配置里有几个容易踩坑的路径参数。path="/"表示拦截所有路径，而exclude-mapping的路径模式必须精确匹配实际访问路径，假如页面通过/static/css/style.css访问样式，但你写成/css/，静态资源照样会被拦截，页面就会彻底失去样式。另一个细节是exclude-mapping如果不放开/login这个路径，用户访问登录页时会被循环重定向——因为在登录页的请求也被拦截了。

如果你的项目同时存在多个角色，还需要在拦截器里判断角色。做法是session里再存一个role字段：request.getSession().setAttribute("role", user.getRole()); 然后在拦截器中检查当前路径前缀与角色是否匹配。比如所有/admin/**开头的请求要求role为1，所有/student/**开头的请求要求role为2。这种传统做法简单直接，逻辑都写在拦截器里，非常适合毕设答辩时展示你对权限控制的理解。更细的粒度控制比如每个按钮的权限，在三方框架Shiro或Spring Security里做得更好，但SSM项目里引入Shiro会让配置量翻倍，收益在你的场景里并不大。

5. SSM项目避坑指南：从部署到运行的5个高频翻车现场

5.1 现象一：页面中文乱码，所有姓名和测评内容变成问号

这个坑在SSM项目的开发期几乎必现。表现是浏览器里看到的全是“????”或“汉嗔，但数据库里存的是正常中文。原因有两个层面：一是MySQL连接串里没指定字符集，导致Java到数据库的连接用的是latin1；二是在SpringMVC的配置里缺了CharacterEncodingFilter，导致请求和响应没有走UTF-8。

解决办法分两步。第一步，在jdbc.properties里的连接串末尾加上characterEncoding=utf8和useSSL=false：

jdbc.url=jdbc:mysql://localhost:3306/psy?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai

第二步，在web.xml里加Spring自带的字符集过滤器，并且让它对全部路径生效：

<filter> <filter-name>encodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>encodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>

这两个配置缺一不可。连接串的serverTimezone参数在MySQL 8.x下必须写，否则连数据库时会报The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized，这个报错很多人第一眼都以为是自己数据库坏了，其实是驱动不认识系统时区。

5.2 现象二：Tomcat启动报ClassNotFoundException: org.springframework.web.servlet.DispatcherServlet

启动完Tomcat，控制台直接抛出ClassNotFoundException，提示找不到DispatcherServlet。原因基本可以锁定为：SpringMVC相关的jar包没有部署到Tomcat的运行时环境里，也就是说IDEA的Artifacts配置中，项目的依赖没有输出到WEB-INF/lib目录。

检查步骤是：打开IDEA的Project Structure -> Artifacts，看你的war exploded归档下有没有lib目录。如果只有output目录而没有lib，你需要手动点开“Available Elements”面板，把项目依赖的jar包全部拖进WEB-INF/lib。这里的底层原因是：Maven只负责把依赖下载到本地仓库，但IDEA打包时如果不显式把依赖放进web应用的lib，Tomcat就找不到这些类。

如果你不想每次都在IDEA里手动操作，可以在pom.xml里加maven-war-plugin的配置，让Maven自动把依赖打包进war文件。但这个方法只对最终打包阶段有效，本地Debug调试时还是需要IDEA的Artifacts配合，两处都要配置好。

5.3 现象三：MyBatis的Mapper接口与XML绑定失败

运行后第一次调用Dao层方法，报Invalid bound statement (not found)。这表示MyBatis没有找到和Mapper接口对应的XML文件。典型原因是XML文件放错了位置，或者没有做资源扫描。

在Maven项目里，Java接口在src/main/java/com/example/psy/mapper下，但XML文件也要放在src/main/resources/com/example/psy/mapper下，保持包结构完全一致，否则MyBatis扫描不到。如果你把XML直接丢在src/main/java里，Maven默认不会把非.java文件编译进target目录，你打开target/classes目录看一眼就明白了——那里根本没有XML文件。

解决办法是在spring-mybatis.xml里显式指定mapper位置：

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

同时别忘了在MyBatis的全局配置里把mapper接口的包名告诉它，这样接口和XML才能配对：

<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.example.psy.mapper"/> </bean>

检查顺序是：先看target/classes里有没有XML，再看spring-mybatis.xml的mapperLocations路径是否匹配，最后看XML的namespace是否写成了Mapper接口的全限定名。这个三角关系任何一环断了，都会出现同样的Invalid bound statement报错，所以排错要按这个顺序来。

5.4 现象四：登录后跳转正常，但刷新页面就退出登录

功能上能登录，但每次刷新页面都跳回登录页，session永远存不住用户。检查发现session确实set进去了，也没有超时，排除法查到最后是Cookie的context path问题。

Tomcat里应用默认的Cookie Path是应用的context path。如果你的应用部署在http://localhost:8080/ssm-psy/下，session的Cookie Path就应该是/ssm-psy/。但如果有人在web.xml里手动配置了session超时时间，或者你在IDE的Deployment里把Application context路径改了，而浏览器里旧的JSESSIONID还留在旧路径下，就会出现“登录成功但刷新即失效”的诡异状态。

解决方法是先把浏览器缓存Cookie清掉，再用无痕模式测试一遍。如果问题消失，说明是开发环境反复改动路径导致的旧Cookie残留。生产部署时，建议直接用ROOT路径部署，也就是把war包改名为ROOT.war，这样Cookie Path就是/，省去一堆路径不一致的麻烦。

5.5 现象五：数据库连接池把Tomcat拖到崩溃

系统多跑一会儿，Tomcat的日志里开始出现Connection is not available, request timed out，随后整个应用无响应。这是一个连接池耗尽的问题，典型的连环踩坑：代码里用了JDBC的Connection没有关闭，或者事务配置失效导致连接一直不被释放。

排查方式是先用MySQL客户端执行show processlist，看看当前连接数。如果发现sleep状态的连接大量堆积，问题通常出在Service层的方法没有交给Spring事务管理。在SSM里，事务是放在Service实现类上的：

@Service public class AssessmentServiceImpl implements AssessmentService { @Autowired private ResultMapper resultMapper; @Override @Transactional public int submitAssessment(AssessmentReqVO reqVO) { // 插入测评结果 resultMapper.insertResult(reqVO); // 更新学生状态 resultMapper.updateStudentStatus(reqVO.getStudentId()); return reqVO.getResultId(); } }

@Transactional注解默认只回滚RuntimeException，如果你在业务里抛的是异常是new Exception("xxx")，那么事务不会回滚，连接也不会正常释放，最终把连接池耗尽。所以组件内统一使用运行时异常，或者在注解上显式加rollbackFor = Exception.class。

补充一个Druid连接池的参数建议：initialSize设置5，maxActive设置20，minIdle设置5，maxWait设置60000。对毕设项目来说，20个并发连接足够支撑测评高峰期，设置过大会白白消耗MySQL的资源。

6. 部署验证的最后一公里：本地打War包与服务器部署的实用技巧

6.1 用Maven打包并检查包体完整性

项目开发完毕，下一步是打成War包部署到服务器。在项目根目录执行：

mvn clean package

打包完成后，打开target目录看看生成的war文件名是否为项目名，比如ssm-psy.war。我一般会用unzip -l命令检查包里的lib目录是否存在，以及spring-mvc.xml等配置是否打进去。如果发现lib目录是空的，多半是pom.xml的打包配置没生效，回到IDEA的Artifacts设置补上依赖。

然后把这个war包丢到Tomcat的webapps目录下，启动Tomcat后它会自动解压部署。部署的路径默认为war包文件名，例如http://localhost:8080/ssm-psy/。如果你想直接通过根路径访问，可以把war改名为ROOT.war再放进去，这样URL里的项目名就消失了，登录跳转时也能少一层路径拼接的烦恼。

6.2 线上部署后的验证清单

部署到服务器后，打开浏览器按这个清单过一遍：学生端能否正常登录并提交测评，右侧的测评历史能否正确显示结果；预约咨询师时，同一天同一时段重复提交是否被数据库挡下；管理员端能否看到测评统计和预约状态。我习惯在本地和线上各跑一遍相同的测评流程，然后对比数据库里的记录数，确认线上没有任何格式或路径的偏差。这个习惯已经帮我拦住过好几次“本地能用线上却报错”的翻车。

还有一个验证点是日志：打开Tomcat的logs/catalina.out看有没有ClassNotFoundException或SQLSyntaxErrorException，尤其是首次部署时最容易出现Linux下数据源连接失败的问题——检查jdbc.properties里的localhost是否要改成服务器的内网IP。如果线上时间不对，记得在启动参数里加-Duser.timezone=Asia/Shanghai，否则预约记录里的时间戳会差8个小时。

建议你自己加一个小的观察点：把每个请求的耗时打到日志里，当学生反馈“测评提交后转圈很久”时，能快速定位是数据库查询慢还是网络慢，而不是毫无头绪地猜。这个习惯对我帮助很大。

希望帮到你。

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