又是一年课设季很多人手里都攥着一份“java_ssm59学生成绩查询考务系统”的IDEA项目源码却不知道第一步点哪里。这套基于SSM框架的学生成绩查询考务系统虽然在技术上不算新但角色登录、成绩录入、成绩查询、考试安排这些功能特别齐全拿来学习Spring MVC、Spring、MyBatis怎么协作或者改造成自己的课程设计都非常合适。这篇文章不打算贴整段项目代码只把我拿到这类源码之后从导入、配置、运行到排查问题的思路完整讲一遍。如果你正对着一个SSM项目在IDE里发懵按这个顺序走一般都能把系统跑起来。1. 先从源码目录看清楚这个考务系统值不值得跑1.1 拿到源码后不要急着双击先看目录结构很多同学下载完源码的第一反应是双击项目文件夹看哪个文件能点开然后就开始乱翻。我的习惯是先看整体目录判断它到底是不是一个标准的Maven Web项目。拿这套学生成绩查询考务系统来说解压之后大概长这样java_ssm59 ├── pom.xml ├── src │ ├── main │ │ ├── java/com/school/exam │ │ │ ├── controller │ │ │ ├── service │ │ │ ├── dao │ │ │ ├── entity │ │ │ └── common │ │ ├── resources │ │ │ ├── mapper │ │ │ ├── spring │ │ │ ├── jdbc.properties │ │ │ └── mybatis-config.xml │ │ └── webapp │ │ ├── WEB-INF/web.xml │ │ ├── static │ │ └── jsp └── README.md看到pom.xml说明这是Maven管理的项目看到src/main/webapp说明它有Web页面看到resources下面有mapper和spring配置说明MyBatis和Spring的配置文件都在这里。这样一个结构基本就自洽了值得继续搞。如果打开的源码连pom.xml都没有只有一堆散落的.java文件和.jsp文件那多半是被谁从运行环境里直接拷贝出来的缺少了构建配置。这种项目我一般建议先放弃因为补环境依赖比重新写一个还痛苦。1.2 这个系统包含哪些功能模块学生成绩查询考务系统在高校课设里属于“标准款”它一般不会特别复杂但功能链路是完整的。按我看到的常见版本大致有这几个模块模块典型页面使用角色登录与权限控制login.jsp、index.jsp管理员、教师、学生学生信息管理studentList.jsp、studentEdit.jsp管理员课程和班级管理courseList.jsp、clazzList.jsp管理员成绩录入scoreInput.jsp教师成绩查询scoreQuery.jsp、scoreDetail.jsp学生、教师考务管理examPlanList.jsp、examRoomList.jsp管理员、教师这些功能基本把SSM最常见的增删改查、多表联查、动态SQL、会话管理都覆盖了。哪怕你以后去做Spring Boot项目这些业务思路依然通用只是换了一套壳而已。1.3 先看pom.xml三大件版本是不是一致打开pom.xml重点看三样东西spring.version、mybatis.version、mysql-connector-java的版本以及打包方式是不是war。我这里给出一份常见的版本组合你可以对照着判断项目是否容易跑起来Spring或者Spring MVC版本在4.x到5.x之间配JDK 1.8基本没问题MyBatis使用3.4或3.5属于稳定版mysql驱动如果是5.x连接MySQL 5.7/8.0都还算兼容但连接串要处理好时区打包方式是war因为要部署到Tomcat。如果发现pom.xml里三个框架版本互相矛盾比如Spring 5配了非常老的MyBatis 3.2运行时很容易出现NoSuchMethodError。这个时候先不要启动项目直接在pom.xml里统一版本反而更快。2. 把 JDK、Maven、MySQL 和 Tomcat 准备好跑 SSM 项目才能不心塞2.1 一套不容易出错的本地环境版本匹配我见过太多人在SSM项目上翻车不是因为代码不对而是因为本机环境太乱。这四样东西的版本匹配基本决定了你后面能不能顺利启动。组件推荐版本说明JDK1.8SSM老项目最稳的版本高版本JDK配合旧Spring容易出反射报错Maven3.6.33.6.x对旧项目的兼容性比4.x好Tomcat8.5/9.0对应Servlet 3.x/4.x跟Spring MVC集成方便MySQL5.7/8.05.7最省心8.0要把驱动和时区处理好IDEA2020之后版本都行社区版能用但配置Tomcat会麻烦一点为什么我首推JDK 1.8因为大部分SSM课设源码基于Spring 4或Spring 5编写它们对高版本JDK的模块化支持并不好。如果你本机装的是JDK 17还强行运行老项目大概率会遇到IllegalAccessError或者模块java.base不能访问之类的怪问题。与其花时间折腾不如装一个JDK 1.8把Project SDK指过去。2.2 IDEA里的SDK、Maven和本地仓库必须统一打开IDEA之后别急着导入项目先把IDEA自己的设置打扫干净。进入File - Project Structure - Project确认Project SDK选择了JDK 1.8Language level选择8或者SDK defaultProject compiler output路径指向项目下的target目录。接着是Maven配置。进入File - Settings - Build, Execution, Deployment - Build Tools - Maven指定自己的Maven home path、User settings file和Local repository。Local repository这块大家很容易忽略如果之前别人用同一个IDEA配置过别的项目本地仓库有可能已经被写入了乱七八糟的旧包。建议单独建一个目录作为SSM项目的本地仓库比如D:/maven-repo-ssm让依赖干净一点。Maven下载依赖慢是常见问题这里不是让你开什么特殊网络工具而是在settings.xml里配置国内镜像源。把mirror配置成阿里云或者腾讯云的Maven仓库地址速度和稳定性都会好很多。配完之后在IDEA里点一下Maven面板的刷新按钮等依赖下载完。2.3 数据库初始化这一步最容易翻车源码包正常会带一个.sql脚本通常在db/或sql/目录下。用Navicat、DBeaver或者命令行执行之前先把它打开看一眼确认里面有没有CREATE DATABASE语句。如果没有你需要手动建库再导入表结构和数据。建议统一用UTF-8编码否则页面上中文全是乱码。建库语句大概是CREATE DATABASE IF NOT EXISTS ssm_exam DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; USE ssm_exam; SOURCE D:/path/to/ssm_exam.sql;导入完成后去resources/jdbc.properties修改连接信息。注意几个细节jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/ssm_exam?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password你的密码如果MySQL是8.0版本驱动类要改成com.mysql.cj.jdbc.Driver同时serverTimezone一定不能少否则启动时会出现时区相关的报错。这一步是SSM项目能跑起来的最关键前置条件。2.4 Tomcat到底怎么配才不重复踩坑如果用IDEA Ultimate版本配置Tomcat很方便Run - Edit Configurations - - Tomcat Server - Local然后在Server页签选本机的Tomcat路径。这一步并不需要额外做什么。如果是社区版没有内置的Tomcat集成按钮我建议直接用外置Tomcat把项目打成war包丢到Tomcat的webapps目录启动Tomcat后自动解压。虽然少了热部署但跑通逻辑完全一样。3. 在 IDEA 里把 SSM 源码变成可运行 Web 项目的标准姿势3.1 导入项目别选New Project要用Open来识别Maven很多新人打开IDEA后习惯性点New Project然后从零开始建工程。如果你已经有现成源码正确的做法是在IDEA欢迎界面点Open选择源码根目录也就是包含pom.xml的那一层等待IDEA扫描项目右下角出现Maven坐标时说明已经识别成功如果IDEA没有自动识别Maven右键点击pom.xml选择Add as Maven Project。导入之后可以先不碰代码等右下角进度条把Maven依赖索引完。索引没结束之前整个项目里的import基本都会标红那不是代码错误是仓库还没准备好。此时可以看右侧的Maven面板如果展开Dependencies能看到各个jar包就说明没大问题。3.2 检查Web Facet和Artifact能编译Java代码不代表能跑Web项目。IDEA要运行一个带JSP的SSM系统必须让IDEA知道这是个Web项目。进入Project Structure - Facets看看有没有一个名叫Web的Facet它的Web Resource Directory应该指向src/main/webapp。如果没有手动添加Web Facet然后指定web.xml路径和Web资源目录。这一步做完再看Project Structure - Artifacts。对SSM项目我强烈建议选择Web Application: Exploded而不是打包成war再部署。Exploded模式的意思是让IDEA直接运行编译后的目录改动Java文件后可以配合热部署快速生效调试效率高。Artifact的Output Layout里Available Elements如果有依赖没有自动进WEB-INF/lib手动右键点击Put into WEB-INF/lib。这一步很关键否则Tomcat启动后会出现ClassNotFoundException你翻日志的时候根本想不到是Artifact没带依赖。3.3 启动前的三次检查能帮你省下至少半小时配置完Tomcat和Artifact之后不要急着点绿色三角。按我习惯启动前做三次快速检查第一次检查resources目录是否被正确标记。在IDEA里右键点击src/main/resources选择Mark Directory as - Resources Root。如果不标记Spring配置文件applicationContext.xml、jdbc.properties都不会出现在编译输出目录里后果是启动时直接提示找不到配置文件。第二次检查web.xml里的contextConfigLocation路径。很多SSM项目的配置路径是classpath:spring/applicationContext.xml如果资源目录没标记对这个路径一定失效。看到ClassNotFoundException或FileNotFoundException先往资源目录方向想别急着怀疑代码。第三次检查Tomcat的Deployment页签里Application context写的是什么。我见过有人把上下文路径改成/ssm59访问地址却一直用localhost:8080/ssm59/结果打不开最后发现是路径大小写不对。这个环境里推荐统一用小写并且访问时带尾斜杠。4. 登录、查成绩、录成绩三层架构下的核心代码是怎么串起来的4.1 一次登录请求从JSP到数据库要走多少步SSM项目最典型的执行路径就是浏览器发起请求 - Spring MVC的前端控制器DispatcherServlet拦截 - 找到RequestMapping对应的Controller方法 - 调用Service - Service调用Mapper接口 - MyBatis执行SQL - 返回结果逐层回到前端。以登录为例代码大致长这样Controller public class LoginController { Autowired private UserService userService; RequestMapping(/login) public String login(String username, String password, HttpSession session) { User user userService.login(username, password); if (user ! null) { session.setAttribute(loginUser, user); return redirect:/index.jsp; } return login; } }这里你会频繁看到几个SSM常用注解Controller负责把类标记成Spring MVC控制器Service负责把业务类注册到Spring容器Autowired负责注入依赖RequestMapping负责绑定URL和方法的映射。这些注解如果以前不熟看一次登录流程基本就全记住了。Service层通常是这样Service public class UserServiceImpl implements UserService { Autowired private UserMapper userMapper; Override public User login(String username, String password) { return userMapper.findUser(username, password); } }登录看似简单但要防止SQL注入不能用字符串拼接而是要在Mapper接口里用Param注解声明参数然后到XML里用#{username}预编译。这是SSM项目里最基本的安全习惯。4.2 成绩查询是怎么做多表联查的学生成绩查询通常不只看分数还要显示学号、姓名、课程名、班级、学期。这些数据分布在student、course、score三张表里所以Mapper的XML里就要写多表联查。这个模块恰好是MyBatis动态SQL最典型的用法select idselectScoreWithStudent resultTypemap SELECT s.student_no, st.student_name, c.course_name, sc.score FROM score sc JOIN student st ON sc.student_id st.id JOIN course c ON sc.course_id c.id where if teststudentId ! null AND sc.student_id #{studentId} /if if testsemester ! null AND sc.semester #{semester} /if /where ORDER BY sc.semester DESC /selectwhere标签会自动处理前面多余的AND这是MyBatis动态SQL里一个容易被新手误解的点。你不需要在每条SQL前面加WHERE 11MyBatis已经帮你做好了。如果是学生角色登录通常会把studentId从Session里取出来然后页面只显示当前登录学生的成绩。写这一块的时候注意权限校验不能让学生手动改URL里的studentId参数查别人成绩。4.3 成绩录入如何保证数据一致性成绩录入这个功能看着简单操作起来却很容易产生脏数据。比如教师录入一门课成绩时除了把分数插入score表很可能还要更新学生的平均分、修改考务安排表里的成绩状态。任何一个步骤失败系统里就会出现“成绩表有分数统计结果却没更新”的奇怪状态。这就是热词里总有人问“Java怎么保证数据一致性”的答案之一用Spring事务把多个数据库操作包成一个原子操作。在SSM里做法是在Service方法上加TransactionalOverride Transactional(rollbackFor Exception.class) public void addScore(ScoreDTO dto) { scoreMapper.insert(dto); studentMapper.updateStudentAvg(dto.getStudentId()); examPlanMapper.updateScoreStatus(dto.getExamPlanId()); }加了rollbackFor Exception.class就是告诉Spring只要方法里抛出任何异常就把前面的数据库操作全部回滚。同时还要在spring-mybatis.xml里配置好事务管理器和tx:annotation-driven/否则注解不生效。我发现很多课设源码里其实漏掉了这一步代码看起来能跑但一旦数据出问题就会很麻烦。5. 我在 IDEA 里运行这套考务系统时踩过的 5 个坑5.1 依赖爆红Maven 仓库里的包和源码对不上现象是打开项目后一堆import下面有红色波浪线Maven面板显示Could not resolve dependencies。我当时排查了两小时最后发现是本地仓库里有一个下载了一半的spring-webmvc包导致IDEA一直引用损坏的依赖。解决思路很简单先把pom.xml里所有依赖刷新一遍如果还是报错就打开本地仓库目录找到对应的jar包文件名通常会有.lastUpdated后缀文件说明下载失败。把所有失败痕迹删掉再用Maven重新下载。如果网速实在慢把镜像配置成国内源基本一次就好。5.2 数据库时区问题启动时直接报错具体报错是The server time zone value Öйú±ê׼ʱ¼ä is unrecognized这是典型的MySQL 8时区坑。很多人以为数据库连接串随便填个localhost:3306就行其实MySQL 8要求明确指定时区。我的处理方式是直接改jdbc.properties在URL末尾加上serverTimezoneAsia/Shanghai。如果是老驱动MySQL 5.7一般不报时区错误但建议还是把characterEncodingutf8带上。排查顺序是先看驱动版本再看URL参数最后看数据库表编码。这三个地方都对了中文乱码和时区问题基本消灭。5.3 Tomcat端口被占用IDEA里报红启动时IDEA直接提示Port 8080 was already in use。原因可能是之前Tomcat没关干净也可能是其他程序占用了8080端口。排查时在命令行执行netstat -ano | findstr 8080找到占用进程的PID然后去任务管理器确认是什么程序。如果是残留Tomcat就结束进程如果不想结束其他程序可以修改Tomcat的conf/server.xml把8080改成8081然后IDEA配置里的端口也要同步改。我自己的习惯是固定用8080尽量不随手换端口因为很多页面里的跳转地址都是写死的换到8081之后各种404。5.4 JSP页面中文乱码三个隐患一次排清楚页面打开后中文字符全是问号这里要检查三处。第一处是JSP文件头部有没有pageEncodingUTF-8第二处是Spring MVC的字符过滤器有没有配通常在web.xml里需要配置CharacterEncodingFilter第三处是数据库连接串里的characterEncodingutf8。我的排查链路是先看HTML源码如果源码里是正常的但浏览器显示乱码那就是响应编码问题如果数据从数据库取出来就是乱码那就是数据库连接问题。按这个链路走基本十分钟内能定位到具体某一层。5.5 改完代码不生效热部署配置不对在IDEA里修改Controller或者Service之后经常出现重新请求还是老结果的情况。这不是代码问题而是Tomcat没有把新的class文件推送过去。IDEA的Tomcat配置里在Server页签的On frame deactivation选择Update classes and resources这样切换回IDEA窗口时会自动更新。如果还是不行就用Debug模式启动需要更新时点Update按钮。这一步很影响开发体验配置好了之后改个方法、改个SQL都不用重启Tomcat能省下大量重复启动的时间。6. 从课设到能写进简历这个系统还能怎么改6.1 界面改造优先业务逻辑别乱动学生成绩查询考务系统的默认JSP页面大概率比较朴素。如果想把项目拿出去展示最直观的改法是换一套前端界面。你可以保留后端接口把页面升级成Bootstrap或者简单的Vue组件。需要说明的是老SSM项目大都是服务端渲染不是前后端分离结构所以不要直接塞一个特别现代化的前端框架进去否则揉在一起很难维护。我的建议是先把登录页和首页的CSS换成一套成熟的后台模板比如AdminLTE这类免费模板。改完之后整体观感能提升一大截但后端代码几乎不用动这对课设来说性价比很高。6.2 增加一个“考试安排通知”模块的完整套路如果不想只是换皮可以加一个考务通知模块把发布通知、列表展示、删除过期通知的功能补上。加功能的顺序有固定套路先在数据库建表比如exam_notice在entity包下新建实体类ExamNotice在dao包下新建接口ExamNoticeMapper并在resources/mapper下添加对应XML在service包下新建接口和实现类在controller包下新建ExamNoticeController在webapp/jsp下加列表页和编辑页。这样下来你就能把SSM整个调用链亲手走完一遍。面试官问你“SSM项目怎么写的”你可以直接把这条链路讲清楚这比背八股文有说服力得多。6.3 打包部署到服务器别只在IDEA里跑课设最终往往要演示甚至要部署到别人的电脑上。在IDEA里能跑还不够还要会打包。使用Maven的package命令生成target/xxx.war把这个war包复制到Tomcat的webapps目录再启动Tomcat就能自动发布。如果你的环境里装了Docker也可以把war包和Tomcat镜像打成自己的部署镜像。但这个操作需要先写Dockerfile不适合所有机器新手阶段我更推荐直接用本地Tomcat部署一条命令加一个目录就能说清楚整个部署流程。6.4 改完表结构后记得导出新的数据库脚本很多人把源码分享出去的时候只发代码不发SQL脚本或者发的还是老脚本。别人导入之后一启动就报错因为代码里用了新字段数据库里却没有。这里推荐在IDEA的Database面板右键选择数据库利用Dump功能导出最新的SQL脚本也可以用mysqldump命令行效果一样。导出之后放到项目根目录的db文件夹里这样这套源码才算完整拿出去在任何电脑上都能快速还原。最后再分享一个我自己的习惯拿到任何SSM项目源码我都会先关掉业务细节分成“环境搭建、数据库初始化、启动验证、代码走读、功能扩展”这五步去对待。这样做的好处是遇到报错时不会被一堆业务代码干扰能直接定位到配置层面。希望这套流程也能帮你把“学生成绩查询考务系统”这类IDEA项目源码彻底玩明白。