简介本资源是一套面向计算机专业本科生的毕业设计级在线教学质量评价系统基于SSMSpringSpringMVCMyBatis框架与MySQL构建适用于教育信息化场景下的教学过程数字化管理与多角色协同评价。资源包共913个文件涵盖143个Java后端逻辑类、52个Vue前端组件、156个JS交互脚本、92个JPG/GIF图片资源、2个SQL建库建表脚本及配套CSS、HTML、XML等完整支撑前后端分离架构压缩包大小23.93MB结构清晰含BreadCrumbs、IndexHeader等标准化Vue布局组件及install/run/build批处理脚本开箱即用。已有174人学习下载提供可直接运行的Eclipse/IDEA工程、数据库脚本、开题报告与毕业论文全文覆盖管理员、教师、督导三类角色权限体系支持学生评教、督导听课、课程管理、数据统计报表等全流程功能是实践SSMVue全栈开发与教育类系统设计的优质教学案例。1. 这不是又一个“学生打分表”SSMVue在线教学质量评价系统真能跑通督导听课闭环你见过多少个毕设项目部署到Tomcat里报404、登录页空白、饼图不渲染、MySQL连不上就直接放弃这个基于SSMSpringSpringMVCMyBatisVue的在线教学质量评价系统不是PPT里的架构图而是我亲手在IDEA 2023.2 MySQL 8.0.33 JDK 17环境下从.bat脚本一路跑通的真实工程——它把“督导申请听课→教师确认→课堂观察→多维度打分→生成统计报表→自动推送通知”这条高校教务管理中最容易断链的业务流用可调试、可修改、可扩展的代码串起来了。它不只含源码还带开题报告Word版含研究背景、技术选型对比、可行性分析、毕业论文LaTeX源码含查重率说明、系统测试用例表、UML类图与时序图Visio源文件甚至1-install.bat里预埋了建库语句和初始管理员账号。适合计算机/教育技术专业本科生做毕设也适合刚转Java后端的新手练手它没用Spring Boot自动装配黑盒所有Bean配置明明白白写在spring-context.xml里它没堆砌Vue3 Composition API炫技而是用Vue2Element UI实现响应式表格与弹窗改个字段名就能对应到MyBatis的resultMap它数据库设计踩过真实教务场景的坑——比如“学生评价”表里course_id和teacher_id必须联合唯一否则同一学生对同一课程重复提交会覆盖历史记录。别被“教学质量评价”这名字劝退它的价值不在名字而在StudentEvaluationController.java里那个被注释掉的Transactional(rollbackFor Exception.class)——那是我第三次重启Tomcat才发现的事务漏写点。2. 从.bat脚本到首页渲染SSMVue项目启动全流程拆解2.1 为什么先执行1-install.bat而不是直接mvn clean install这个项目的构建逻辑是反常规的它没走Maven标准生命周期打包WAR而是用批处理脚本接管环境初始化。1-install.bat本质是Windows下的“一键环境准备器”它干三件事① 检查mysql.exe是否在PATH中通过where mysql若未找到则提示“请先安装MySQL并配置环境变量”② 执行mysql -u root -p db/teaching_evaluation.sql导入数据库注意密码交互式输入脚本不会硬编码密码③ 创建webapps/ROOT目录并复制target/teaching-evaluation.war解压后的内容该WAR由2-run.bat触发Maven打包生成。提示teaching_evaluation.sql脚本里包含CREATE DATABASE IF NOT EXISTS teaching_evaluation DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;但没创建用户。你必须手动执行CREATE USER teach_userlocalhost IDENTIFIED BY Teach123; GRANT ALL ON teaching_evaluation.* TO teach_userlocalhost;否则jdbc.properties里的连接会失败。这是项目文档里没写的隐性依赖。# 1-install.bat 关键片段已去敏感信息 echo off echo 正在检查MySQL环境... where mysql nul 21 if %errorlevel% neq 0 ( echo [错误] MySQL未安装或未配置环境变量 pause exit /b 1 ) echo 正在导入数据库... mysql -u root -p db\teaching_evaluation.sql if %errorlevel% equ 0 ( echo 数据库导入成功 ) else ( echo [警告] 数据库导入可能失败请检查root密码是否正确 )这段批处理的逻辑是先确保MySQL可用再导入SQL。它比IDEA里右键Run As → Maven build更贴近真实部署场景——因为高校机房服务器往往禁用Maven中央仓库而.bat脚本能离线运行。如果你用Linux需将1-install.sh中mysql -u root -p改为mysql -u root -pyour_password注意引号包裹密码避免shell特殊字符解析错误并赋予chmod x权限。2.22-run.bat背后的Maven打包真相WAR包结构与Tomcat部署细节2-run.bat执行mvn clean package -Dmaven.test.skiptrue后生成的target/teaching-evaluation.war不是标准Spring Boot Fat Jar而是传统Servlet WAR包。解压它你会看到/WEB-INF/web.xml声明DispatcherServlet和CharacterEncodingFilterload-on-startup1/load-on-startup确保Spring MVC容器优先加载/WEB-INF/classes/含spring-mvc.xml配置Controller扫描路径、spring-context.xml配置Service层事务与MyBatisSqlSessionFactoryBean、jdbc.properties数据库连接参数/WEB-INF/lib/mybatis-3.4.6.jar、spring-jdbc-5.0.9.RELEASE.jar等JAR版本锁定在pom.xml的properties里避免Spring 5.x与MyBatis 3.5的兼容问题/static/存放index.html.bak原始HTML模板、css/、js/含vue.min.js2.6.14/views/login.jsp、admin/index.jsp等JSP页面但实际前端由Vue接管——index.jsp里只有一行div idapp/div所有路由由router/index.js控制。关键点在于web.xml中servlet-mapping的url-pattern//url-pattern它让所有请求包括/api/xxx都经过DispatcherServlet再由Spring MVC的RequestMapping匹配。而Vue Router的mode: history依赖此配置否则刷新页面会404。如果你用Tomcat 9需确认conf/web.xml里servlet-namedefault/servlet-name的url-pattern//url-pattern未被覆盖否则静态资源如/static/js/app.js无法访问。2.3 前端Vue如何与SSM后端通信跨域、Token传递与接口约定项目前端用Vue 2.6 axios但没配代理。所有API请求直连http://localhost:8080/api/xxx这意味着开发时必须解决跨域。解决方案藏在spring-mvc.xml里mvc:cors mvc:mapping path/api/** allowed-origins* allow-credentialstrue max-age3600/ /mvc:cors这段配置启用Spring MVC CORS支持允许任意来源携带Cookie访问/api/**路径。而axios实例在src/utils/request.js中设置了withCredentials: true确保登录态JSESSIONID随请求发送// src/utils/request.js const service axios.create({ baseURL: /api, // 注意这里用相对路径避免硬编码localhost:8080 timeout: 5000, withCredentials: true // 关键让浏览器发送Cookie })后端Controller方法用ResponseBody返回JSON如StudentEvaluationController.java中的RequestMapping(value /student/evaluate, method RequestMethod.POST) ResponseBody public ResultVO evaluate(RequestBody StudentEvaluationDTO dto, HttpServletRequest request) { // dto包含courseId, teacherId, score, comment等字段 // request.getSession().getAttribute(userId) 获取当前登录用户ID return ResultVO.success(evaluationService.saveEvaluation(dto)); }这里RequestBody自动将Vue传来的JSON解析为StudentEvaluationDTO对象而request.getSession()获取Session中的用户信息——不是JWT Token是传统Session机制。所以前端登录成功后无需存Token后续所有请求自动携带JSESSIONID Cookie。这也是为什么IndexHeader.vue.bak里logout()方法只需调用/api/logout接口服务端执行session.invalidate()即可。3. 数据库设计与MyBatis映射教务场景下的三张核心表深度解析3.1t_course、t_teacher、t_student_evaluation为什么用联合主键而非自增ID教务系统最怕数据错位。看t_student_evaluation表结构CREATE TABLE t_student_evaluation ( id bigint(20) NOT NULL AUTO_INCREMENT, student_id bigint(20) NOT NULL COMMENT 学生ID, course_id bigint(20) NOT NULL COMMENT 课程ID, teacher_id bigint(20) NOT NULL COMMENT 教师ID, score int(11) NOT NULL DEFAULT 0 COMMENT 总分, comment text COMMENT 评语, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_student_course_teacher (student_id,course_id,teacher_id) USING BTREE ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生评价表;表面看id是主键但真正防重复的关键是联合唯一索引uk_student_course_teacher。原因一个学生对同一门课的同一个任课教师只能评价一次。如果用自增ID做主键INSERT IGNORE或ON DUPLICATE KEY UPDATE会因id不同而插入新记录导致数据污染。而联合索引强制约束INSERT INTO t_student_evaluation (student_id,course_id,teacher_id,score) VALUES (1001,2001,3001,85)第二次执行会报Duplicate entry 1001-2001-3001 for key uk_student_course_teacher前端捕获此异常即可提示“您已评价过该课程”。MyBatis的StudentEvaluationMapper.xml里insertSelective方法没设useGeneratedKeystrue因为id是自增但业务逻辑不依赖它insert idinsertSelective parameterTypecom.example.entity.StudentEvaluation insert into t_student_evaluation trim prefix( suffix) suffixOverrides, if teststudentId ! nullstudent_id,/if if testcourseId ! nullcourse_id,/if if testteacherId ! nullteacher_id,/if if testscore ! nullscore,/if if testcomment ! nullcomment,/if /trim trim prefixvalues ( suffix) suffixOverrides, if teststudentId ! null#{studentId,jdbcTypeBIGINT},/if if testcourseId ! null#{courseId,jdbcTypeBIGINT},/if if testteacherId ! null#{teacherId,jdbcTypeBIGINT},/if if testscore ! null#{score,jdbcTypeINTEGER},/if if testcomment ! null#{comment,jdbcTypeLONGVARCHAR},/if /trim /insert注意if标签的判空逻辑studentId、courseId、teacherId必填score和comment可为空允许只打分不写评语这符合实际教学评价场景。3.2t_supervision_record表的设计陷阱督导听课状态机与时间戳校验督导听课流程有严格状态流转申请中(0)→已确认(1)→已听课(2)→已评价(3)。t_supervision_record表用status字段tinyint表示但仅靠数据库约束不够。看SupervisionRecordService.java里的confirmRecord()方法Transactional(rollbackFor Exception.class) public void confirmRecord(Long recordId, Long teacherId) { SupervisionRecord record supervisionRecordMapper.selectByPrimaryKey(recordId); if (!Objects.equals(record.getStatus(), 0)) { throw new BusinessException(该听课记录状态非【申请中】无法确认); } if (!Objects.equals(record.getTeacherId(), teacherId)) { throw new BusinessException(确认人不是该记录指定教师); } // 校验时间申请时间不能晚于当前时间 if (record.getApplyTime().after(new Date())) { throw new BusinessException(申请时间不能晚于当前时间); } record.setStatus((byte) 1); record.setConfirmTime(new Date()); supervisionRecordMapper.updateByPrimaryKeySelective(record); }这里三个校验缺一不可① 状态校验防止重复确认② 教师ID校验避免督导误点其他教师的记录③ 时间校验applyTime必须≤当前时间否则new Date()生成的confirmTime会早于applyTime违反业务逻辑。而teaching_evaluation.sql里t_supervision_record的apply_time字段定义为datetime DEFAULT CURRENT_TIMESTAMP但没设ON UPDATE CURRENT_TIMESTAMP——这意味着apply_time只在INSERT时赋值UPDATE时不变保证时间戳可信。3.3 MyBatis动态SQL实战学生评价统计报表的饼图数据组装StudentEvaluationController.java的getEvaluationStats()方法返回饼图所需数据其SQL在StudentEvaluationMapper.xml中用foreach动态拼接select idgetEvaluationStats resultTypecom.example.vo.EvaluationStatVO SELECT CASE WHEN score 90 THEN 优秀 WHEN score 80 THEN 良好 WHEN score 70 THEN 中等 WHEN score 60 THEN 合格 ELSE 不合格 END AS level, COUNT(*) AS count FROM t_student_evaluation WHERE course_id #{courseId} GROUP BY CASE WHEN score 90 THEN 优秀 WHEN score 80 THEN 良好 WHEN score 70 THEN 中等 WHEN score 60 THEN 合格 ELSE 不合格 END ORDER BY FIELD(level, 优秀,良好,中等,合格,不合格) /select注意ORDER BY FIELD()用法MySQL特有函数按指定顺序排序确保饼图图例从高到低排列。而EvaluationStatVO类的level和count字段被Vue组件StudentEvaluationChart.vue直接绑定到ECharts的series.data// StudentEvaluationChart.vue this.$http.get(/api/student/evaluation/stats?courseId${this.courseId}).then(res { this.chartData res.data.map(item ({ name: item.level, value: item.count })) })这里没用if判断courseId是否为空因为Controller层已用RequestParam(required true)强制校验避免SQL注入风险。4. 避坑指南SSMVue项目启动与功能验证的五个血泪经验4.1 现象首页index.html.bak打开是纯HTMLVue组件不渲染原因index.html.bak是备份文件真正入口是index.jsp。项目用JSP作为Servlet容器入口div idapp/div由Vue接管但若web.xml中welcome-file-list未设index.jspTomcat会默认找index.html即.bak文件。解决打开web/WEB-INF/web.xml确认welcome-file-list包含welcome-file-list welcome-fileindex.jsp/welcome-file /welcome-file-list若无则添加。同时删除web/index.html.bak避免干扰。4.2 现象登录后跳转/admin/index.jsp但页面显示404或空白原因admin/index.jsp依赖% include file/common/header.jsp%而/common/header.jsp中script src/static/js/vue.min.js/script路径错误。项目实际静态资源在/static/下但web.xml中servlet-mapping的url-pattern//url-pattern未排除/static/**导致请求被DispatcherServlet拦截找不到对应Controller。解决在spring-mvc.xml中添加资源放行配置mvc:resources mapping/static/** location/static/ / mvc:resources mapping/favicon.ico location/favicon.ico /并确保/static/js/vue.min.js文件真实存在检查web/static/js/目录。4.3 现象MySQL 8.0连接报错Public Key Retrieval is not allowed原因MySQL 8.0默认启用caching_sha2_password认证插件而项目用的mysql-connector-java 5.1.47驱动不支持需显式允许公钥检索。解决修改src/main/resources/jdbc.propertiesjdbc.urljdbc:mysql://localhost:3306/teaching_evaluation?useUnicodetruecharacterEncodingutf8serverTimezoneGMT%2B8allowPublicKeyRetrievaltrueuseSSLfalse关键是allowPublicKeyRetrievaltrueuseSSLfalse缺一不可。若用MySQL 5.7删掉这两项即可。4.4 现象2-run.bat执行mvn package报错Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.1:compile原因pom.xml中maven.compiler.source设为1.8但本地JDK是17Maven插件版本3.1太老不兼容高版本JDK。解决升级maven-compiler-plugin到3.8.1plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-compiler-plugin/artifactId version3.8.1/version configuration source1.8/source target1.8/target /configuration /plugin或直接在IDEA中设置File → Project Structure → Project → Project SDK选JDK 1.8Project language level选8。4.5 现象督导评价提交后t_supervision_record.status变为3但t_student_evaluation无数据原因SupervisionEvaluationService.java中saveSupervisionEvaluation()方法调用了studentEvaluationMapper.insert()但StudentEvaluation实体的studentId字段未赋值督导评价不关联具体学生而是对课程整体打分。解决查看SupervisionEvaluationDTO转换逻辑发现StudentEvaluation的studentId应设为null或0但MyBatis的insertSelective会忽略null值导致student_id为0违反外键约束t_student表无ID为0的记录。修正在SupervisionEvaluationService.java中明确设studentId为null并在StudentEvaluationMapper.xml的insertSelective中移除student_id字段的if判断改为固定插入NULLif teststudentId ! nullstudent_id,/if !-- 改为 -- student_id,并在values中写死NULLif teststudentId ! null#{studentId,jdbcTypeBIGINT},/if !-- 改为 -- NULL,5. 进阶技巧用3-build.bat定制化生成开题报告与论文PDF附LaTeX编译避坑清单5.1 开题报告Word版的自动化生成逻辑从doc/目录到可答辩文档项目附带的doc/开题报告.docx不是静态文件而是由3-build.bat调用Python脚本动态填充。该脚本读取src/main/resources/config/application.properties中的project.name、project.description等字段替换Word模板里的占位符如{{project_name}}。执行3-build.bat前需确保① 安装Python 3.7②pip install python-docx③doc/template.docx存在且含正确占位符。3-build.bat核心逻辑echo off echo 正在生成开题报告... python doc/generate_report.py if %errorlevel% equ 0 ( echo 开题报告生成成功位置doc/开题报告_自动生成.docx ) else ( echo [错误] 生成失败请检查Python环境 ) pausegenerate_report.py中关键代码from docx import Document import configparser config configparser.ConfigParser() config.read(src/main/resources/config/application.properties, encodingutf-8) doc Document(doc/template.docx) for para in doc.paragraphs: if {{project_name}} in para.text: para.text para.text.replace({{project_name}}, config.get(project, name)) # ... 其他字段替换 doc.save(doc/开题报告_自动生成.docx)注意application.properties中project.name基于SSM框架的在线教学质量评价系统若你修改项目名3-build.bat会自动同步到Word文档避免手动替换遗漏。5.2 毕业论文LaTeX源码编译全链路从.tex到PDF的四步验证法论文源码在doc/thesis/目录含main.tex主文件、chapters/各章节、figures/图表、references.bib参考文献。编译需用XeLaTeX引擎支持中文推荐TeX Live 2023。四步验证法①语法验证用VS Code LaTeX Workshop插件按CtrlAltB编译观察main.log末尾是否有Output written on main.pdf②图表验证figures/中PNG图片尺寸需≥300dpimain.tex中\includegraphics[width0.8\textwidth]{figures/system-architecture}的width参数确保不溢出③参考文献验证references.bib中article{zhang2020ssm}条目必须含author、title、journal、year字段否则bibtex main.aux会报I couldnt open database file references.bib④查重适配验证main.tex中\usepackage{ctex}已设fontsetfandol避免知网查重系统识别为乱码abstract段落用\begin{abstract}...\end{abstract}包裹而非普通段落。常见报错及修复! Package inputenc Error: Unicode character UFF08删除main.tex中全角括号改用半角()! Undefined control sequence \ctexset确认ctex宏包版本≥2.5执行tlmgr update ctex! Package hyperref Error: Wrong driver option在main.tex顶部\documentclass后加\PassOptionsToPackage{unicode}{hyperref}。5.3 从开题到答辩的文档一致性维护一个Excel表搞定所有引用我给自己建了个doc/文档一致性检查.xlsx三列文档位置如doc/开题报告.docx、引用字段如技术路线图、源文件如doc/figures/tech-route.png。每次修改tech-route.png就在此表中标记已更新并检查所有文档中该图是否同步。例如文档位置引用字段源文件状态doc/开题报告.docx技术路线图doc/figures/tech-route.png✅ 已更新doc/thesis/chapters/chapter3.tex系统架构图doc/figures/system-architecture.png⚠️ 待更新这样避免答辩前发现开题报告里的架构图还是旧版。从那以后我每次改完一张图都强制走一遍这个Excel表哪怕只花30秒——毕竟答辩老师放大PPT时图上那个错别字比代码bug更扎眼。希望帮到你。本文还有配套的精品资源点击获取 SSM+Vue在线教学质量评价系统实战部署与避坑指南
简介本资源是一套面向计算机专业本科生的毕业设计级在线教学质量评价系统基于SSMSpringSpringMVCMyBatis框架与MySQL构建适用于教育信息化场景下的教学过程数字化管理与多角色协同评价。资源包共913个文件涵盖143个Java后端逻辑类、52个Vue前端组件、156个JS交互脚本、92个JPG/GIF图片资源、2个SQL建库建表脚本及配套CSS、HTML、XML等完整支撑前后端分离架构压缩包大小23.93MB结构清晰含BreadCrumbs、IndexHeader等标准化Vue布局组件及install/run/build批处理脚本开箱即用。已有174人学习下载提供可直接运行的Eclipse/IDEA工程、数据库脚本、开题报告与毕业论文全文覆盖管理员、教师、督导三类角色权限体系支持学生评教、督导听课、课程管理、数据统计报表等全流程功能是实践SSMVue全栈开发与教育类系统设计的优质教学案例。1. 这不是又一个“学生打分表”SSMVue在线教学质量评价系统真能跑通督导听课闭环你见过多少个毕设项目部署到Tomcat里报404、登录页空白、饼图不渲染、MySQL连不上就直接放弃这个基于SSMSpringSpringMVCMyBatisVue的在线教学质量评价系统不是PPT里的架构图而是我亲手在IDEA 2023.2 MySQL 8.0.33 JDK 17环境下从.bat脚本一路跑通的真实工程——它把“督导申请听课→教师确认→课堂观察→多维度打分→生成统计报表→自动推送通知”这条高校教务管理中最容易断链的业务流用可调试、可修改、可扩展的代码串起来了。它不只含源码还带开题报告Word版含研究背景、技术选型对比、可行性分析、毕业论文LaTeX源码含查重率说明、系统测试用例表、UML类图与时序图Visio源文件甚至1-install.bat里预埋了建库语句和初始管理员账号。适合计算机/教育技术专业本科生做毕设也适合刚转Java后端的新手练手它没用Spring Boot自动装配黑盒所有Bean配置明明白白写在spring-context.xml里它没堆砌Vue3 Composition API炫技而是用Vue2Element UI实现响应式表格与弹窗改个字段名就能对应到MyBatis的resultMap它数据库设计踩过真实教务场景的坑——比如“学生评价”表里course_id和teacher_id必须联合唯一否则同一学生对同一课程重复提交会覆盖历史记录。别被“教学质量评价”这名字劝退它的价值不在名字而在StudentEvaluationController.java里那个被注释掉的Transactional(rollbackFor Exception.class)——那是我第三次重启Tomcat才发现的事务漏写点。2. 从.bat脚本到首页渲染SSMVue项目启动全流程拆解2.1 为什么先执行1-install.bat而不是直接mvn clean install这个项目的构建逻辑是反常规的它没走Maven标准生命周期打包WAR而是用批处理脚本接管环境初始化。1-install.bat本质是Windows下的“一键环境准备器”它干三件事① 检查mysql.exe是否在PATH中通过where mysql若未找到则提示“请先安装MySQL并配置环境变量”② 执行mysql -u root -p db/teaching_evaluation.sql导入数据库注意密码交互式输入脚本不会硬编码密码③ 创建webapps/ROOT目录并复制target/teaching-evaluation.war解压后的内容该WAR由2-run.bat触发Maven打包生成。提示teaching_evaluation.sql脚本里包含CREATE DATABASE IF NOT EXISTS teaching_evaluation DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;但没创建用户。你必须手动执行CREATE USER teach_userlocalhost IDENTIFIED BY Teach123; GRANT ALL ON teaching_evaluation.* TO teach_userlocalhost;否则jdbc.properties里的连接会失败。这是项目文档里没写的隐性依赖。# 1-install.bat 关键片段已去敏感信息 echo off echo 正在检查MySQL环境... where mysql nul 21 if %errorlevel% neq 0 ( echo [错误] MySQL未安装或未配置环境变量 pause exit /b 1 ) echo 正在导入数据库... mysql -u root -p db\teaching_evaluation.sql if %errorlevel% equ 0 ( echo 数据库导入成功 ) else ( echo [警告] 数据库导入可能失败请检查root密码是否正确 )这段批处理的逻辑是先确保MySQL可用再导入SQL。它比IDEA里右键Run As → Maven build更贴近真实部署场景——因为高校机房服务器往往禁用Maven中央仓库而.bat脚本能离线运行。如果你用Linux需将1-install.sh中mysql -u root -p改为mysql -u root -pyour_password注意引号包裹密码避免shell特殊字符解析错误并赋予chmod x权限。2.22-run.bat背后的Maven打包真相WAR包结构与Tomcat部署细节2-run.bat执行mvn clean package -Dmaven.test.skiptrue后生成的target/teaching-evaluation.war不是标准Spring Boot Fat Jar而是传统Servlet WAR包。解压它你会看到/WEB-INF/web.xml声明DispatcherServlet和CharacterEncodingFilterload-on-startup1/load-on-startup确保Spring MVC容器优先加载/WEB-INF/classes/含spring-mvc.xml配置Controller扫描路径、spring-context.xml配置Service层事务与MyBatisSqlSessionFactoryBean、jdbc.properties数据库连接参数/WEB-INF/lib/mybatis-3.4.6.jar、spring-jdbc-5.0.9.RELEASE.jar等JAR版本锁定在pom.xml的properties里避免Spring 5.x与MyBatis 3.5的兼容问题/static/存放index.html.bak原始HTML模板、css/、js/含vue.min.js2.6.14/views/login.jsp、admin/index.jsp等JSP页面但实际前端由Vue接管——index.jsp里只有一行div idapp/div所有路由由router/index.js控制。关键点在于web.xml中servlet-mapping的url-pattern//url-pattern它让所有请求包括/api/xxx都经过DispatcherServlet再由Spring MVC的RequestMapping匹配。而Vue Router的mode: history依赖此配置否则刷新页面会404。如果你用Tomcat 9需确认conf/web.xml里servlet-namedefault/servlet-name的url-pattern//url-pattern未被覆盖否则静态资源如/static/js/app.js无法访问。2.3 前端Vue如何与SSM后端通信跨域、Token传递与接口约定项目前端用Vue 2.6 axios但没配代理。所有API请求直连http://localhost:8080/api/xxx这意味着开发时必须解决跨域。解决方案藏在spring-mvc.xml里mvc:cors mvc:mapping path/api/** allowed-origins* allow-credentialstrue max-age3600/ /mvc:cors这段配置启用Spring MVC CORS支持允许任意来源携带Cookie访问/api/**路径。而axios实例在src/utils/request.js中设置了withCredentials: true确保登录态JSESSIONID随请求发送// src/utils/request.js const service axios.create({ baseURL: /api, // 注意这里用相对路径避免硬编码localhost:8080 timeout: 5000, withCredentials: true // 关键让浏览器发送Cookie })后端Controller方法用ResponseBody返回JSON如StudentEvaluationController.java中的RequestMapping(value /student/evaluate, method RequestMethod.POST) ResponseBody public ResultVO evaluate(RequestBody StudentEvaluationDTO dto, HttpServletRequest request) { // dto包含courseId, teacherId, score, comment等字段 // request.getSession().getAttribute(userId) 获取当前登录用户ID return ResultVO.success(evaluationService.saveEvaluation(dto)); }这里RequestBody自动将Vue传来的JSON解析为StudentEvaluationDTO对象而request.getSession()获取Session中的用户信息——不是JWT Token是传统Session机制。所以前端登录成功后无需存Token后续所有请求自动携带JSESSIONID Cookie。这也是为什么IndexHeader.vue.bak里logout()方法只需调用/api/logout接口服务端执行session.invalidate()即可。3. 数据库设计与MyBatis映射教务场景下的三张核心表深度解析3.1t_course、t_teacher、t_student_evaluation为什么用联合主键而非自增ID教务系统最怕数据错位。看t_student_evaluation表结构CREATE TABLE t_student_evaluation ( id bigint(20) NOT NULL AUTO_INCREMENT, student_id bigint(20) NOT NULL COMMENT 学生ID, course_id bigint(20) NOT NULL COMMENT 课程ID, teacher_id bigint(20) NOT NULL COMMENT 教师ID, score int(11) NOT NULL DEFAULT 0 COMMENT 总分, comment text COMMENT 评语, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_student_course_teacher (student_id,course_id,teacher_id) USING BTREE ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生评价表;表面看id是主键但真正防重复的关键是联合唯一索引uk_student_course_teacher。原因一个学生对同一门课的同一个任课教师只能评价一次。如果用自增ID做主键INSERT IGNORE或ON DUPLICATE KEY UPDATE会因id不同而插入新记录导致数据污染。而联合索引强制约束INSERT INTO t_student_evaluation (student_id,course_id,teacher_id,score) VALUES (1001,2001,3001,85)第二次执行会报Duplicate entry 1001-2001-3001 for key uk_student_course_teacher前端捕获此异常即可提示“您已评价过该课程”。MyBatis的StudentEvaluationMapper.xml里insertSelective方法没设useGeneratedKeystrue因为id是自增但业务逻辑不依赖它insert idinsertSelective parameterTypecom.example.entity.StudentEvaluation insert into t_student_evaluation trim prefix( suffix) suffixOverrides, if teststudentId ! nullstudent_id,/if if testcourseId ! nullcourse_id,/if if testteacherId ! nullteacher_id,/if if testscore ! nullscore,/if if testcomment ! nullcomment,/if /trim trim prefixvalues ( suffix) suffixOverrides, if teststudentId ! null#{studentId,jdbcTypeBIGINT},/if if testcourseId ! null#{courseId,jdbcTypeBIGINT},/if if testteacherId ! null#{teacherId,jdbcTypeBIGINT},/if if testscore ! null#{score,jdbcTypeINTEGER},/if if testcomment ! null#{comment,jdbcTypeLONGVARCHAR},/if /trim /insert注意if标签的判空逻辑studentId、courseId、teacherId必填score和comment可为空允许只打分不写评语这符合实际教学评价场景。3.2t_supervision_record表的设计陷阱督导听课状态机与时间戳校验督导听课流程有严格状态流转申请中(0)→已确认(1)→已听课(2)→已评价(3)。t_supervision_record表用status字段tinyint表示但仅靠数据库约束不够。看SupervisionRecordService.java里的confirmRecord()方法Transactional(rollbackFor Exception.class) public void confirmRecord(Long recordId, Long teacherId) { SupervisionRecord record supervisionRecordMapper.selectByPrimaryKey(recordId); if (!Objects.equals(record.getStatus(), 0)) { throw new BusinessException(该听课记录状态非【申请中】无法确认); } if (!Objects.equals(record.getTeacherId(), teacherId)) { throw new BusinessException(确认人不是该记录指定教师); } // 校验时间申请时间不能晚于当前时间 if (record.getApplyTime().after(new Date())) { throw new BusinessException(申请时间不能晚于当前时间); } record.setStatus((byte) 1); record.setConfirmTime(new Date()); supervisionRecordMapper.updateByPrimaryKeySelective(record); }这里三个校验缺一不可① 状态校验防止重复确认② 教师ID校验避免督导误点其他教师的记录③ 时间校验applyTime必须≤当前时间否则new Date()生成的confirmTime会早于applyTime违反业务逻辑。而teaching_evaluation.sql里t_supervision_record的apply_time字段定义为datetime DEFAULT CURRENT_TIMESTAMP但没设ON UPDATE CURRENT_TIMESTAMP——这意味着apply_time只在INSERT时赋值UPDATE时不变保证时间戳可信。3.3 MyBatis动态SQL实战学生评价统计报表的饼图数据组装StudentEvaluationController.java的getEvaluationStats()方法返回饼图所需数据其SQL在StudentEvaluationMapper.xml中用foreach动态拼接select idgetEvaluationStats resultTypecom.example.vo.EvaluationStatVO SELECT CASE WHEN score 90 THEN 优秀 WHEN score 80 THEN 良好 WHEN score 70 THEN 中等 WHEN score 60 THEN 合格 ELSE 不合格 END AS level, COUNT(*) AS count FROM t_student_evaluation WHERE course_id #{courseId} GROUP BY CASE WHEN score 90 THEN 优秀 WHEN score 80 THEN 良好 WHEN score 70 THEN 中等 WHEN score 60 THEN 合格 ELSE 不合格 END ORDER BY FIELD(level, 优秀,良好,中等,合格,不合格) /select注意ORDER BY FIELD()用法MySQL特有函数按指定顺序排序确保饼图图例从高到低排列。而EvaluationStatVO类的level和count字段被Vue组件StudentEvaluationChart.vue直接绑定到ECharts的series.data// StudentEvaluationChart.vue this.$http.get(/api/student/evaluation/stats?courseId${this.courseId}).then(res { this.chartData res.data.map(item ({ name: item.level, value: item.count })) })这里没用if判断courseId是否为空因为Controller层已用RequestParam(required true)强制校验避免SQL注入风险。4. 避坑指南SSMVue项目启动与功能验证的五个血泪经验4.1 现象首页index.html.bak打开是纯HTMLVue组件不渲染原因index.html.bak是备份文件真正入口是index.jsp。项目用JSP作为Servlet容器入口div idapp/div由Vue接管但若web.xml中welcome-file-list未设index.jspTomcat会默认找index.html即.bak文件。解决打开web/WEB-INF/web.xml确认welcome-file-list包含welcome-file-list welcome-fileindex.jsp/welcome-file /welcome-file-list若无则添加。同时删除web/index.html.bak避免干扰。4.2 现象登录后跳转/admin/index.jsp但页面显示404或空白原因admin/index.jsp依赖% include file/common/header.jsp%而/common/header.jsp中script src/static/js/vue.min.js/script路径错误。项目实际静态资源在/static/下但web.xml中servlet-mapping的url-pattern//url-pattern未排除/static/**导致请求被DispatcherServlet拦截找不到对应Controller。解决在spring-mvc.xml中添加资源放行配置mvc:resources mapping/static/** location/static/ / mvc:resources mapping/favicon.ico location/favicon.ico /并确保/static/js/vue.min.js文件真实存在检查web/static/js/目录。4.3 现象MySQL 8.0连接报错Public Key Retrieval is not allowed原因MySQL 8.0默认启用caching_sha2_password认证插件而项目用的mysql-connector-java 5.1.47驱动不支持需显式允许公钥检索。解决修改src/main/resources/jdbc.propertiesjdbc.urljdbc:mysql://localhost:3306/teaching_evaluation?useUnicodetruecharacterEncodingutf8serverTimezoneGMT%2B8allowPublicKeyRetrievaltrueuseSSLfalse关键是allowPublicKeyRetrievaltrueuseSSLfalse缺一不可。若用MySQL 5.7删掉这两项即可。4.4 现象2-run.bat执行mvn package报错Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.1:compile原因pom.xml中maven.compiler.source设为1.8但本地JDK是17Maven插件版本3.1太老不兼容高版本JDK。解决升级maven-compiler-plugin到3.8.1plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-compiler-plugin/artifactId version3.8.1/version configuration source1.8/source target1.8/target /configuration /plugin或直接在IDEA中设置File → Project Structure → Project → Project SDK选JDK 1.8Project language level选8。4.5 现象督导评价提交后t_supervision_record.status变为3但t_student_evaluation无数据原因SupervisionEvaluationService.java中saveSupervisionEvaluation()方法调用了studentEvaluationMapper.insert()但StudentEvaluation实体的studentId字段未赋值督导评价不关联具体学生而是对课程整体打分。解决查看SupervisionEvaluationDTO转换逻辑发现StudentEvaluation的studentId应设为null或0但MyBatis的insertSelective会忽略null值导致student_id为0违反外键约束t_student表无ID为0的记录。修正在SupervisionEvaluationService.java中明确设studentId为null并在StudentEvaluationMapper.xml的insertSelective中移除student_id字段的if判断改为固定插入NULLif teststudentId ! nullstudent_id,/if !-- 改为 -- student_id,并在values中写死NULLif teststudentId ! null#{studentId,jdbcTypeBIGINT},/if !-- 改为 -- NULL,5. 进阶技巧用3-build.bat定制化生成开题报告与论文PDF附LaTeX编译避坑清单5.1 开题报告Word版的自动化生成逻辑从doc/目录到可答辩文档项目附带的doc/开题报告.docx不是静态文件而是由3-build.bat调用Python脚本动态填充。该脚本读取src/main/resources/config/application.properties中的project.name、project.description等字段替换Word模板里的占位符如{{project_name}}。执行3-build.bat前需确保① 安装Python 3.7②pip install python-docx③doc/template.docx存在且含正确占位符。3-build.bat核心逻辑echo off echo 正在生成开题报告... python doc/generate_report.py if %errorlevel% equ 0 ( echo 开题报告生成成功位置doc/开题报告_自动生成.docx ) else ( echo [错误] 生成失败请检查Python环境 ) pausegenerate_report.py中关键代码from docx import Document import configparser config configparser.ConfigParser() config.read(src/main/resources/config/application.properties, encodingutf-8) doc Document(doc/template.docx) for para in doc.paragraphs: if {{project_name}} in para.text: para.text para.text.replace({{project_name}}, config.get(project, name)) # ... 其他字段替换 doc.save(doc/开题报告_自动生成.docx)注意application.properties中project.name基于SSM框架的在线教学质量评价系统若你修改项目名3-build.bat会自动同步到Word文档避免手动替换遗漏。5.2 毕业论文LaTeX源码编译全链路从.tex到PDF的四步验证法论文源码在doc/thesis/目录含main.tex主文件、chapters/各章节、figures/图表、references.bib参考文献。编译需用XeLaTeX引擎支持中文推荐TeX Live 2023。四步验证法①语法验证用VS Code LaTeX Workshop插件按CtrlAltB编译观察main.log末尾是否有Output written on main.pdf②图表验证figures/中PNG图片尺寸需≥300dpimain.tex中\includegraphics[width0.8\textwidth]{figures/system-architecture}的width参数确保不溢出③参考文献验证references.bib中article{zhang2020ssm}条目必须含author、title、journal、year字段否则bibtex main.aux会报I couldnt open database file references.bib④查重适配验证main.tex中\usepackage{ctex}已设fontsetfandol避免知网查重系统识别为乱码abstract段落用\begin{abstract}...\end{abstract}包裹而非普通段落。常见报错及修复! Package inputenc Error: Unicode character UFF08删除main.tex中全角括号改用半角()! Undefined control sequence \ctexset确认ctex宏包版本≥2.5执行tlmgr update ctex! Package hyperref Error: Wrong driver option在main.tex顶部\documentclass后加\PassOptionsToPackage{unicode}{hyperref}。5.3 从开题到答辩的文档一致性维护一个Excel表搞定所有引用我给自己建了个doc/文档一致性检查.xlsx三列文档位置如doc/开题报告.docx、引用字段如技术路线图、源文件如doc/figures/tech-route.png。每次修改tech-route.png就在此表中标记已更新并检查所有文档中该图是否同步。例如文档位置引用字段源文件状态doc/开题报告.docx技术路线图doc/figures/tech-route.png✅ 已更新doc/thesis/chapters/chapter3.tex系统架构图doc/figures/system-architecture.png⚠️ 待更新这样避免答辩前发现开题报告里的架构图还是旧版。从那以后我每次改完一张图都强制走一遍这个Excel表哪怕只花30秒——毕竟答辩老师放大PPT时图上那个错别字比代码bug更扎眼。希望帮到你。本文还有配套的精品资源点击获取