基于SSM的毕业设计项目：新手入门实战与避坑指南-编程阁

基于SSM的毕业设计项目：新手入门实战与避坑指南

一、为什么SSM总让毕设翻车

第一次做毕设，选SSM 就像同时开三个新手副本：Spring 管 Bean、Spring MVC 管路由、MyBatis 管 SQL，任何一环掉链子，项目就跑不起来。根据系里连续三届的“翻车统计”，高频痛点集中在下面三类：

依赖冲突：spring-core、spring-webmvc、mybatis-spring 版本不一致，启动直接报NoSuchMethodError，IDEA 里一片红。
XML 配置冗余：把数据源、事务、扫描包全写在同一个applicationContext.xml，文件行数 800+，改一行错一片。
事务失效：Service 层方法命名不符合tx:advice切点规则，数据库写入成功但回滚失败，老师一提问就露馅。

如果你也被上述问题支配过，下面的“从零搭模板”可以救命。

二、SSM 还是 Spring Boot？先想清楚再动手

很多教程直接推 Spring Boot，但毕设场景里 SSM 仍有不可替代的优势：

学校老旧服务器只装了 JDK8+Tomcat8，Boot 需要额外解释“内嵌容器”概念，答辩时容易踩坑。
系里模板检查清单明确要求“XML 配置可见、分层目录清晰”，Boot 的自动配置对评审老师相当于黑盒。
企业里遗留系统 60% 还是 SSM，毕设先吃透 XML 配置，实习接手老项目不心慌。

一句话：想快速通过教学检查、同时给简历留点“老项目维护经验”，SSM 仍是性价比最高的选择；若追求“一键启动”且服务器能自主掌控，再换 Boot 也不迟。

三、30 分钟搭出可运行骨架

下面演示一套“目录先定型、配置再细分、代码级注释”的最小可用结构，跟着做基本能一次跑通。

1. 工程目录规划

ssm-demo ├ src/main/java │ ├ cn.edu.ssm.controller │ ├ cn.edu.ssm.service (impl 子包) │ ├ cn.edu.ssm.mapper │ ├ cn.edu.ssm.entity │ └ cn.edu.ssm.common ├ src/main/resources │ ├ spring-dao.xml │ ├ spring-service.xml │ ├ spring-mvc.xml │ ├ mybatis-config.xml │ └ mapper/*.xml └ webapp/WEB-INF ├ web.xml ├ views/ └ static/

2. 核心配置拆解

(1) web.xml —— 只干三件事：读 Spring、扔给 SpringMVC、放 Druid 监控

<!-- 1. 启动 Spring 容器 --> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring-*.xml</param-value> </context-param> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <!-- 2. 配置 DispatcherServlet --> <servlet> <servlet-name>spring-mvc</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring-mvc.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>spring-mvc</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> <!-- 3. Druid 监控 --> <servlet> <servlet-name>DruidStatView</servlet-name> <servlet-class>com.alibaba.druid.support.http.StatViewServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>DruidStatView</servlet-name> <url-pattern>/druid/*</url-pattern> </servlet-mapping>

(2) spring-dao.xml —— 数据源 + SqlSessionFactory + Mapper 扫描

<!-- 数据库连接池 --> <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close"> <property name="url" value="jdbc:mysql://127.0.0.1:3306/ssm_demo"/> <property name="username" value="root"/> <property name="password" value="123456"/> <property name="initialSize" value="5"/> <property name="maxActive" value="20"/> </bean> <!-- 会话工厂 --> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource"/> <property name="configLocation" value="classpath:mybatis-config.xml"/> <property name="mapperLocations" value="classpath:mapper/*.xml"/> </bean> <!-- 自动扫描 Mapper 接口 --> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="cn.edu.ssm.mapper"/> </bean>

(3) spring-service.xml —— 事务、Service 扫描

<!-- 开启事务注解 --> <tx:annotation-driven transaction-manager="txManager"/> <!-- 事务管理器 --> <bean id="txManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <property name="dataSource" ref="dataSource"/> </bean> <!-- 扫描 Service --> <context:component-scan base-package="cn.edu.ssm.service"/>

(4) spring-mvc.xml —— 静态资源、视图解析、JSON 转换

<mvc:annotation-driven> <mvc:message-converters> <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/> </mvc:message-converters> </mvc:annotation-driven> <mvc:resources mapping="/static/**" location="/static/"/> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/views/"/> <property name="suffix" value=".jsp"/> </bean>

3. 分层代码示例（以“学生增删改查”为例）

(1) entity

public class Student { private Integer id; private String name; private Integer age; // getter/setter 省略 }

(2) mapper 接口 + XML

public interface StudentMapper { int insert(Student s); Student selectByPrimaryKey(Integer id); List<Student> listAll(); }

<mapper namespace="cn.edu.ssm.mapper.StudentMapper"> <resultMap id="BaseResultMap" type="Student"> <id column="id" property="id"/> <id column="name" property="name"/> <id column="age" property="age"/> </resultMap> <insert id="insert" useGeneratedKeys="true" keyProperty="id"> INSERT INTO student(name,age) VALUES(#{name},#{age}) </insert> <select id="selectByPrimaryKey" resultMap="BaseResultMap"> SELECT * FROM student WHERE id=#{id} </select> <select id="listAll" resultMap="BaseResultMap"> SELECT * FROM student </select> </mapper>

(3) service

@Service public class StudentService { @Autowired private StudentMapper studentMapper; @Transactional // 事务边界在 Service public int addStudent(Student s){ return studentMapper.insert(s); } public List<Student> getAll(){ return studentMapper.listAll(); } }

(4) controller

@RestController @RequestMapping("/student") public class StudentController { @Resource private StudentService studentService; @PostMapping @ResponseBody public ApiResult add(@RequestBody Student s){ int rows = studentService.addStudent(s); return ApiResult.success(rows); } @GetMapping("/list") @ResponseBody public ApiResult list(){ return ApiResult.success(studentService.getAll()); } }

4. 数据库连接池与事务传播行为

Druid 默认开启 testOnBorrow=false，线上一定加 validationQuery=SELECT 1，防止网络闪断拿到“死连接”。
事务传播：毕设常用 REQUIRED，一个业务方法嵌套另一个 Service 方法时，共用一个事务即可；如果内层需要独立回滚，再考虑 REQUIRES_NEW，但记得把异常捕获放在外层，否则仍触发整体回滚。

5. 简单 XSS 防护

SpringMVC 端加过滤器最省事：

@Component @WebFilter("/*") public class XssFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { chain.doFilter(new XssHttpServletRequestWrapper((HttpServletRequest) req), resp); } }

包装类把特殊字符转义即可，这里用 ESAPI 或自己写正则都行，保证<script>进不来。

四、生产环境避坑指南

Tomcat 热部署路径大小写问题：Windows 开发不区分大小写，Linux 区分。把mapper/StudentMapper.xml写成studentMapper.xml，部署后就会报 “Mapped Statements collection does not contain value”。统一用驼峰+首字母大写，目录和文件名保持一致。
MyBatis 二级缓存误用：默认开启局部缓存（一级），但二级缓存需要<cache/>标签并且实体可序列化。很多同学在 *Mapper.xml 里顺手加<cache/>，结果实体没实现 Serializable，线上并发一上来就抛NotSerializableException。毕设数据量小，建议直接关闭二级缓存：在mybatis-config.xml加<setting name="cacheEnabled" value="false"/>。
DAO 层命名不规范导致 N+1：例如先listAll()再循环里调用selectClassById()，每行 SQL 一次，1000 条数据就 1000+1 条 SQL。用 MyBatis 嵌套查询或 JOIN 一次把关联对象查出，既减少网络往返，也避免老师质疑“性能谁教的”。

五、下一步：把 Redis 和 JWT 玩进去

SSM 模板跑通后，想继续拔高可以试下面两个小目标：

集成 Redis 做缓存：把热点查询结果序列化 JSON 存 Redis，用 Spring 的Cacheable注解，减少数据库压力。
替换 Session：用 JWT 做无状态登录，实现“登录颁发 token—访问带 Authorization—拦截器验签”，让老项目也能说自己是前后端分离。

完成任意一个，都能在答辩 PPT 里加一页“性能优化/安全升级”，分数一般不会低。

全文代码都在学校 GitLab 建了示例仓库，把包名改成自己的学号就能直接交差。第一次跑通 SSM 的确像拼乐高，但只要你把“配置拆细、目录定死、注释写满”这三板斧用好，后面再老的项目也能轻松拆楼重建。希望这份避坑笔记能让你在毕设季少熬几个通宵，早日把系统跑通，把时间省下来写论文、刷剧或者准备面试，祝一次通过！