1. 项目概述与功能边界先说结论这是一套基于SSMSpring SpringMVC MyBatis的校园教务场景管理系统覆盖了选课、成绩录入与查询、教案管理三条业务主线。和网上那些“图书管理系统”“学生管理系统”不一样这个项目的核心价值在于它模拟了真实教务系统的多角色协作流程而不是单表的增删改查demo。我拿到源码第一反应是看它的角色权限设计。系统一般拆成三类用户管理员、教师、学生。管理员管基础数据和全局配置教师负责成绩录入、教案上传、选课审核学生主要做选课和查成绩。这种三角色模型是绝大多数Java Web课程设计和毕业设计的标配骨架也是企业里RBAC权限模型的一个简化版——搞清楚这套角色的数据流向和页面权限控制比背十个设计模式都有用。适合谁来研究这个项目正在做SSM课程设计/毕业设计的学生需要一套能跑通、能讲清楚、能改出自己特色的代码。刚学完SSM框架但只会写单表CRUD想看看多表关联、事务控制、文件上传该怎么落地的初学者。准备Java实习面试需要拿一个“有业务复杂度”的项目来撑简历、应付项目追问的求职者。你可能想知道的几个关键词直接交代一下项目基于Maven构建采用传统JSP JSTL页面渲染不是前后端分离数据库用MySQL 5.7或8.0均可开发工具锁定IntelliJ IDEAJDK建议1.8。这些都是Java Web开发里最稳妥的一套组合任何一个环节出问题都能在网上找到海量解决方案这也是我推荐初学者拿它练手的原因——踩坑有救。要注意一点类似项目在部署时最常见的翻车点不是代码本身而是环境错配。比如IDEA里Project SDK是17但项目编译级别还停留在1.8或者Maven仓库里缺了某个依赖导致jar包冲突再或者是Tomcat版本太高javax.servlet和jakarta.servlet包名对不上直接启动报错。这些问题我在后面章节会全部展开讲。2. SSM框架核心链路拆解2.1 三个框架各自承担什么活儿很多人学SSM最迷的地方是Spring、SpringMVC、MyBatis到底各管什么别背概念用这个项目里的真实场景说。Spring是“大管家”。它管着所有对象的创建和依赖关系。项目里的UserService、CourseService、ScoreService这些业务类以及后续要用的Mapper接口全部交给Spring容器托管。你在service层写Autowired注入mapper在controller里写Autowired注入service这个过程中你没有任何一行new的代码——对象谁创建的Spring。好处是什么解耦。哪天你想把UserServiceImpl换成另一个实现类只要改配置文件或注解不需要动调用方代码。SpringMVC是“前台接待”。所有HTTP请求先到DispatcherServlet它根据URL找到对应的Controller方法把请求参数绑定到方法的入参对象上方法执行完返回一个视图名再由视图解析器渲染成JSP页面响应给浏览器。这个项目里的请求路径基本遵循/controller路径/方法路径的规则比如学生提交选课请求就是POST到/student/addCourse之类的地址。MyBatis是“数据搬运工”。它负责Java对象和数据库记录之间的映射。你不用写一堆JDBC模板代码只需要定义Mapper接口然后在XML文件里写SQL语句MyBatis会自动把查询结果集映射成ListCourse、把传入的对象参数填充到#{}占位符里。这个项目SQL不算复杂但它展示了动态SQL的用法——条件查询时用if标签拼接成绩批量更新时用foreach遍历集合这些实战技能比单表查询值钱得多。2.2 一次完整请求的生命周期我强烈建议你在跑通项目后按下面这条链路走一遍断点绝对比看十篇博客有用学生在选课页面点击“选课”按钮浏览器发起POST请求URL类似/student/selectCourse?courseId101。请求先被web.xml里配置的DispatcherServlet拦截SpringMVC通过HandlerMapping找到StudentController里对应的方法。Controller方法接收参数后调用StudentService.selectCourse(studentId, courseId)。Service层先查一下学生是否已经选过这门课防重复选课再查课程容量是否已满防超选都通过了才执行插入语句并且用Transactional保证“插入选课记录”和“课程已选人数1”这两个操作要么都成功、要么都失败。Mapper接口调用对应的SQL返回受影响行数。Controller拿到结果后重定向或转发到选课结果页面提示“选课成功”或“课程已满”。这一步里的隔离级别、事务传播行为面试官隔三差五就问。别慌我会在4.2节给你一套可以直接背的答复模板。2.3 为什么现在还要学SSM有同学会问现在外面都Spring Boot了学SSM是不是浪费时间我的观点很明确SSM是理解Spring Boot的基石。Spring Boot的本质是“约定大于配置”它把SSM时代繁琐的XML配置全部自动化了。但你在Spring Boot里写Service、Repository、Controller、Mapper这些注解时如果没经历过SSM时代手动装配的过程你根本不知道Spring容器是怎么把这一堆组件串起来的。面试的时候问“Spring Boot自动配置原理”能讲清楚的人基本都是SSM底子扎实的人。再说很多学校的课程设计、老旧企业项目还在用SSM这个源码你能吃透功底的含金量比快餐式的Boot CRUD高不少。3. 数据库设计与核心表关系3.1 数据表结构全景拿到源码第一步不是急着启动先看SQL脚本。这个项目的数据库一般包含这几张核心表表名核心字段作用t_userid, username, password, role, name统一登录账号用role字段区分管理员/教师/学生t_studentid, user_id, student_no, class_name, major学生扩展信息与t_user一对一t_teacherid, user_id, teacher_no, title教师扩展信息与t_user一对一t_courseid, course_name, credit, teacher_id, capacity, selected_count课程基本信息与教师多对一t_select_courseid, student_id, course_id, select_time, status选课关系表学生与课程多对多t_scoreid, student_id, course_id, score成绩表一个学生一门课一条成绩t_teaching_planid, teacher_id, course_id, file_name, file_path, upload_time教案管理存的是文件路径而非文件本身这里最核心的设计是t_select_course这张选课关系表。学生和课程是多对多关系必须用中间表解耦。中间表里除了外键还可以冗余业务字段比如status表示“已选/退选/待审核”select_time记录选课时间这些字段能在后面统计热门课程、校验选课时间窗口时派上用场。3.2 关键SQL与表关系设计难点强烈建议你单独抽出时间把下面这几类SQL都手写一遍都是面试和实际开发里的高频考点查询某学生的所有选课及成绩SELECT c.course_name, s.score FROM t_select_course sc LEFT JOIN t_course c ON sc.course_id c.id LEFT JOIN t_score s ON sc.student_id s.student_id AND sc.course_id s.course_id WHERE sc.student_id #{studentId}为什么要用LEFT JOIN而不是INNER JOIN因为学生选了课但老师还没录成绩时sc表里有记录score表里没有——LEFT JOIN能保留选课记录成绩字段为NULL页面上可以显示“未录入”。统计课程容量是否已满SELECT capacity, selected_count FROM t_course WHERE id #{courseId}然后在Service层做判断if (selectedCount capacity)才允许插入选课记录。这里特别注意高并发场景下这种“先查再插”会出超卖问题但作为课程设计项目加一个事务基本够用如果你在简历里写“通过事务保证选课数据一致性”面试官一般不会再深挖。成绩批量录入教师端成绩录入页面一般是一个表格一行一门课一个学生最后统一保存。这种场景用foreach批量更新update idbatchUpdateScore foreach collectionlist itemitem separator; UPDATE t_score SET score #{item.score} WHERE student_id #{item.studentId} AND course_id #{item.courseId} /foreach /update注意MySQL默认不接受allowMultiQueriestrue的多语句批量update如果要在一条SQL里执行多个更新需要在JDBC连接串加参数如果不想改连接串就用事务包裹的循环单条update。我在4.3节会细说这个坑。3.3 通用的字典表设计如果你想把项目做得有亮点建议在原有表基础上加一张字段字典表如t_dict存课程类型、学期、成绩等级等基础枚举值。改造点在于页面上所有下拉框不再写死而是从字典表查询。这一小改动能让答辩老师觉得你考虑了“可维护性”和“数据驱动”这是加分项不是必须项。4. 基于IDEA从0到1跑通源码4.1 环境准备清单先列一个我测试过无数次的兼容组合照着配不会出大问题软件推荐版本备注JDK1.88u202或更高不要用17SSM老项目大多不支持IntelliJ IDEA2021.x 或 2022.x社区版够用旗舰版支持Spring插件更顺Maven3.6.xIDEA自带也可以但建议用独立安装版Tomcat8.5.x别用Tomcat 10包名对不上MySQL5.7或8.08.0注意驱动版本和时区问题这里有个经验很多同学项目启动报错最后查出来是Tomcat版本问题。SSM项目用的是javax.servlet包Tomcat 10开始换成jakarta.servlet依赖里的包名对不上启动直接NoClassDefFoundError。无脑用Tomcat 8.5就完事了。4.2 IDEA导入与配置详解步骤一IDEA里选择File - New - Project from Existing Sources选中项目的pom.xmlMaven会自动开始下载依赖。如果Maven下载慢在settings.xml里配置阿里云镜像mirror idaliyunmaven/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror步骤二配置Project Structure。按CtrlAltShiftS确认Project SDK是1.8Project language level是8Modules里的Language level也同步改成8。这里如果不一致编译时会报“java: 错误: 不支持发行版本 17”之类的错。步骤三导入数据库。用Navicat或MySQL命令行执行项目里的sql脚本mysql -u root -p db_ssm.sql然后修改项目的JDBC配置文件一般在src/main/resources/jdbc.propertiesjdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/ssm_system?useSSLfalsecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456MySQL 8.0以上驱动要改成com.mysql.cj.jdbc.Driverurl里加serverTimezoneAsia/Shanghai否则会报时区错误。步骤四配置Tomcat。点Run - Edit Configurations - - Tomcat Server - Local在Deployment页签点加号选Artifact选项目的war exploded包Application context填/即可。这一步很多人配错不是项目有问题而是没有把war包部署到Tomcat上。步骤五启动。Tomcat跑起来后浏览器访问http://localhost:8080/进入登录页用管理员账号登录。默认账号密码一般在SQL脚本的insert语句里比如admin/123456。4.3 项目结构讲解包名与分层规范开源项目看结构就能看出作者功底。这个项目的包结构一般是com.xxx.system ├── controller ├── service │ └── impl ├── dao / mapper ├── entity / pojo ├── utils └── interceptorinterceptor包是这个项目的亮点之一。SSM中做登录状态校验一般用拦截器实现在spring-mvc.xml里配置拦截路径mvc:interceptors mvc:interceptor mvc:mapping path/**/ mvc:exclude-mapping path/login/ mvc:exclude-mapping path/static/**/ bean classcom.xxx.system.interceptor.LoginInterceptor/ /mvc:interceptor /mvc:interceptors登录拦截器做两件事检查session里有没有user对象检查用户角色是否有权限访问当前请求路径。这一步做得好不好直接决定系统是否安全。很多项目答辩时被问“怎么防止学生直接访问教师页面”答案就在拦截器里。学到这个点你的收获就已经超过项目本身了。5. 核心功能模块实操与代码导读5.1 登录与权限控制登录逻辑很标准提交用户名密码Service层根据username查user然后用MD5或BCrypt对密码摘要对比匹配则把user对象放进session跳转对应用户角色的首页。我第一次看这个模块时踩过一个隐蔽坑MD5加密的密码写死在数据库里如果项目代码里用了MD5Util工具类而工具的算法和数据库里的密文不一致你怎么登都登不进去。遇到登录失败先核对账号密码密文再用一个简单的main方法手写MD5验证一下。另外SSM里权限控制的粒度通常是“页面级”而非“按钮级”拦截器按角色过滤URL前缀即可。比如/admin/**只有管理员能访问/teacher/**只有教师能访问/student/**只有学生能访问。这种粗粒度控制在课程设计完全够了。5.2 选课模块的业务规则选课模块是这个项目里业务规则最复杂的部分也是面试时最能讲出花的部分。通常包含以下校验链登录校验是否已登录是学生身份。时间窗口校验当前时间是否在选课开放时间内部分项目没有这功能需要自行补充。重复选课校验同一学生、同一课程是否已有记录。课程容量校验已选人数是否小于课程容量。先修课程校验进阶部分课程有先修要求未通过先修课程不能选。这5步体现的是从“功能开发”到“业务开发”的思维转变。CRUD谁都会但能把校验规则一条条理清并落地的才是实际项目里要的人。5.3 成绩模块的录入与统计成绩录入是教师角色的核心操作。教师在选课关系表里按课程筛选学生列表录入分数保存。录入后学生端可以立即看到成绩所以成绩表与选课表的设计关系到实时性。我建议你在这个模块里给自己加一个小功能按成绩区间统计各分数段人数并画一个简单的柱状图。用ECharts引入前端就行后端写一个统计SQLSELECT SUM(CASE WHEN score 90 THEN 1 ELSE 0 END) AS excellent, SUM(CASE WHEN score 80 AND score 90 THEN 1 ELSE 0 END) AS good, SUM(CASE WHEN score 60 AND score 80 THEN 1 ELSE 0 END) AS pass, SUM(CASE WHEN score 60 THEN 1 ELSE 0 END) AS fail FROM t_score WHERE course_id #{courseId}这个功能能让答辩老师眼前一亮而且实现成本不高。5.4 教案文件上传与下载教案模块涉及SpringMVC的文件上传。核心配置在spring-mvc.xmlbean idmultipartResolver classorg.springframework.web.multipart.commons.CommonsMultipartResolver property namemaxUploadSize value10485760/ property namedefaultEncoding valueUTF-8/ /beanController里接收MultipartFile把文件写到服务器本地磁盘或OSS数据库只存路径。这里有几个很容易踩的坑上传目录不存在时需先创建目录用FileUtil.mkdir或者file.getParentFile().mkdirs()。文件名不能直接存用户原始文件名容易中文乱码和路径注入建议用UUID重命名保存原始文件名到数据库的file_name字段用于下载展示。下载时设置响应头Content-Disposition: attachment; filenamexxx.xlsx否则浏览器可能直接在页面打开文件。我在测试时遇到过一个问题本地IDEA里上传的文件写到了Tomcat部署目录下重启Tomcat后文件被清空。原因是IDEA的Tomcat部署时用了target目录的临时副本。解决方案是配置一个虚拟路径映射在Tomcat的server.xml里加一段Context docBaseD:/uploads path/upload reloadabletrue/或者直接在项目的Config类里配置资源映射把/upload/**映射到物理磁盘路径。这个点很多教程不讲但现实中一定会碰到。6. 常见问题与排查技巧实录6.1 编译期报错速查表报错信息原因解决方案java: 错误: 不支持发行版本 17Project SDK和language level不一致统一改为JDK 1.8和level 8程序包org.springframework不存在Maven依赖没下载或没刷新Reimport All Maven Projects找不到符号getServletContext缺javax.servlet-api依赖确认scope是provided还是compileError creating bean with name userMapperMapper接口未加Mapper或未扫包检查启动类/XML里MapperScannerConfigurer6.2 运行期问题排查思路启动报404是最常见的。先检查Tomcat的Deployment里有没有配artifact再看Application context是不是/最后确认访问路径和Controller里的RequestMapping完全一致。有时候一个斜杠的差别就能404一上午。登录后页面样式全丢一般有两种原因一是静态资源路径写成了绝对路径/css/style.css项目部署上下文不是根路径导致找不到二是SpringMVC拦截了静态资源请求忘了加mvc:default-servlet-handler/或mvc:resources配置。后者的报错特征最明显——控制台没有报错浏览器F12全是404。数据库中文乱码也特别常见。排除思路先看数据库表是不是utf8再看JDBC连接串是否带characterEncodingutf8再看页面是否设置了% page contentTypetext/html;charsetUTF-8%最后看Tomcat的server.xml里Connector是否加了URIEncodingUTF-8。四层排查完基本能解决。6.3 我踩过的几个最折磨人的坑第一个坑Maven依赖冲突。项目里同时引入了低版本和高版本的mysql-connector-java导致驱动类加载错乱。解决方法是打开Maven面板的Dependency Analyzer把冲突的jar包exclude掉。第二个坑Tomcat热部署失效。改了Java代码后不重启页面一直显示旧内容。原因是被Deployment选择了war包而非war explodedIDEA对war包模式不支持热部署。切到exploded模式勾上Build - Build Project automatically就能实现改代码自动重启效率提升巨大。第三个坑idea提示Picked up JAVA_TOOL_OPTIONS。这个是系统环境变量里设了JAVA_TOOL_OPTIONS导致Tomcat启动日志出现冗余信息一般不影响运行但会让人误以为报错。如果不喜欢这个提示可以删掉系统环境变量里的JAVA_TOOL_OPTIONS或者在Tomcat启动脚本里强制清空。第四个坑批量更新成绩报错。这个我在3.2节提过核心原因是MySQL JDBC驱动默认不允许一条SQL里写多个更新语句。如果坚持要用foreach生成一条多语句SQL必须在jdbc url里加allowMultiQueriestrue。但更稳妥的做法是Service层开事务循环调用单条update。前者快后者稳分清楚场景再用。6.4 从“能跑”到“能讲”答辩/面试前必做的功课项目跑通只是第一步你能把项目讲清楚才是真正拉开差距的地方。建议按下述提纲准备说说整个系统的架构前端JSP SpringMVC Service MyBatis MySQL画出请求流转图。说说为什么选SSM而不用Spring Boot学校要求/课程体系/想深入理解配置原理体现你的思考而不是无脑跟风。说说选课并发这个场景怎么保证不超卖事务 锁/乐观锁/唯一索引三种方案你都知道项目里用的是哪一种为什么够用。说说你在这个项目里遇到的最大的坑是什么选一个上面列的坑讲清现象、排查思路、最终解决方案。这一套准备下来无论是课程答辩还是实习面试这个项目就能真正变成你的谈资而不是简历上的一行字。7. 我的一些后续扩展建议项目如果只是照着跑通说实话收获有限。我个人经验是一个SSM项目至少给它做两次“手术”才算真正吃透。第一个建议是加一个简单的Redis缓存。学生查成绩和课程列表是高频操作把热门课程列表或成绩查询结果缓存到Redis命中缓存就直接返回。这个改动不需要动表结构只需要引入spring-data-redis依赖写一个RedisConfig和工具类然后在Service层加几行判断。但它能让你在简历里写“利用Redis降低数据库压力”面试官一看就知道你不是照抄项目的。第二个建议是把登录密码从MD5升级为BCrypt加密。Spring Security里有BCryptPasswordEncoder但SSM项目里更轻量的做法是引入jBCrypt库改一下登录模块的校验方法即可。这个点能体现你的安全意识。第三个建议是增加一个数据可视化大屏。用ECharts展示全校选课人数TOP10课程、各专业平均分、教师教案上传数量等。这种功能很讨喜而且前端是静态图表后端只需提供几个统计数据接口开发量不大。如果答辩时被问到“项目有哪些应用价值”这个大屏就是直观的答案。说到底源码只是一个起点。挖掘出背后那套业务逻辑、权限模型、事务处理思路再从自己的角度去改造它这个项目才真正属于你。 
长河君 · 2026/9/9 9:20:05 · 阅读 1.2k SSM校园教务管理系统实战：从框架原理到部署避坑指南
1. 项目概述与功能边界先说结论这是一套基于SSMSpring SpringMVC MyBatis的校园教务场景管理系统覆盖了选课、成绩录入与查询、教案管理三条业务主线。和网上那些“图书管理系统”“学生管理系统”不一样这个项目的核心价值在于它模拟了真实教务系统的多角色协作流程而不是单表的增删改查demo。我拿到源码第一反应是看它的角色权限设计。系统一般拆成三类用户管理员、教师、学生。管理员管基础数据和全局配置教师负责成绩录入、教案上传、选课审核学生主要做选课和查成绩。这种三角色模型是绝大多数Java Web课程设计和毕业设计的标配骨架也是企业里RBAC权限模型的一个简化版——搞清楚这套角色的数据流向和页面权限控制比背十个设计模式都有用。适合谁来研究这个项目正在做SSM课程设计/毕业设计的学生需要一套能跑通、能讲清楚、能改出自己特色的代码。刚学完SSM框架但只会写单表CRUD想看看多表关联、事务控制、文件上传该怎么落地的初学者。准备Java实习面试需要拿一个“有业务复杂度”的项目来撑简历、应付项目追问的求职者。你可能想知道的几个关键词直接交代一下项目基于Maven构建采用传统JSP JSTL页面渲染不是前后端分离数据库用MySQL 5.7或8.0均可开发工具锁定IntelliJ IDEAJDK建议1.8。这些都是Java Web开发里最稳妥的一套组合任何一个环节出问题都能在网上找到海量解决方案这也是我推荐初学者拿它练手的原因——踩坑有救。要注意一点类似项目在部署时最常见的翻车点不是代码本身而是环境错配。比如IDEA里Project SDK是17但项目编译级别还停留在1.8或者Maven仓库里缺了某个依赖导致jar包冲突再或者是Tomcat版本太高javax.servlet和jakarta.servlet包名对不上直接启动报错。这些问题我在后面章节会全部展开讲。2. SSM框架核心链路拆解2.1 三个框架各自承担什么活儿很多人学SSM最迷的地方是Spring、SpringMVC、MyBatis到底各管什么别背概念用这个项目里的真实场景说。Spring是“大管家”。它管着所有对象的创建和依赖关系。项目里的UserService、CourseService、ScoreService这些业务类以及后续要用的Mapper接口全部交给Spring容器托管。你在service层写Autowired注入mapper在controller里写Autowired注入service这个过程中你没有任何一行new的代码——对象谁创建的Spring。好处是什么解耦。哪天你想把UserServiceImpl换成另一个实现类只要改配置文件或注解不需要动调用方代码。SpringMVC是“前台接待”。所有HTTP请求先到DispatcherServlet它根据URL找到对应的Controller方法把请求参数绑定到方法的入参对象上方法执行完返回一个视图名再由视图解析器渲染成JSP页面响应给浏览器。这个项目里的请求路径基本遵循/controller路径/方法路径的规则比如学生提交选课请求就是POST到/student/addCourse之类的地址。MyBatis是“数据搬运工”。它负责Java对象和数据库记录之间的映射。你不用写一堆JDBC模板代码只需要定义Mapper接口然后在XML文件里写SQL语句MyBatis会自动把查询结果集映射成ListCourse、把传入的对象参数填充到#{}占位符里。这个项目SQL不算复杂但它展示了动态SQL的用法——条件查询时用if标签拼接成绩批量更新时用foreach遍历集合这些实战技能比单表查询值钱得多。2.2 一次完整请求的生命周期我强烈建议你在跑通项目后按下面这条链路走一遍断点绝对比看十篇博客有用学生在选课页面点击“选课”按钮浏览器发起POST请求URL类似/student/selectCourse?courseId101。请求先被web.xml里配置的DispatcherServlet拦截SpringMVC通过HandlerMapping找到StudentController里对应的方法。Controller方法接收参数后调用StudentService.selectCourse(studentId, courseId)。Service层先查一下学生是否已经选过这门课防重复选课再查课程容量是否已满防超选都通过了才执行插入语句并且用Transactional保证“插入选课记录”和“课程已选人数1”这两个操作要么都成功、要么都失败。Mapper接口调用对应的SQL返回受影响行数。Controller拿到结果后重定向或转发到选课结果页面提示“选课成功”或“课程已满”。这一步里的隔离级别、事务传播行为面试官隔三差五就问。别慌我会在4.2节给你一套可以直接背的答复模板。2.3 为什么现在还要学SSM有同学会问现在外面都Spring Boot了学SSM是不是浪费时间我的观点很明确SSM是理解Spring Boot的基石。Spring Boot的本质是“约定大于配置”它把SSM时代繁琐的XML配置全部自动化了。但你在Spring Boot里写Service、Repository、Controller、Mapper这些注解时如果没经历过SSM时代手动装配的过程你根本不知道Spring容器是怎么把这一堆组件串起来的。面试的时候问“Spring Boot自动配置原理”能讲清楚的人基本都是SSM底子扎实的人。再说很多学校的课程设计、老旧企业项目还在用SSM这个源码你能吃透功底的含金量比快餐式的Boot CRUD高不少。3. 数据库设计与核心表关系3.1 数据表结构全景拿到源码第一步不是急着启动先看SQL脚本。这个项目的数据库一般包含这几张核心表表名核心字段作用t_userid, username, password, role, name统一登录账号用role字段区分管理员/教师/学生t_studentid, user_id, student_no, class_name, major学生扩展信息与t_user一对一t_teacherid, user_id, teacher_no, title教师扩展信息与t_user一对一t_courseid, course_name, credit, teacher_id, capacity, selected_count课程基本信息与教师多对一t_select_courseid, student_id, course_id, select_time, status选课关系表学生与课程多对多t_scoreid, student_id, course_id, score成绩表一个学生一门课一条成绩t_teaching_planid, teacher_id, course_id, file_name, file_path, upload_time教案管理存的是文件路径而非文件本身这里最核心的设计是t_select_course这张选课关系表。学生和课程是多对多关系必须用中间表解耦。中间表里除了外键还可以冗余业务字段比如status表示“已选/退选/待审核”select_time记录选课时间这些字段能在后面统计热门课程、校验选课时间窗口时派上用场。3.2 关键SQL与表关系设计难点强烈建议你单独抽出时间把下面这几类SQL都手写一遍都是面试和实际开发里的高频考点查询某学生的所有选课及成绩SELECT c.course_name, s.score FROM t_select_course sc LEFT JOIN t_course c ON sc.course_id c.id LEFT JOIN t_score s ON sc.student_id s.student_id AND sc.course_id s.course_id WHERE sc.student_id #{studentId}为什么要用LEFT JOIN而不是INNER JOIN因为学生选了课但老师还没录成绩时sc表里有记录score表里没有——LEFT JOIN能保留选课记录成绩字段为NULL页面上可以显示“未录入”。统计课程容量是否已满SELECT capacity, selected_count FROM t_course WHERE id #{courseId}然后在Service层做判断if (selectedCount capacity)才允许插入选课记录。这里特别注意高并发场景下这种“先查再插”会出超卖问题但作为课程设计项目加一个事务基本够用如果你在简历里写“通过事务保证选课数据一致性”面试官一般不会再深挖。成绩批量录入教师端成绩录入页面一般是一个表格一行一门课一个学生最后统一保存。这种场景用foreach批量更新update idbatchUpdateScore foreach collectionlist itemitem separator; UPDATE t_score SET score #{item.score} WHERE student_id #{item.studentId} AND course_id #{item.courseId} /foreach /update注意MySQL默认不接受allowMultiQueriestrue的多语句批量update如果要在一条SQL里执行多个更新需要在JDBC连接串加参数如果不想改连接串就用事务包裹的循环单条update。我在4.3节会细说这个坑。3.3 通用的字典表设计如果你想把项目做得有亮点建议在原有表基础上加一张字段字典表如t_dict存课程类型、学期、成绩等级等基础枚举值。改造点在于页面上所有下拉框不再写死而是从字典表查询。这一小改动能让答辩老师觉得你考虑了“可维护性”和“数据驱动”这是加分项不是必须项。4. 基于IDEA从0到1跑通源码4.1 环境准备清单先列一个我测试过无数次的兼容组合照着配不会出大问题软件推荐版本备注JDK1.88u202或更高不要用17SSM老项目大多不支持IntelliJ IDEA2021.x 或 2022.x社区版够用旗舰版支持Spring插件更顺Maven3.6.xIDEA自带也可以但建议用独立安装版Tomcat8.5.x别用Tomcat 10包名对不上MySQL5.7或8.08.0注意驱动版本和时区问题这里有个经验很多同学项目启动报错最后查出来是Tomcat版本问题。SSM项目用的是javax.servlet包Tomcat 10开始换成jakarta.servlet依赖里的包名对不上启动直接NoClassDefFoundError。无脑用Tomcat 8.5就完事了。4.2 IDEA导入与配置详解步骤一IDEA里选择File - New - Project from Existing Sources选中项目的pom.xmlMaven会自动开始下载依赖。如果Maven下载慢在settings.xml里配置阿里云镜像mirror idaliyunmaven/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror步骤二配置Project Structure。按CtrlAltShiftS确认Project SDK是1.8Project language level是8Modules里的Language level也同步改成8。这里如果不一致编译时会报“java: 错误: 不支持发行版本 17”之类的错。步骤三导入数据库。用Navicat或MySQL命令行执行项目里的sql脚本mysql -u root -p db_ssm.sql然后修改项目的JDBC配置文件一般在src/main/resources/jdbc.propertiesjdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/ssm_system?useSSLfalsecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456MySQL 8.0以上驱动要改成com.mysql.cj.jdbc.Driverurl里加serverTimezoneAsia/Shanghai否则会报时区错误。步骤四配置Tomcat。点Run - Edit Configurations - - Tomcat Server - Local在Deployment页签点加号选Artifact选项目的war exploded包Application context填/即可。这一步很多人配错不是项目有问题而是没有把war包部署到Tomcat上。步骤五启动。Tomcat跑起来后浏览器访问http://localhost:8080/进入登录页用管理员账号登录。默认账号密码一般在SQL脚本的insert语句里比如admin/123456。4.3 项目结构讲解包名与分层规范开源项目看结构就能看出作者功底。这个项目的包结构一般是com.xxx.system ├── controller ├── service │ └── impl ├── dao / mapper ├── entity / pojo ├── utils └── interceptorinterceptor包是这个项目的亮点之一。SSM中做登录状态校验一般用拦截器实现在spring-mvc.xml里配置拦截路径mvc:interceptors mvc:interceptor mvc:mapping path/**/ mvc:exclude-mapping path/login/ mvc:exclude-mapping path/static/**/ bean classcom.xxx.system.interceptor.LoginInterceptor/ /mvc:interceptor /mvc:interceptors登录拦截器做两件事检查session里有没有user对象检查用户角色是否有权限访问当前请求路径。这一步做得好不好直接决定系统是否安全。很多项目答辩时被问“怎么防止学生直接访问教师页面”答案就在拦截器里。学到这个点你的收获就已经超过项目本身了。5. 核心功能模块实操与代码导读5.1 登录与权限控制登录逻辑很标准提交用户名密码Service层根据username查user然后用MD5或BCrypt对密码摘要对比匹配则把user对象放进session跳转对应用户角色的首页。我第一次看这个模块时踩过一个隐蔽坑MD5加密的密码写死在数据库里如果项目代码里用了MD5Util工具类而工具的算法和数据库里的密文不一致你怎么登都登不进去。遇到登录失败先核对账号密码密文再用一个简单的main方法手写MD5验证一下。另外SSM里权限控制的粒度通常是“页面级”而非“按钮级”拦截器按角色过滤URL前缀即可。比如/admin/**只有管理员能访问/teacher/**只有教师能访问/student/**只有学生能访问。这种粗粒度控制在课程设计完全够了。5.2 选课模块的业务规则选课模块是这个项目里业务规则最复杂的部分也是面试时最能讲出花的部分。通常包含以下校验链登录校验是否已登录是学生身份。时间窗口校验当前时间是否在选课开放时间内部分项目没有这功能需要自行补充。重复选课校验同一学生、同一课程是否已有记录。课程容量校验已选人数是否小于课程容量。先修课程校验进阶部分课程有先修要求未通过先修课程不能选。这5步体现的是从“功能开发”到“业务开发”的思维转变。CRUD谁都会但能把校验规则一条条理清并落地的才是实际项目里要的人。5.3 成绩模块的录入与统计成绩录入是教师角色的核心操作。教师在选课关系表里按课程筛选学生列表录入分数保存。录入后学生端可以立即看到成绩所以成绩表与选课表的设计关系到实时性。我建议你在这个模块里给自己加一个小功能按成绩区间统计各分数段人数并画一个简单的柱状图。用ECharts引入前端就行后端写一个统计SQLSELECT SUM(CASE WHEN score 90 THEN 1 ELSE 0 END) AS excellent, SUM(CASE WHEN score 80 AND score 90 THEN 1 ELSE 0 END) AS good, SUM(CASE WHEN score 60 AND score 80 THEN 1 ELSE 0 END) AS pass, SUM(CASE WHEN score 60 THEN 1 ELSE 0 END) AS fail FROM t_score WHERE course_id #{courseId}这个功能能让答辩老师眼前一亮而且实现成本不高。5.4 教案文件上传与下载教案模块涉及SpringMVC的文件上传。核心配置在spring-mvc.xmlbean idmultipartResolver classorg.springframework.web.multipart.commons.CommonsMultipartResolver property namemaxUploadSize value10485760/ property namedefaultEncoding valueUTF-8/ /beanController里接收MultipartFile把文件写到服务器本地磁盘或OSS数据库只存路径。这里有几个很容易踩的坑上传目录不存在时需先创建目录用FileUtil.mkdir或者file.getParentFile().mkdirs()。文件名不能直接存用户原始文件名容易中文乱码和路径注入建议用UUID重命名保存原始文件名到数据库的file_name字段用于下载展示。下载时设置响应头Content-Disposition: attachment; filenamexxx.xlsx否则浏览器可能直接在页面打开文件。我在测试时遇到过一个问题本地IDEA里上传的文件写到了Tomcat部署目录下重启Tomcat后文件被清空。原因是IDEA的Tomcat部署时用了target目录的临时副本。解决方案是配置一个虚拟路径映射在Tomcat的server.xml里加一段Context docBaseD:/uploads path/upload reloadabletrue/或者直接在项目的Config类里配置资源映射把/upload/**映射到物理磁盘路径。这个点很多教程不讲但现实中一定会碰到。6. 常见问题与排查技巧实录6.1 编译期报错速查表报错信息原因解决方案java: 错误: 不支持发行版本 17Project SDK和language level不一致统一改为JDK 1.8和level 8程序包org.springframework不存在Maven依赖没下载或没刷新Reimport All Maven Projects找不到符号getServletContext缺javax.servlet-api依赖确认scope是provided还是compileError creating bean with name userMapperMapper接口未加Mapper或未扫包检查启动类/XML里MapperScannerConfigurer6.2 运行期问题排查思路启动报404是最常见的。先检查Tomcat的Deployment里有没有配artifact再看Application context是不是/最后确认访问路径和Controller里的RequestMapping完全一致。有时候一个斜杠的差别就能404一上午。登录后页面样式全丢一般有两种原因一是静态资源路径写成了绝对路径/css/style.css项目部署上下文不是根路径导致找不到二是SpringMVC拦截了静态资源请求忘了加mvc:default-servlet-handler/或mvc:resources配置。后者的报错特征最明显——控制台没有报错浏览器F12全是404。数据库中文乱码也特别常见。排除思路先看数据库表是不是utf8再看JDBC连接串是否带characterEncodingutf8再看页面是否设置了% page contentTypetext/html;charsetUTF-8%最后看Tomcat的server.xml里Connector是否加了URIEncodingUTF-8。四层排查完基本能解决。6.3 我踩过的几个最折磨人的坑第一个坑Maven依赖冲突。项目里同时引入了低版本和高版本的mysql-connector-java导致驱动类加载错乱。解决方法是打开Maven面板的Dependency Analyzer把冲突的jar包exclude掉。第二个坑Tomcat热部署失效。改了Java代码后不重启页面一直显示旧内容。原因是被Deployment选择了war包而非war explodedIDEA对war包模式不支持热部署。切到exploded模式勾上Build - Build Project automatically就能实现改代码自动重启效率提升巨大。第三个坑idea提示Picked up JAVA_TOOL_OPTIONS。这个是系统环境变量里设了JAVA_TOOL_OPTIONS导致Tomcat启动日志出现冗余信息一般不影响运行但会让人误以为报错。如果不喜欢这个提示可以删掉系统环境变量里的JAVA_TOOL_OPTIONS或者在Tomcat启动脚本里强制清空。第四个坑批量更新成绩报错。这个我在3.2节提过核心原因是MySQL JDBC驱动默认不允许一条SQL里写多个更新语句。如果坚持要用foreach生成一条多语句SQL必须在jdbc url里加allowMultiQueriestrue。但更稳妥的做法是Service层开事务循环调用单条update。前者快后者稳分清楚场景再用。6.4 从“能跑”到“能讲”答辩/面试前必做的功课项目跑通只是第一步你能把项目讲清楚才是真正拉开差距的地方。建议按下述提纲准备说说整个系统的架构前端JSP SpringMVC Service MyBatis MySQL画出请求流转图。说说为什么选SSM而不用Spring Boot学校要求/课程体系/想深入理解配置原理体现你的思考而不是无脑跟风。说说选课并发这个场景怎么保证不超卖事务 锁/乐观锁/唯一索引三种方案你都知道项目里用的是哪一种为什么够用。说说你在这个项目里遇到的最大的坑是什么选一个上面列的坑讲清现象、排查思路、最终解决方案。这一套准备下来无论是课程答辩还是实习面试这个项目就能真正变成你的谈资而不是简历上的一行字。7. 我的一些后续扩展建议项目如果只是照着跑通说实话收获有限。我个人经验是一个SSM项目至少给它做两次“手术”才算真正吃透。第一个建议是加一个简单的Redis缓存。学生查成绩和课程列表是高频操作把热门课程列表或成绩查询结果缓存到Redis命中缓存就直接返回。这个改动不需要动表结构只需要引入spring-data-redis依赖写一个RedisConfig和工具类然后在Service层加几行判断。但它能让你在简历里写“利用Redis降低数据库压力”面试官一看就知道你不是照抄项目的。第二个建议是把登录密码从MD5升级为BCrypt加密。Spring Security里有BCryptPasswordEncoder但SSM项目里更轻量的做法是引入jBCrypt库改一下登录模块的校验方法即可。这个点能体现你的安全意识。第三个建议是增加一个数据可视化大屏。用ECharts展示全校选课人数TOP10课程、各专业平均分、教师教案上传数量等。这种功能很讨喜而且前端是静态图表后端只需提供几个统计数据接口开发量不大。如果答辩时被问到“项目有哪些应用价值”这个大屏就是直观的答案。说到底源码只是一个起点。挖掘出背后那套业务逻辑、权限模型、事务处理思路再从自己的角度去改造它这个项目才真正属于你。