SSM学生信息管理系统源码拆解：从配置到原理的Java Web指南-平芜编程栈

简介：Java Web开发中，SSM（Spring+SpringMVC+MyBatis）作为经典技术栈，深刻影响着后端工程师对框架协作与底层机制的理解。其核心原理在于Spring管理业务对象，SpringMVC处理请求分发，MyBatis负责SQL映射，三者通过配置文件协同工作。掌握这套组合，不仅能厘清Spring容器与SpringMVC子容器的关系，还能深入理解动态SQL、事务管理等关键实践。在实际应用中，SSM常被用于构建学生信息管理系统等典型业务场景，涵盖登录认证、权限拦截、联表查询与分页展示。从数据库设计到Mapper层实现，完整梳理这套系统，有助于开发者摆脱纯CRUD的局限，进而更轻松地掌握Spring Boot的自动配置思想。吃透这个经典案例，Java Web后端原理便不再神秘。老实说，看到这个标题我脑子里冒出来的第一句话是：SSM三件套的学生信息管理系统，Java后端圈子里流传最广的“毕业设计级别”项目。但你别因为它听着“老”就小看它，Spring + SpringMVC + MyBatis这套组合，到今天依然是理解Java Web后端原理的最佳入口。很多同学手里有这份源码，却不知道从哪看起；更多人想自己完整写一套，又卡在配置文件互相协作和框架整合的细节上。这篇笔记就把这套系统从数据库设计到Controller层完整拆一遍，把每个关键的“为什么”都讲清楚，适合正在学SSM整合的人、准备Java实习面试的人，以及想把手头这份源码真正吃透而不是只跑通的人。

1. 这个SSM学生信息管理系统，到底在解决什么问题

1.1 为什么这类项目永远是Java面试的高频题

先说一个很现实的现象：你去翻Java后端岗位的面试题，“SpringMVC工作流程”“MyBatis中#和$的区别”“Spring三级缓存原理”常年霸榜。面试官为什么爱问这些？因为SSM这套东西，恰好覆盖了一个Java Web项目从请求进入、参数绑定、业务处理、数据库访问到响应返回的完整链路。

学生信息管理系统就是这条链路的完美载体。它不是一个只做增删改查的工具，而是一个包含登录认证、权限拦截、联表查询、分页展示、数据统计的真实业务系统。面试官问“你有没有做过完整项目”，如果你只答“用Spring Boot + MyBatis-Plus生成器敲了套CRUD”，那等于没做；但如果你能说清楚“我用Spring管理Service层的Bean，用SpringMVC处理请求转发和参数校验，用MyBatis手写了动态SQL做条件分页查询”，这就完全不一样了。

所以这套源码的真正价值，不是那几百个Java文件，而是它提供了一个“用最小成本理解大型Java Web项目运行机制”的样本。你把这份源码的每一层都弄懂了，再去看Spring Boot，会感觉像看简化版的洋娃娃，一眼就能看穿它的自动配置在干什么。

1.2 选型逻辑：这个场景为什么用SSM而不是Spring Boot

可能有人会问：现在新项目谁还用Spring + SpringMVC + MyBatis手写配置？Spring Boot不香吗？这话没错，但注意这套系统的定位是教学和原理学习。

Spring Boot的本质是“约定优于配置”，它把SSM整合时那些繁琐的XML配置全部自动化了。好处是开发效率高，坏处是你根本不知道底层发生了什么。我见过太多用Spring Boot写得很溜的人，问他“DispatcherServlet在哪配置的”，他一脸茫然。而在SSM项目里，web.xml中的DispatcherServlet声明、ContextLoaderListener的加载顺序、applicationContext.xml和springmvc.xml两个容器的关系，全都摆在明面上。你亲手配一遍，才会真正理解SpringMVC的工作原理，之后学Spring Boot才会事半功倍。

另外，这个学生信息管理系统如果用Spring Boot写，可能几十行代码就完事了，但也就失去了“拆解”的价值。SSM版本的代码量虽然大，但每一段配置都有它存在的理由，每一个包结构都有清晰的职责边界。这就是为什么我在带人的时候，宁可让大家先从SSM手写一遍，而不是直接上Spring Boot。工具可以迭代，但底层原理不会过时。

2. 系统功能与数据库设计拆解

2.1 功能模块划分：麻雀虽小五脏俱全

这套学生信息管理系统虽然叫“学生信息管理”，但它的功能边界比字面意思要宽不少。拿到源码之后，我建议你先不要急着看代码，而是先梳理功能模块。通常一个完整的学生信息管理系统至少包含以下模块：

用户登录与权限控制：管理员、教师、学生三类角色，登录后根据角色跳转到不同页面，未登录用户不能访问内部页面。
学生信息管理：学生基本信息的增删改查，支持按姓名、班级、学号等条件模糊查询和分页展示。
班级管理：维护班级信息和年级信息，学生表通过班级ID关联班级表。
课程管理：课程的增删改查，一门课程会绑定一个授课教师，包含课程名称、学分等字段。
成绩管理：录入学生各科成绩，支持按学生或课程维度查询，能计算总分、平均分等统计信息。
个人信息维护：普通用户登录后可以查看或修改自己的基础信息，比如联系方式、密码等。

每个模块看起来简单，但它们之间的数据关系是真实的业务关系。比如你要删一个班级，那班级下的学生怎么处理？是禁止删除还是级联删除？这些逻辑都是面试官喜欢追问的点，也是这套源码值得仔细品的地方。从源码的Controller层你就能看出作者对模块边界的设计思路，哪些功能收敛在一个Service里、哪些功能跨Service协作，这些都是可以复盘的内容。

2.2 数据库表设计：五张核心表怎么关联

数据库设计是整个系统最容易被新手忽略、但实际最重要的部分。学生信息管理系统虽然业务量不大，但表结构设计是标准的“学生-课程”多对多模型变体。核心表我拆成下面这些：

表名	核心字段	说明
t_user	user_id, username, password, role	登录用户表，角色区分管理员/教师/学生
t_student	student_id, student_no, name, gender, birthday, phone, email, clazz_id	学生信息表，通过clazz_id关联班级
t_clazz	clazz_id, clazz_name, grade	班级表，存班级名称和所属年级
t_course	course_id, course_name, credit	课程表，学分用于成绩统计
t_score	score_id, student_id, course_id, score, exam_date	成绩表，学生和课程的多对多关联表

这张表设计最核心的就是t_score这个中间表。学生表和学生表之间不直接关联，而是通过t_score表形成“学生-课程”的多对多关系。每一条成绩记录都指向一个学生和一门课程，这样就能实现“查某个学生的所有成绩”“查某门课的所有学生”这种典型需求。

在SQL层面，典型联查就是三表关联：t_score join t_student join t_course。如果你在源码里看到按学生姓名查成绩的SQL，本质就是用student_name字段去过滤t_student表，再关联出t_course的课程名称。这个模型吃透了，以后遇到订单-商品-用户、文章-标签-分类这种多对多场景，你都会秒懂。

字段的类型设计也有讲究。日期字段在MyBatis中建议用java.util.Date映射，数据库侧用datetime而不是varchar，否则排序和范围查询都会被字符串比较坑到。性别这种字段用char(1)或者tinyint都行，但tinyint更省空间，也更符合日常开发习惯。学号这种业务唯一字段，建议建唯一索引，并且用varchar而不是int，因为学号可能有前导零，存成int就丢了。

2.3 项目分层结构：Controller-Service-Mapper三层怎么拆

打开源码的包结构，你会发现它严格遵循经典的MVC三层设计。我见过的SSM项目结构可以总结成一个黄金模板，这套源码基本上也是按这个模板来的：

com.example.student ├── controller // 接收请求，参数校验，调用Service ├── service // 业务逻辑层，处理事务边界 │ └── impl // Service接口实现类 ├── mapper // MyBatis Mapper接口层 ├── entity // 实体类，对应数据库表 ├── interceptor // 拦截器，如登录拦截 ├── common // 公共类：响应结果封装、分页对象等 └── config // 可选：Java配置类

Controller层只做三件事：接收前端参数、调用Service、把结果封装后交给视图渲染。绝对不要在这一层写业务逻辑，比如“查成绩之前先判断角色权限”这种代码，放在Service层里才是对的。

Service层是业务逻辑的集中地，事务边界也在这里划。比如录入成绩时要同时更新学生平均分，这两步必须在一个事务里，那就把这两个操作放到同一个Service方法里，加上@Transactional注解。这个注解是Spring管理的核心价值之一，用的好不好直接反映你对事务的理解。

Mapper层就纯粹是数据库访问接口，一个接口方法对应一条SQL。MyBatis的Mapper接口之所以能直接注入到Service里，靠的是mybatis-spring包中的MapperScannerConfigurer做动态代理。你不需要写实现类，MyBatis会为接口自动生成代理对象，这也是SSM整合让人最爽的地方之一。

3. 核心配置与代码实现详解

3.1 环境准备与技术版本选择

如果你打算本地把这套源码跑起来，我建议先统一环境版本，能省掉一半的报错时间。这套项目要求不高，JDK 1.8以上、Maven 3.6以上、Tomcat 8.5或9.0、MySQL 5.7或8.0都可以。

有一个细节要重点提醒：MySQL 8.x和5.x的JDBC驱动类名不一样，MySQL 5.x用com.mysql.jdbc.Driver，MySQL 8.x用com.mysql.cj.jdbc.Driver。MySQL 8.x还必须加上时区参数serverTimezone=Asia/Shanghai，否则连接池初始化就会报时区错误。这是新手最常见的第一个拦路虎。

数据库脚本一般会在源码里以student.sql这类文件给出，你只需要在MySQL里source一下，或者用Navicat运行SQL文件。导入之后注意检查一下数据库名是否和jdbc.properties里的配置一致，不一致的话改配置文件即可。创建Maven项目时，依赖坐标建议统一使用Spring 5.x版本，不要用Spring 4.x，因为5.x对Java 8支持更好，而且不需要额外引入javax.annotation依赖。

3.2 web.xml的双容器机制

在SSM整合中，web.xml是整个应用的启动入口。这一步值得花最多时间理解，因为它决定了Spring和SpringMVC两个容器是怎么配合的。

<web-app> <!-- 1. Spring根容器配置 --> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:applicationContext.xml</param-value> </context-param> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <!-- 2. SpringMVC前端控制器 --> <servlet> <servlet-name>dispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:springmvc.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>dispatcherServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> <!-- 3. 字符编码过滤器 --> <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> <init-param> <param-name>forceEncoding</param-name> <param-value>true</param-value> </init-param> </filter> <filter-mapping> <filter-name>encodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> </web-app>

这里面的核心机制是双容器：ContextLoaderListener加载applicationContext.xml，创建Spring根容器，负责管理Service、Mapper、数据源等业务组件；DispatcherServlet加载springmvc.xml，创建SpringMVC子容器，负责管理Controller、视图解析器、拦截器等Web组件。

SpringMVC子容器可以访问父容器中的Bean，但父容器不能访问子容器的Bean。所以Controller可以注入Service，但Service不应该注入Controller。这也是为什么在applicationContext.xml中扫描包时要过滤掉@Controller，而在springmvc.xml中要只扫描@Controller的原因。如果你不加过滤，两个容器重复扫描同一个包，会看到service被创建两次，甚至出现AOP代理失效的诡异问题。

3.3 Spring根容器配置：applicationContext.xml

这个配置文件管的是整个项目的“地基”。数据源、事务、Mapper扫描、Service层组件全在这里声明。核心配置片段长这样：

<context:component-scan base-package="com.example.student"> <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/> </context:component-scan> <context:property-placeholder location="classpath:jdbc.properties"/> <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"> <property name="driverClassName" value="${jdbc.driver}"/> <property name="url" value="${jdbc.url}"/> <property name="username" value="${jdbc.username}"/> <property name="password" value="${jdbc.password}"/> </bean> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource"/> <property name="mapperLocations" value="classpath:mapper/*.xml"/> </bean> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.example.student.mapper"/> </bean> <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <property name="dataSource" ref="dataSource"/> </bean> <tx:annotation-driven transaction-manager="transactionManager"/>

component-scan里的排除配置是精髓。Spring容器只管理Service、Mapper等组件，不管理Controller。然后通过batis的SqlSessionFactoryBean把数据源和Mapper XML关联起来，注意mapperLocations配置的值通常是classpath:mapper/*.xml，意思是扫描resources目录下mapper文件夹里的所有XML映射文件。

数据源我建议直接使用Druid。它有监控页面、连接池管理、防SQL注入等功能。如果你看到的源码里用的是dbcp或c3p0，也可以直接换掉，性能差别不大，但Druid的监控功能排错时很好用。事务管理器是DataSourceTransactionManager，配合@Transactional注解使用，注意tx:annotation-driven这一行一定要配，否则@Service里的@Transactional不会生效。

3.4 SpringMVC容器配置：springmvc.xml

SpringMVC的配置相对简洁，但同样有两个坑要注意。第一个是默认的“扫描所有注解”会把@Controller以外的组件也扫进来，导致容器职责混乱；第二个是静态资源会被DispatcherServlet拦截，需要单独放行。

<context:component-scan base-package="com.example.student" use-default-filters="false"> <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/> </context:component-scan> <mvc:annotation-driven/> <mvc:default-servlet-handler/> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/views/"/> <property name="suffix" value=".jsp"/> </bean> <mvc:interceptors> <mvc:interceptor> <mvc:mapping path="/**"/> <mvc:exclude-mapping path="/login"/> <mvc:exclude-mapping path="/logout"/> <mvc:exclude-mapping path="/static/**"/> <bean class="com.example.student.interceptor.LoginInterceptor"/> </mvc:interceptor> </mvc:interceptors>

mvc:annotation-driven启用了SpringMVC的注解驱动，包括参数解析、JSON转换、类型转换等一堆默认功能。如果你忘了写这一行，@RequestBody、@ResponseBody都会失效。default-servlet-handler是放行静态资源的，否则你的CSS、JS、图片全会被DispatcherServlet拦走，样式全崩。

视图解析器配置很简单，prefix + Controller返回的字符串 + suffix就构成了最终的JSP路径。比如Controller返回student/list，实际渲染的是/WEB-INF/views/student/list.jsp。放在WEB-INF下有个好处：用户不能直接通过URL访问JSP页面，必须经过Controller，在安全性上是一个天然屏障。

拦截器配置是重点。这个LoginInterceptor的作用是：没有登录的用户访问任何内部页面，统一重定向到登录页。mvc:exclude-mapping指定了哪些路径不拦截，这里放行了登录页、退出登录和静态资源。如果你在源码里看到拦截器没生效，先检查是不是忘了写mvc:mapping path="/**"。

3.5 MyBatis映射文件与动态SQL

MyBatis是这套系统的数据访问层，也是最值得手写代码的地方。在学生信息管理系统中，最典型的需求就是条件查询加分页，这时候动态SQL就派上用场了。StudentMapper.xml里通常会有这么一段：

<select id="selectByCondition" resultType="com.example.student.entity.Student"> SELECT * FROM t_student <where> <if test="studentName != null and studentName != ''"> AND name LIKE CONCAT('%', #{studentName}, '%') </if> <if test="clazzId != null"> AND clazz_id = #{clazzId} </if> </where> ORDER BY student_id LIMIT #{offset}, #{pageSize} </select>

where标签会智能去掉第一个多余的AND，这是MyBatis的经典技巧。if标签让我们可以根据条件动态拼接SQL，实现“姓名模糊查询 + 班级精确过滤”的联合查询。这一段的面试价值极高，一定要能默写出来。LIMIT #{offset}, #{pageSize}是分页的核心，offset = (pageNum - 1) * pageSize，pageNum从1开始。

关于MyBatis的#和$的区别，所有面试官都会问，这里必须展开讲。使用#{name}时，MyBatis会把参数预编译成?占位符，然后通过PreparedStatement设置参数，这样用户输入再特殊也不会拼接进SQL，能从根上防SQL注入。而使用${name}是简单的字符串替换，直接把参数值拼接到SQL语句中，如果参数是用户输入的，就有被SQL注入的风险。所以在DML语句的where条件、values值这些位置，永远用#。那$有没有用？当然有，当你要动态指定表名、列名、排序字段时，因为表名、列名不能预编译占位，只能字符串拼接，这时候才用$，而且必须做白名单校验。一句话总结：#安全但只能传值，$灵活但只能用在结构位置。

4. 核心业务场景落地与经验

4.1 登录认证与SpringMVC拦截器实践

登录功能看起来简单，但是整套系统安全性的第一道关卡。Controller层接收用户名密码，调用Service层的userService.login(username, password)方法，查询数据库比对密码。比对通过之后，把用户对象放进session，然后在后续的请求中通过拦截器检查session里有没有这个用户。

LoginInterceptor是最典型的SpringMVC拦截器实现，核心代码如下：

public class LoginInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session = request.getSession(); Object loginUser = session.getAttribute("loginUser"); if (loginUser != null) { return true; } // 未登录，重定向到登录页 String contextPath = request.getContextPath(); response.sendRedirect(contextPath + "/login"); return false; } @Override public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception { // 视图渲染前的处理，比如给所有页面注入公共数据 } }

这个preHandle方法在Controller方法执行之前调用，如果返回false，请求直接中断，不会进入Controller。利用这个机制，我们实现了“未登录不能访问任何内部页面”的强制约束。这个地方要注意一个细节：重定向时要加上request.getContextPath()前缀，否则如果你的应用部署在非根路径下，跳转地址会404。我第一次写的时候就没加这个前缀，本地Tomcat根路径一切正常，部署到服务器二级路径后登录失效，排查了很久才发现是这个原因。

用户密码的存储在这个学生管理系统里一般用的是MD5或SHA-256加密。如果你在源码里看到的是明文存储，建议改成加盐后哈希。虽然学生管理系统不是高安全场景，但养成不存明文密码的习惯，对以后进企业做真实项目非常重要。可以引入Shiro或Spring Security来管权限，但先用拦截器把登录状态管好，理解原理更有价值。

4.2 条件分页查询：学生列表页的完整链条

学生列表是这个系统使用频率最高的页面。前端传页码、每页条数、查询条件，后端返回当前页数据和总记录数。这一条链路值得你完整刷一遍，因为它是所有管理系统的通用范式。

Service层通常会这样写：

public PageResult<Student> findPage(StudentQuery query) { int offset = (query.getPageNum() - 1) * query.getPageSize(); query.setOffset(offset); List<Student> list = studentMapper.selectByCondition(query); long total = studentMapper.countByCondition(query); return new PageResult<>(list, total); }

这里有两个SQL，一个查列表，一个查总数，二者组合才能实现分页。注意count查询和列表查询的查询条件必须保持一致，否则总数对不上。为了避免两套where条件重复写，可以把查询条件封装成一个Query对象，分别传给两个语句的parameterType。

如果你没手写LIMIT，而是用PageHelper插件，原理也一样，拦截器会自动把查询SQL包装成带COUNT的SQL，再生成LIMIT语句。手写SQL的好处是能看清分页本质，理解PageHelper到底做了什么。用PageHelper时有一点要留心：它基于ThreadLocal实现，query调用的第一条SQL会被分页拦截，如果前面还有别的SQL，也会被误分页。所以分页调用要紧接着Mapper查询，中间不要插入其他数据库操作。

关于分页时前端展示“共X条，当前第X页”这种交互，Controller里把PageResult对象放到Model里，JSP通过JSTL标签或者Vue来渲染都可以。老SSM项目里用JSTL较多，格式大概是forEach遍历items="${page.list}"，再通过${page.total}取总数。源码的这一段对刚接触MVC的人非常友好，能看明白后端数据是怎么一步步变成前端页面的。

4.3 成绩统计中的SQL实践：联查与聚合函数

成绩管理模块是这套系统里SQL含量最高的地方。典型需求包括：查询某个学生的全部成绩、查询某门课程所有学生的成绩、计算某门课程的平均分和最高分。这些操作都需要多表关联和聚合函数。

查询一个学生的成绩列表，SQL可以这样写：

SELECT s.student_no, s.name AS student_name, c.course_name, sc.score, sc.exam_date FROM t_score sc LEFT JOIN t_student s ON sc.student_id = s.student_id LEFT JOIN t_course c ON sc.course_id = c.course_id WHERE s.student_id = #{studentId} ORDER BY sc.exam_date DESC

注意这里用了LEFT JOIN而不是INNER JOIN，目的是保证即使某条成绩记录的学生信息缺失，也能保留成绩记录本身，便于排查数据问题。实际开发中联查优先用LEFT JOIN，除非你明确知道关联记录必然存在。

计算课程平均分就是用AVG函数配合GROUP BY：

SELECT c.course_name, COUNT(sc.score_id) AS student_count, AVG(sc.score) AS avg_score FROM t_score sc LEFT JOIN t_course c ON sc.course_id = c.course_id GROUP BY c.course_id

这个统计结果在系统中通常以图表形式展示，比如柱状图对比不同课程的平均分。如果你在源码里看到返回给前端的是一个List<Map<String, Object>>，那也是很常见的做法，因为统计结果不一定能对应到某个实体类，用Map更灵活。此时在Mapper.xml里，resultType直接写map即可，MyBatis会自动把列名转为Map的key。这一招在写报表类需求时很实用。

5. 我踩过的坑：常见问题排查实录

5.1 新手最容易翻车的异常对照速查表

我把这几年带人跑SSM项目时遇到的高频问题整理成一张表，每一项都是真实案例。这张表建议收藏，遇到问题时先对照一遍，能省下大量排查时间。

现象	根本原因	处理办法
Tomcat启动报ClassNotFoundException: ContextLoaderListener	缺少spring-web、spring-webmvc依赖，或依赖没有打到WEB-INF/lib	检查pom.xml，确认Spring相关依赖scope不为provided，执行mvn clean package后看war包内是否有jar
启动时NoSuchBeanDefinitionException: sqlSessionFactory	SqlSessionFactoryBean没有被实例化	检查applicationContext.xml是否被ContextLoaderListener正确加载，classpath路径是否正确
Invalid bound statement (not found)	Mapper接口和方法在XML中没有对应	Mapper接口名与XML的namespace完全一致；XML文件名和Mapper接口名一致且放在同包路径下
Servlet.service()抛NullPointerException，Service中的Mapper为null	Mapper接口没有被扫描到	检查MapperScannerConfigurer的basePackage是否指向了Mapper接口所在包
访问页面时JS/CSS全部404	DispatcherServlet把静态资源拦截了	配置mvc:default-servlet-handler，或用resource映射静态资源路径
中文乱码，往数据库写入后和前端显示不一致	缺少字符编码过滤器，或数据库连接URL没有指定UTF-8	配置CharacterEncodingFilter；jdbc.url中追加useUnicode=true&characterEncoding=UTF-8
密码框登录成功但跳转后又是登录页	session中没有保存登录用户，或拦截器路径配置错误	检查登录成功后是否session.setAttribute("loginUser", user)；检查拦截器exclude-mapping是否放行了登录页
MySQL报Public Key Retrieval is not allowed	MySQL 8加密插件导致连接串缺少参数	jdbc.url加allowPublicKeyRetrieval=true&useSSL=false
项目部署到服务器后404，但本地正常	context-path导致重定向或资源路径写死	所有跳转用request.getContextPath()拼接，或前端用相对路径

这张表里最容易埋人的是Invalid bound statement这个错。它的出现通常是你把StudentMapper.xml放在了src/main/java的接口包下，而Maven打包时默认不编译XML文件，导致target目录里根本没有这个XML。正确的做法是把XML放在src/main/resources/mapper目录下，或者在pom.xml里显式配置资源目录。我在公司带实习生时，这个坑十个人里至少有六个人踩过。

5.2 数据库连接与事务的隐性坑

事务问题是最难排查的一种，因为代码看起来完全没问题，但数据就是不回滚。最常见的症状是：Service方法有@Transactional，方法里第一步insert成功，第二步update抛异常，回滚后数据库里insert的数据还在。

这种情况十有八九是事务没有生效。可能的根源包括：数据源没有配置transactionManager，或者tx:annotation-driven没有配置，导致注解被无视；还有一种情况是ServiceImpl类本身没有被Spring扫描，而是被New出来，那自然没有代理；还有一种是方法内部通过this调用另一个方法，事务不会触发生效，因为代理对象只拦截外部调用。解决办法是外部注入自身的代理对象，或者把需要事务的方法放到另一个Service类里。

另外，Druid连接池的maxActive、initialSize这些参数建议按实际并发量调整。学生管理系统并发量很小，初始5、最大20足够。如果你是本地学习，把maxWait设置成60000毫秒，避免连接池饿死的时候报错报得太突然。注意在排查数据库问题时，先看一下Druid的监控页面能省很多事，默认地址是项目路径/druid/index.html。

5.3 部署到Tomcat的操作细节

最后说说怎么把项目部署到Tomcat。开发时可以直接在IDEA里配置Tomcat Server，用war exploded模式热部署。但如果你要把源码交付给别人，或者放到服务器上跑，建议打war包部署。

在pom.xml中确认packaging是war，然后在IDEA中执行mvn clean package。构建完成后，把target目录下的student.war复制到Tomcat的webapps目录下，启动Tomcat后它会自动解压。启动日志显示Deployment of web application archive has finished后就能访问了。如果服务器上用的是Nginx，需要把静态资源的请求直接代理到Tomcat，动态请求也要加上正确的context-path。

有一个非常容易被忽略的问题：MySQL驱动版本和MySQL服务端版本不匹配。比如MySQL 8.0的服务器，用5.1.x的驱动，虽然有时候能连上，但一遇到新加密插件就会报错。我的建议是直接用mysql-connector-java 8.0版本，官方支持向后兼容MySQL 5.7和8.0。同时openjdk版本和Tomcat版本也要匹配，Tomcat 9搭配JDK 8或11都很稳妥。

我在实际部署中还遇到过一个问题：本地Windows下跑得好好的，放到Linux服务器上就报时区错误。根本原因是MySQL连接的serverTimezone参数没有指定，Windows和Linux的默认时区不一样。解决方案就是前面说的，在JDBC URL上显式指定serverTimezone=Asia/Shanghai。

结尾：一点个人的体会

如果你把这份源码从头到尾自己照着敲一遍，而不是光看，你会发现SSM这套东西其实不难，但它逼着你把每一层之间的契约都搞清楚：Spring管理对象、SpringMVC接请求、MyBatis管SQL，三个框架各自有清晰的分工，老老实实通过配置文件和接口协议协作，不藏着掖着。这也是我为什么始终觉得，SSM是进阶Spring Boot之前绕不开的一课。你可以从这个项目开始，先把它跑通，然后把数据库表扩展一两张、加一个新模块，比如“选课”“宿舍管理”，改动过程中遇到什么问题就去查配置和源码。这样一个项目做完，你对Java Web后端开发的感觉会完全不一样。

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