每到期末学生课程评价就成了一件让人头疼的事情。发问卷星链接、打印纸质问卷、让学生口头反馈这几种方式我都试过要么收发不齐、要么数据统计费劲、要么学生敷衍填写。后来做课程设计的时候我花了一个周末整理出一套用 Spring Boot 写好的学生课程评价系统源码包编号 24438。这套系统平时就放在本地项目库里结构很规整学生端能匿名评课教师端能看到自己授课的评价汇总管理员端管全校的用户、课程、评价指标和统计数据。如果你正在找 Spring Boot 的实战课题、毕设参考或者想给学校/培训机构做一套轻量评价工具这套思路可以直接拿来用。这篇文章不是把文档翻译一遍我会从需求和功能边界讲起再拆数据库设计、核心实现、典型踩坑最后说怎么把这套源码改造成你自己的项目。中间所有代码和配置都来自我实际调试过的版本照着动手基本不会卡壳。1. 评价系统要解决的痛点与功能边界1.1 课程评价到底在评什么我刚拿到这个需求的时候第一反应是这不就是一张打分表加一个查询页面吗真正梳理完之后发现难点不在页面而在评价对象、评价维度和角色权限的平衡。课程评价系统一般围绕三个要素展开评价主体学生。学生对自己上过的课程进行评价。评价客体课程和授课教师。评价的是老师的教学组织、课堂效果、课程内容等。评价管理者教务处或管理员。负责维护基础数据、查看整体统计。评价指标不是随便写的。项目里默认设计了两层结构一类是综合分析项比如教师备课是否充分课堂互动是否有效课程内容是否实用另一类是总体评分一般用 1-5 星或者百分制最后形成一个综合评价等级优秀/良好/合格/不合格。这套系统的核心价值就是把过去分散在纸质问卷和在线表格里的评价数据变成一个闭环管理员设置评价指标 - 学生登录后对指定课程匿名打分 - 教师查看自己课程的评价汇总 - 管理员导出全校数据做分析。整个链条下来课程评价才不是评完就完了而是确实能回传给教学环节。1.2 三种角色三条主流程我在整理源码时发现项目把用户角色分得比较清楚这也是学生课程评价系统和一般 CRUD 项目最大的区别所在。三种角色对应三条完全不同的流程。学生端登录后看到自己待评价的课程列表每门课程可以进行一次评价。评价内容包括多个指标打分和一段文字评语。提交后不可修改但可以查看自己的历史评价记录。教师端登录后只能看到与当前教师关联的课程以及每门课程的评价结果汇总包括平均分、各指标得分、评价人数、评语列表。注意教师端有意隐藏了学生的身份信息和提交时间目的就是让学生敢说真话。管理员端拥有全部权限包括学生管理、教师管理、课程管理、班级管理、评价指标管理、系统评价数据管理以及基础数据统计和用户密码重置。三套流程对应三套菜单和三个拦截级别。这个设计在源码里是通过一套统一的用户表加角色字段实现的没有刻意上 Spring Security 那套复杂机制后面我会详细说明为什么。1.3 为什么不建议在原型阶段堆权限框架很多人在 GitHub 上找项目看到没集成 Spring Security 或者 Shiro 就觉得不专业。我的经验是像课程评价这种偏教学管理的系统核心业务是评价流程不重不漏、统计口径正确权限往往只有三种固定角色用拦截器加 Session 完全可以覆盖。源码里我保留了 WebConfig 和 LoginInterceptor 两个类来实现角色控制静态资源和登录放行需要用户身份的判断 Session 里是否存在 user 对象需要管理员角色的再判断 user.role ADMIN。这种做法的好处是代码直观、出问题时定位非常快对于课程设计和中小规模真实项目完全够用。如果你后面确实需要按钮级权限、操作日志审计再升级到 Spring Security 也不迟。2. 技术选型与跑通前提2.1 技术栈拆解项目用的是一套非常经典的 Spring Boot 组合没有花哨的组件却能把所有需求覆盖到位。我把技术栈整理成了下面这个表格方便你对照自己的环境。模块选型说明后端框架Spring Boot 2.7.x稳定版本三件套依赖齐全JDK 8/11 都能跑ORM 框架MyBatis-Plus少写大量 SQL分页和条件查询非常省事数据库MySQL 5.7 / 8.0实际用的 8.0UTF-8 编码模板引擎Thymeleaf配合 Bootstrap 渲染管理后台复用 HTML 片段前端 UIBootstrap jQuery不用构建工具直接可用适合中小后台权限控制拦截器 Session简单可靠便于二次开发理解选 Thymeleaf 而不选前后端分离是我反复权衡后的决定。学生课程评价系统的页面多数是表单和表格服务端渲染意味着不用处理跨域、不用维护两套部署一个 Spring Boot 应用打成一个 jar 就能跑。如果你是新手或者做毕设这个方案能让你把精力集中在后端逻辑上。2.2 环境准备清单我自己在全新电脑上按下面的清单装环境基本没有出现额外问题JDK建议先装 JDK 8Spring Boot 2.7 对它支持最稳。Maven版本 3.6要确保 settings.xml 里用的是国内镜像否则首次拉依赖可能等到怀疑人生。MySQL安装时可先把 root 密码设置简单一点比如 root/123456后面改配置更省事。IDEIDEA 社区版或专业版都可以社区版也能正常启动 Spring Boot 项目。数据库工具Navicat 或 DataGrip主要用来执行初始化 SQL 和查看数据。这套源码自带的 sql 文件我已经验证过直接导入即可生成数据库和基础测试数据。初始化脚本里包含一个默认管理员账号和几门示例课程方便第一次启动就能看到完整效果。2.3 项目结构速览拿到源码包之后第一步不是急着写代码而是先看包结构。源码包 24438 的目录结构如下src/main/java/com/eval/ ├── config/ // 拦截器与 WebMvc 配置 ├── controller/ // 学生、教师、管理员、登录控制器 ├── entity/ // 实体类 ├── mapper/ // MyBatis-Plus 数据访问层接口 ├── service/ // 业务逻辑层接口与实现 └── utils/ // 登录校验、结果返回等工具类 src/main/resources/ ├── mapper/ // XML 自定义 SQL ├── static/ // Bootstrap、CSS、JS、图片 ├── templates/ // Thymeleaf 页面模板 └── application.yml这套分层是 Spring Boot 项目的标准写法Controller 只做参数接收和视图跳转Service 写业务逻辑Mapper 负责数据库操作。看起来平平无奇但好处是改起来心里特别有底比如后面我想加一个按学院统计评价情况的功能只需要在 Mapper 增加一条聚合 SQL不用动 Controller。3. 核心功能实现从建表到评价闭环3.1 数据库设计五张表撑起整套系统我在另一个项目里见过把评价功能做成二十多张表的结果大部分表都在闲置。这套学生课程评价系统比较务实核心表用五张就够。表名作用关键字段sys_user统一登录用户id, username, password, role, nameteacher教师信息id, user_id, teacher_no, title, departmentstudent学生信息id, user_id, student_no, class_name, majorcourse课程信息id, course_name, teacher_id, semester, statusevaluation_item评价指标id, item_name, item_type, sortevaluation_record评价记录id, course_id, student_id, score, comment, create_time这里最关键的联动关系是course 表通过 teacher_id 关联教师evaluation_record 表通过 course_id 和 student_id 关联课程与学生。评价指标表单独抽出来是为了让管理员可以不写代码、直接在页面上增删评价维度。建表时有个细节容易被忽略evaluation_record 表里对 course_id 和 student_id 建了唯一索引这是防止同一个学生对同一门课重复提交的最后一道防线。ALTER TABLE evaluation_record ADD UNIQUE KEY uk_course_student (course_id, student_id);3.2 匿名评价防重复提交的核心逻辑学生提交评价这个动作看起来只是往表里插一条记录实际要处理三个问题是否登录、课程是否属于该学生、是否已经评价过。前两个问题在控制器里检查第三个问题必须在服务层和数据库同时设防。我在 ServiceImpl 里是这样处理的Override public boolean submitEvaluation(EvaluationRecord record) { Long courseId record.getCourseId(); Long studentId record.getStudentId(); // 1. 查询已存在记录 Long count evaluationRecordMapper.selectCount( new LambdaQueryWrapperEvaluationRecord() .eq(EvaluationRecord::getCourseId, courseId) .eq(EvaluationRecord::getStudentId, studentId)); if (count 0) { return false; // 已评价拒绝重复提交 } // 2. 插入记录 int rows evaluationRecordMapper.insert(record); return rows 1; }这个方法单独看不复杂但要注意两点第一count 查询和 insert 之间存在并发窗口。在真实场景下两个页面同时提交的可能性不大但为了稳妥数据库的唯一索引仍然保留了。一旦发生极端情况insert 会抛 DuplicateKeyException我一般在 Controller 层做一次异常捕获提示该课程已评价。第二接口层面不能只依赖隐藏按钮。有的学生会退到上一页重新提交所以 Controller 里即使通过了页面判断Service 层仍然要重新校验一遍。这也是我习惯把校验逻辑下沉到 Service 而不是只写在 Controller 的原因。3.3 评价统计口径与报表计算教师端最关心的不是一条条评价明细而是我这门课到底评了多少人、平均多少分、哪一项得分最低。这部分统计我全部放在 Mapper 的 XML 里用 SQL 聚合比在 Java 里循环求和高效得多。以教师查看某门课程评价汇总为例select idselectEvalSummaryByCourse resultTypemap SELECT COUNT(DISTINCT student_id) AS studentCount, ROUND(AVG(score), 2) AS avgScore, SUM(CASE WHEN score 4.5 THEN 1 ELSE 0 END) AS excellentCount, SUM(CASE WHEN score 4.0 AND score 4.5 THEN 1 ELSE 0 END) AS goodCount, SUM(CASE WHEN score 4.0 THEN 1 ELSE 0 END) AS normalCount FROM evaluation_record WHERE course_id #{courseId} /select管理员端还要看全校整体情况我会在 course 和 teacher 上做一次多表连接按教师维度统计平均分和参与率SELECT t.name AS teacherName, c.id AS courseId, c.course_name AS courseName, COUNT(r.id) AS evalCount, ROUND(AVG(r.score), 2) AS avgScore FROM course c LEFT JOIN teacher t ON c.teacher_id t.id LEFT JOIN evaluation_record r ON r.course_id c.id GROUP BY c.id, t.name, c.course_name ORDER BY avgScore DESC;统计口径需要保持一致平均分到底取所有评分的算术平均还是先按指标算平均再合成我在源码里统一采用所有学生的课程总体评分直接求平均作为主口径各项指标得分单独存列、单独统计。这样主统计和明细拆分的推导逻辑就一致了不容易出现总分平均值和各指标平均值对不上的情况。3.4 管理员的评价指标维护评价指标为什么单独设计成一张表因为如果指标是写死在页面里的管理员每次调整都要改代码、重启服务。现在把指标放进表里再配一个简单的列表增删改查页面管理员就能自己维护。指标表的关键字段是 item_name、item_type 和 sort。item_type 用来区分综合分析项还是文本评语项sort 控制展示顺序。学生提交页面遍历这些指标动态渲染评分控件数据驱动页面代码量少而且灵活。4. 实测运行中的几个坑从配置到调试4.1 首次启动的数据库连接配置这套源码的 application.yml 是我按 MySQL 8.0 调的配置如下server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/eval_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false mode: HTML我在这里踩过两个新手高频问题。第一个是时区问题如果 url 里不加 serverTimezoneAsia/ShanghaiMySQL 8 会报 CST 时区识别错误。第二个是 allowPublicKeyRetrievaltrueMySQL 8 默认的认证插件在首次连接时需要获取公钥有些环境不加这个参数会一直报连接失败。如果你用 MySQL 5.7驱动可以换成 com.mysql.jdbc.Driverurl 里基本只要编码参数就够。4.2 Thymeleaf 模板渲染的常见问题项目里所有后台页面都用 Thymeleaf 模板。前端页面动态渲染时我遇到的典型报错是表达式类型转换问题。比如评价记录的 score 字段是 BigDecimal页面里直接比较th:block th:if${record.score 4.5} span classlabel label-success优秀/span /th:block这种情况下 Thymeleaf 的数值比较是按对象类型走的 score 是 BigDecimal4.5 是 BigDecimal 也行但如果你写成 4类型就不匹配可能会产生意外结果。更稳的做法是在实体里加一个计算好的评级字段由后端统一返回前端只负责展示。另一个容易被忽略的是模板文件放在 templates 目录下页面中静态资源要使用 th:href{/css/app.css} 而不是传统的 /css/app.css。如果少了 Thymeleaf 的地址语法页面会报 404但控制台不一定有明显报错。开发时建议把 thymeleaf.cache 设置为 false否则改完 HTML 必须重启服务才能看到效果。我第一次跑这个项目的时候没关缓存改了个按钮文案硬是重启了七八次才意识到问题所在。4.3 课程状态与评价周期的设计底线学生能评价哪些课程源码里用 course 表的 status 字段控制1 表示正在进行、0 表示已结束。学生端列表只查询 status1 的课程。但这个设计有一个隐患评价周期和教学计划是两套体系同一个学期可能有补考、重修课程结束时间并不统一。我的建议是在 course 表再加两个字段evaluation_start 和 evaluation_end或者一个 semester 字段。查询待评价课程时用当前时间和起止时间做范围过滤LocalDate today LocalDate.now(); LambdaQueryWrapperCourse wrapper new LambdaQueryWrapper(); wrapper.eq(Course::getStatus, 1) .le(Course::getEvaluationStart, today) .ge(Course::getEvaluationEnd, today);页面里也要对应提示该课程当前不在评价周期内。这个细节能避免学生在课程结束后还收到评价提醒也能避免期末集中补评时数据混乱。4.4 拦截器里 Session 状态跳转的边界问题登录拦截器的写法本身不难麻烦的是拦截范围。如果不小心把静态资源也拦截了页面 CSS 和 JS 全被挡在外面界面会变得一塌糊涂而且很难看出原因。我的 WebConfig 里把静态资源和放行路径都处理好了Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/**) .excludePathPatterns( /, /login, /register, /css/**, /js/**, /images/**, /error ); }LoginInterceptor 里我按 role 做了三级判断不是简单判断有没有登录。因为学生访问教师页面、教师访问管理员页面都应该是被拒绝的而不是放行后又在页面里暴露权限按钮。这里我用了一个简单的工具方法从 Session 取出 user 对象再比对 role不匹配就重定向到对应角色的首页。这样做有个额外好处如果后面新增了督导角色只需要在拦截器里加一条判断不用改其他逻辑。5. 把源码变成你自己的项目——从部署到二次开发5.1 本地快速启动的完整步骤拿到源码包 24438 之后我建议按以下顺序操作新建数据库 eval_system字符集选择 utf8mb4。导入项目根目录的 eval_system.sql 文件。这一步会自动建表和插入管理员账号、示例数据。修改 application.yml 中的数据库用户名和密码确认端口未被占用。在 IDEA 中打开项目等待 Maven 下载依赖完成后运行 EvalApplication 主类。浏览器访问 http://localhost:8080使用管理员账号 admin/admin123 登录。启动过程中最常见的失败原因是端口占用或依赖下载超时。端口占用可以通过netstat -ano | findstr 8080查看进程号并结束依赖下载超时则建议检查 Maven 镜像是否为阿里云或腾讯云。登录之后建议先走一遍管理员流程新建一位教师、新建一门课程并把教师和班级关联进去再创建一个学生账号。用学生账号登录看到课程列表后提交一次评价然后再切回教师账号查看汇总。这个流程走通说明整个评价闭环在你的环境里就没有问题了。5.2 低成本定制字段、指标、主题很多同学拿源码后最想改的是看起来和别人的不一样。这里分享三个性价比最高的定制方向。第一个是评价指标定制。不需要改代码管理员登录后在评价指标管理里新增一条记录比如课程思政融入度设置好排序和类型。学生端页面会自动多出一个评分项统计页面也会包含该维度的平均值。这就是数据驱动页面的好处。第二个是课程字段扩展。如果你想增加课程性质必修/选修或者上课时间星期一第1-2节直接在 course 表加字段对应实体类补属性再在课程管理表单里加一个 input整体改动量在 30 分钟左右。第三个是前端主题。项目用的 Bootstrap 3整体风格偏后台管理系统。想快速换风格可以下载一套 Bootstrap 主题的 CSS 文件替换 static/css 下的文件页面结构基本不用动。想用 Layui、Tailwind 或者其他框架则需要修改 templates 里的公共 head 片段工作量稍大但完全可行。5.3 进阶方向Minio 附件、Excel 导出、前后端分离如果你不满足于基础功能想把这个项目作为进阶练手我推荐三个方向。第一个是接入 Minio 做附件存储。Minio 是一个轻量对象存储服务配合 spring-boot-starter-data-redis 和 Minio Java SDK可以实现学生上传图片评价截图、教师上传课件附件、管理员批量导入学生名册等功能。做法是引入 minio 依赖在配置类里注册 MinioClient Bean然后在 Controller 里写上传接口返回文件访问链接并保存到数据库。第二个是 Excel 导出。管理者往往需要把评价数据导出给教务或存档。用 EasyExcel 或 Apache POI 都可以我建议用 EasyExcel代码简单得多。只需要写一个导出 Controller从 Mapper 查询统计数据设置表头然后输出到 HttpServletResponse 即可。这个功能上线频率高、实用价值大非常适合作为二次开发的第一个练习。第三个是前后端分离改造。如果你已经熟悉 Vue 和 Spring Boot可以把这套系统的后端 RESTful 化Controller 统一返回 JSON前端用 Vue Router 和 Axios 对接。改造的关键在于权限部分之前用 Session 的地方需要换成 Token。好在系统角色固定登录接口只需要生成一个包含 userId 和 role 的 Token前端每次请求带上并在拦截器里解析改造难度其实可控。5.4 给初次接触源码的人一点建议我自己整理这套源码时最大的体会是真正有价值的往往不是代码本身而是在代码里体现出来的判断力。比如为什么不把评价指标直接写死在枚举里因为这样虽然代码更简单但管理员每次调整都要依赖开发人员系统失去了独立运营的能力。为什么要给评价表加唯一索引因为业务上一学生一课程一评价是不可动摇的规则不能完全依赖程序判断。为什么教师端不显示学生姓名和提交时间因为匿名是保证评价真实性的基础一旦泄露身份整个评价数据就可能失真。这些设计取舍才是课程评价系统区别于普通 CRUD 项目的精华所在。我用 Spring Boot 做过不少管理系统CRUD 写多了会觉得千篇一律但评价系统有一点很特别它同时涉及流程控制、数据统计、角色权限和匿名机制每个环节都有真实业务约束。源码 24438 本身是我在课程设计中反复修改后的版本各模块边界清晰适合作为你第一次完整跑通的 Spring Boot 项目也适合在此基础上加入自己的功能创意。如果你准备拿它做毕设建议重点讲清楚如何用数据驱动评价指标的动态配置和如何保证评价数据的真实性与唯一性这两点这两个问题在答辩时往往是评委最关心的。最后提醒一句跑项目之前记得先导入 SQL 文件并且看清楚 application.yml 里的端口、用户名和密码。我见过太多人改了半小时代码、结果连数据库都没连上。把环境跑通之后再去体验学生端提交评价和教师端查看统计的完整流程你会对这套系统有更直观的感受。