先讲个我自己的经历。之前接了一个实验室管理相关的改造需求最核心的一块就是实验报告从纸质提交变成在线提交批改。当时技术选型几乎没纠结直接用Spring Boot搭后端前端配个Vue的管理界面。整个系统做下来最深的感受就是Spring Boot这种“约定大于配置”的玩法实在太适合这种业务逻辑清晰、又需要快速交付的管理系统了。这篇就完整复盘一下实验报告系统的设计和实现过程从模块划分、核心功能、Spring Boot关键特性的落地到实际开发中踩过的版本、配置、部署相关的坑一次性说清楚。这套系统功能上不复杂但覆盖面很全对学生来说是在线写报告、提交报告、查成绩对老师来说是发布实验任务、批改报告、导出成绩对管理员来说是管理课程、实验项目、学生教师账号。技术栈就是标准的Spring Boot MyBatis Plus MySQL前端用Vue 2 Element UI鉴权用JWT缓存用Redis。适合正在做Spring Boot课设、毕设或者想快速了解一个完整管理系统怎么落地的人参考。1. 项目整体设计与技术选型思路1.1 为什么选Spring Boot而不是Spring MVC这个项目本质上是一个典型的CRUD加业务流程管理系统和传统的Spring MVC工程比起来Spring Boot最大的优势就是把大量繁琐的配置自动化了。比如数据源、事务管理器、视图解析器这些Spring Boot通过自动配置机制帮你配好你只需要关心业务代码。这里要给新手解释一个概念Spring Boot并不是取代Spring框架而是让Spring用起来更简单。传统Spring MVC项目要写一堆XML配置文件配置扫描包、配置数据源、配置事务、配置拦截器项目还没开始写业务光配置就得折腾半天。Spring Boot把这些变成了一套自动装配机制你引入一个spring-boot-starter-web依赖内嵌的Tomcat就起来了引入mybatis-plus-boot-starter数据源和MyBatis就自动接好了。从我实际开发的角度说这个选择带来的直接好处是交付速度快。实验报告系统从需求确认到能跑通核心功能大概一周时间。如果换传统SSM项目光配置文件来回调就得花掉两三天。对于这种业务逻辑不复杂、但涉及角色权限和文件上传下载的系统Spring Boot的启动器和自动配置能省掉大量重复劳动。1.2 前后端分离还是服务端渲染这个项目我选的是前后端分离前端Vue 后端Spring Boot提供纯接口。原因有三个。第一是实验报告系统本身就涉及富文本编辑、文件上传、成绩展示这类交互用Vue做前端界面用户体验比服务端渲染的JSP好很多。第二是前后端分离以后接口可以复用以后如果要做移动端H5或者小程序后端接口基本不用动。第三是从毕设和课设的角度讲前后端分离的技术栈写进简历里也更完整。但前后端分离也有代价最直接的就是要处理跨域。我在开发的时候就遇到过前端请求后端接口报跨域错误这个后面在问题排查部分会详细讲。1.3 核心模块划分整个系统的功能模块我是这样拆的。用户认证模块学生、教师、管理员三种角色的登录与鉴权JWT生成和验证。课程与实验管理模块管理员创建课程、添加学生选课关系教师创建实验项目并关联到课程。实验报告提交模块学生选择实验项目提交实验报告富文本内容 附件支持查看历史报告和批改状态。报告批改模块教师查看待批改列表给报告打分并填写评语系统自动统计成绩。数据统计模块按课程、按实验项目统计提交率、平均分、通过率用图表展示。基础管理模块学生、教师账号管理学院班级管理系统公告等。模块拆分的思路是遵循单一职责原则每个模块只负责自己那一块业务模块之间通过Service层调用。比如提交报告的时候需要校验学生是否选了这门课那就由课程模块提供接口报告模块只负责报告本身的数据操作。这样的拆分方式好处很多最明显的是出了问题好排查。比如老师反映看不到某个学生的报告那我直接去查报告模块的日志判断是数据没提交上来还是课程关联关系有问题定位很快不用翻一大堆乱七八糟耦合在一起的代码。2. 核心功能实现与Spring Boot关键技术落地2.1 JWT登录鉴权拦截器 Token机制登录鉴权是每个管理系统都绕不开的部分。这个项目用的是JWTJSON Web Token相比于传统的Session方案JWT是无状态的服务器不需要保存会话数据特别适合前后端分离的架构。JWT的逻辑说起来很简单用户登录成功后后端生成一个包含用户ID、角色、过期时间的Token返回给前端。前端每次请求都在Header里带上这个Token后端通过拦截器解析Token拿到用户信息判断有没有权限访问对应接口。在Spring Boot里实现这个拦截器非常方便。定义一个类实现HandlerInterceptor接口在preHandle方法里解析Token然后把用户信息放到ThreadLocal或者请求上下文里方便后面的业务代码获取当前登录用户。注册拦截器只需要实现WebMvcConfigurer接口重写addInterceptors方法就行。要注意的点有三个。一是Token过期时间的设置。学生做实验可能比较久Token过期时间设短了写一半报告突然掉线很崩溃。我设置的是8小时刚好覆盖一个实验课的时间。老师和管理员的Token可以稍微短一点4小时安全一些。二是拦截路径的配置。放行登录接口、静态资源、Swagger文档这些不需要鉴权的路径其余所有接口都要验证Token。用excludePathPatterns方法写放行路径比一个个加拦截路径省事得多。三是角色权限控制。我封装了一个RequireRole注解标在Controller方法上配合拦截器实现角色校验。比如提交报告接口标注RequireRole(STUDENT)教师登录的Token即使能通过JWT验证也会因为角色不匹配被拦截下来。这样做的好处是权限逻辑集中在拦截器里业务代码不用到处判断当前用户是哪种角色。2.2 实验报告的富文本编辑与附件上传实验报告不是一个简单的文本输入框就能搞定的。学生写实验报告要包含实验目的、实验原理、实验步骤、实验结果分析这些内容纯文本体验太差必须用富文本编辑器。前端我用的富文本编辑器是wangEditor支持图片插入、表格、代码块够用还不臃肿。后端接收富文本内容很简单就是一个String字段。但有个细节需要注意富文本里的图片是Base64编码的如果学生贴了好几张截图整个内容体量会非常夸张数据库保存和页面加载都会有压力。我采取的策略是前端在插入图片的时候先把图片上传到后端后端返回图片URL然后富文本里存的是图片链接而不是Base64。这个操作需要前端配合在wangEditor的配置里自定义图片上传逻辑。附件上传这块我用的是Spring Boot的MultipartFile接口。需要注意的地方是配置文件里的上传大小限制。Spring Boot默认单文件上传限制是1MB做实验报告肯定不够我在application.yml里改成了50MB。改配置很简单但这个坑如果不注意测的时候传个大文件直接报错新手容易一脸懵。文件存储路径我建议不要放到项目目录里而是配置一个绝对路径比如/data/report-files/这样以后项目重新部署不会丢文件。数据库中只保存相对路径或者URL需要下载的时候再拼接完整路径。2.3 教师批改与成绩统计的业务逻辑教师批改报告的流程看起来只是个更新操作把分数和评语更新到报告记录里但实际要处理几个问题。第一个问题是成绩的修改记录。教师可能批改完之后觉得分数给低了重新修改分数这时候系统要有操作日志记录谁在什么时间把成绩从多少改成了多少。我加了一个report_score_log表批改和修改分数的时候都会写入一条日志可以追溯到每一次变更。第二个问题是重复批改。学生提交报告后状态是“待批改”教师批改完后状态变成“已批改”。如果学生还想修改报告需要申请退回教师同意后报告状态变回“待批改”学生才能重新编辑。这个状态机逻辑要用最严格的方式控制避免出现学生报告被批改了还能自己偷偷改内容的情况。状态变化我用了Spring Boot的Transactional注解保证事务性。比如批改报告这个操作要同时更新报告状态、写入成绩日志、更新课程成绩统计任何一个步骤失败整个操作都要回滚不能让成绩统计和报告状态不一致。成绩统计相对简单按课程维度、按实验项目维度做聚合查询就行。MyBatis Plus的QueryWrapper配合group by能搞定大部分需求。如果数据量大可以建一个统计表批改的时候实时更新统计数据比每次现算要快得多。2.4 数据展示用ECharts做课程维度分析系统里做了一个数据统计的可视化模块用ECharts展示。包括每门课程的实验完成率、成绩分布直方图、每个实验的平均分趋势等。后端接口负责返回统计数据前端负责渲染图表。比如成绩分布后端查数据库里这门课程所有实验报告的成绩按分数段分组统计返回给前端前端用ECharts的柱状图展示。这里要说一下效率问题。如果学生选课多、报告多每次打开统计页面都实时从原始数据聚合计算数据库压力会比较大。我的做法是写了一个定时任务每天凌晨统计一次前一天的数据存到统计表里统计页面读的是统计表而不是原始报告表。这样统计页面打开速度很快也不会拖垮主流程的数据库性能。3. 环境准备与核心代码实现细节3.1 Spring Boot版本选择别一上来就踩版本坑Spring Boot的版本选择是个非常实际的问题尤其对新手来说。Spring Boot 3.x 发布以后很多新项目直接用了3.x但要注意Spring Boot 3.x 是基于JDK 17的如果你电脑装的是JDK 8用3.x会直接报错。我自己开发这个项目用的是Spring Boot 2.7.13对应JDK 8。选这个组合的原因很朴素稳定生态兼容性好网上搜问题一堆解决方案。MyBatis Plus、Redis相关依赖、Vue前端的接口对接都在2.7.x版本上有成熟的实践。如果你要用JDK 17 Spring Boot 3.x也不是不行但要确认你用的所有第三方依赖都适配了jakarta.*命名空间。Spring Boot 3.x把javax.*换成了jakarta.*很多老版本依赖会直接运行时报ClassNotFound。版本选定以后创建项目我用的是IDEA自带的Spring Initializr勾选依赖很方便。我建议创建项目的时候只勾最基础的Spring Web后续用到什么再通过Maven手动加依赖这样项目结构更干净也方便理解每个依赖是干嘛的。3.2 Spring Boot常用注解清单这波是高频考点用Spring Boot开发注解是使用频率最高的东西。这个项目里我用的比较多的注解列一下顺便聊一下它们分别解决什么问题。SpringBootApplication这是启动类上的核心注解组合了Configuration、EnableAutoConfiguration和ComponentScan。写代码的时候不用管它内部组合了什么只要知道项目启动就靠它。RestController和RequestMapping这对组合是定义接口用的。RestController是Controller加ResponseBody的组合返回对象会自动转成JSON。RequestMapping用来定义URL路径支持类级别和方法级别的路径拼接。我习惯用PostMapping、GetMapping、PutMapping、DeleteMapping这些组合注解替代RequestMapping(method RequestMethod.XXX)语义更清晰写起来也短。Autowired和Resource都是依赖注入。Autowired是按类型注入Resource是按名称注入。项目里我统一用的是Autowired加构造器注入的方式避免循环依赖的坑也方便写单元测试。Service、Mapper、Component是用来声明Bean的。Service标注Service类Repository标注Dao层Mapper配合MyBatis Plus扫描Mapper接口。每个层次用不同注解代码可读性会好很多。ConfigurationProperties和Value是读取配置文件的。Value(${file.upload-path})可以很方便地注入单条配置。ConfigurationProperties适合把一组配置封装成一个类比如OSS配置、JWT配置集中管理应用起来更规范。Transactional是最常用的声明式事务注解标注在需要保证原子性的方法上。批改报告更新成绩这个操作就加了这个注解。Scheduled是做定时任务用的配合EnableScheduling使用。项目里用来做实验截止提醒和每日数据统计。3.3 登录接口和JWT工具类的实现思路登录接口本身逻辑很简单前端传账号密码后端查数据库验证通过就生成Token返回。但有几个安全细节要处理好。密码存储不能是明文。我用的是BCrypt加密Spring Security里自带BCryptPasswordEncoder单独引一个spring-security-crypto依赖就能用不用引入整个Spring Security。加密后的密码长这样$2a$10$...每次匹配用matches方法。JWT工具类封装了三个方法生成Token、解析Token、校验Token。生成Token的时候往里面放用户ID和角色过期时间设置8小时。密钥我放在配置文件里用Value注入不写死在代码里以后部署到不同环境可以换密钥。登录成功后前端会把Token存在localStorage里每次请求在axios拦截器里统一加上Authorization: Bearer token这个Header后端拦截器从Header里取Token解析。这个方案简单可靠实测没什么问题。需要注意Token如果泄露别人就能冒充身份操作所以在开发环境和测试环境我设置了较短的过期时间并且要求前端在Token过期后引导用户重新登录。3.4 报告提交的接口设计与状态流转报告提交的接口设计我花了点心思。学生的完整操作流程是选一门课程 - 选课程下的实验项目 - 提交报告内容 - 查看批改结果。这里涉及几个接口查询学生已选课程列表、查询课程下的实验项目列表、按实验项目查询学生自己的报告详情、提交或更新报告、提交后查看批改状态。状态流转我用一个整数类型字段status表示0草稿、1已提交待批改、2已批改、3已退回待修改、4已归档。状态变化都通过Service层的方法触发不允许直接改数据库字段。这个设计的核心是避免学生反复提交刷成绩。提交状态是“已批改”的报告前端是不允许再编辑的按钮直接置灰。如果确实需要修改要走“申请退回”流程教师同意后状态变回“待修改”学生才能编辑内容重新提交。3.5 Redis在项目里的实际用法Redis在这个项目里主要做了两件事第一是缓存高频读数据第二是记录在线状态。高频读数据的典型场景是课程列表和实验项目列表。这些数据基本不变学生每次登录都要拉取访问频率很高但更新频率极低非常适合放Redis缓存。我用Spring Cache的Cacheable注解做这件事方法上标一个注解第一次查询走数据库后续直接走Redis缓存代码侵入性很小。在线状态记录是指用户登录成功后把用户ID写入Redis设置过期时间和Token过期时间一致用于实现判断用户是否在线、强制下线这类功能。比如系统管理员强制某个教师下线只要删掉Redis里的记录配合拦截器里对Token有效性的校验就能让该用户下次请求时直接失效。Redis的配置要注意序列化器的选择。默认的JDK序列化在Redis可视化工具里看到的是乱码不方便排查问题。我把RedisTemplate的key序列化器换成了StringRedisSerializervalue序列化器用Jackson2JsonRedisSerializer这样在Redis里看到的就是人类可读数据。3.6 Spring Boot事件监听机制的实际场景Spring Boot的事件监听机制这个项目里用了一个很典型的场景教师批改完报告以后需要通知学生。如果直接在批改方法里写通知逻辑代码耦合度很高而且万一通知服务出问题还会影响批改主流程。我用的方案是Spring的事件机制。批改完成后通过ApplicationEventPublisher发布一个“报告已批改”事件事件里带上学生ID、实验名称、分数这些信息。有一个独立的EventListener监听器处理这个事件发站内信或者短信通知学生。这样做的好处是解耦。以后如果想增加邮件通知只需要再加一个监听器完全不用改动批改业务代码。Spring的事件监听是同步的如果想异步处理在监听器方法上标一个Async就行同时启动类要加EnableAsync启用异步支持。这个机制原理上讲就是观察者模式实际开发中非常实用。除了通知场景还可以用在写操作日志、更新统计数据、触发后续业务流程等场景新同事接手代码只看入口方法就能懂整体逻辑不需要追着一堆调用关系翻。3.7 多数据源与定时任务跑批系统进阶能力这个项目正常情况只需要连一个MySQL库就够了。但学校环境往往有特殊性比如学生信息来自统一身份认证系统教师信息来自人事系统如果需要在系统里同步这些外部数据就涉及多数据源的问题。Spring Boot整合多数据源有几种方式我推荐用dynamic-datasource这个开源库配置特别简单。在配置文件里定义多个数据源用DS(xxx)注解标注在方法或类上就能指定当前方法操作哪个数据源。比如同步学生信息的定时任务方法上标注DS(auth-db)操作的是统一身份认证的库查询完塞到本地库后再切回默认数据源。定时任务我用的是Scheduled注解配合cron表达式。这个项目里的定时任务有三个每天凌晨同步学生和教师数据、每天统计一次实验报告数据、每天检查实验截止时间并给未提交的学生发送提醒。写定时任务要注意防止重复执行尤其当部署多个实例的时候。我的方案是用Redis的setnx命令加一个分布式锁只有拿到锁的实例才执行任务执行完释放锁避免重复跑批导致数据异常。4. 开发中常见问题与排查技巧实录4.1 跨域问题前后端分离的第一道坎前后端分离项目最常遇到的就是跨域。前端跑在localhost:8080后端跑在localhost:9090前端发请求默认会被浏览器拦截控制台报错提示CORS。解决办法是在后端配置一个WebMvcConfigurer重写addCorsMappings方法允许跨域访问。要注意allowedOriginPatterns不要直接用*实际开发中我会定义成具体的域名或者地址。配置允许的请求方法要包含OPTIONS因为浏览器发送跨域复杂请求前会先发一个预检请求。这里踩过的坑是前端用了axios请求的时候如果带了自定义Header比如Authorization后端配置跨域的时候必须allowedHeaders(*)允许所有Header否则预检请求过不了接口照样调不通。4.2 时间格式的坑前后端显示不一致实验报告系统里涉及提交时间、批改时间、截止时间时间格式前后端对不上是高频问题。主要表现是后端返回的是时间戳或者带T的ISO格式而前端想要的是yyyy-MM-dd HH:mm:ss。解决方案是在后端的application.yml里配置统一的JSON序列化格式spring.jackson.date-formatyyyy-MM-dd HH:mm:ssspring.jackson.time-zoneGMT8。也可以用JsonFormat注解标注在时间字段上灵活指定格式。第二个坑是时区问题。服务器默认时区可能不是东八区数据库存的时间和前端显示的时间差8个小时。解决方法是数据库连接串里加上serverTimezoneAsia/Shanghai同时JVM启动参数加-Duser.timezoneGMT8。4.3 文件上传报错不是代码问题而是大小限制文件上传功能写好后本地测试小文件没问题传一个手机拍的实验过程照片就报错提示MaxUploadSizeExceededException。这个就是前面提到的上传大小限制问题。Spring Boot的默认单文件大小限制是1MB整个请求大小限制是10MB照片稍微大点就超了。配置修改方式有两种Spring Boot 2.x里用spring.servlet.multipart.max-file-size50MB和spring.servlet.multipart.max-request-size50MB。Spring Boot 3.x对应配置路径是spring.servlet.multipart.max-file-size写法一样。这里要提醒一点如果项目部署在Nginx后面Nginx默认请求体大小限制是1MB也要在Nginx配置里改client_max_body_size否则后端配置改了前端还是报错。4.4 数据库连接超时定时任务跑到一半断开项目部署到生产环境后隔一段时间访问接口就报连接超时错误。原因是MySQL有wait_timeout参数默认8小时连接池里的连接如果超过这个时间没有活动会被MySQL服务端断开。而HikariCP连接池可能还有空闲连接没有感知到断连下一次请求用到这个连接就直接抛异常。解决办法是在数据源配置里设置连接池的connection-test-querySELECT 1并且配置空闲连接的最大存活时间让连接池自己回收空闲超时的连接。HikariCP的默认值其实已经处理了这个问题但如果你的项目是个体量比较小的管理后台长时间没人访问再打开就容易触发。4.5 MyBatis Plus的坑逻辑删除和唯一索引打架MyBatis Plus的逻辑删除功能很好用但配合唯一索引会有坑。项目里学生和课程的关系表有联合唯一索引学生ID 课程ID如果用了逻辑删除删除记录只是把deleted字段置为1数据库里实际还保留着这条数据。这时候重新添加学生选课插入一条同名数据就触发了唯一索引冲突。解决方案有几个最简单的就是去掉数据库的唯一索引在代码里做唯一性校验。但高性能场景还是推荐用唯一索引配合复合唯一索引学生ID 课程ID deleted来做逻辑删除字段为0时保证唯一已删除的记录可以重复存在。开发这类系统的时候诸如此类边边角角的小问题其实是最耗时间的。我把常见的几个都记录下来同事接手项目的时候少走很多弯路。5. 实测部署经验与个人体会系统开发完成后部署我用的是非常朴素的方式后端打jar包扔到服务器上跑。在服务器上装好JDK和MySQL把jar包传上去用nohup java -jar挂后台启动日志输出到文件里方便排查问题。前后端分离前端打包后是静态文件用Nginx托管同时把接口请求反向代理到后端端口。部署阶段有两个细节值得说一说。一个是服务器防火墙和安全组要开放对应端口不然前端页面能打开但接口请求全失败。另一个是jar包运行时的环境变量。数据库密码、Redis地址这些敏感信息不要写在配置文件里跟着包走我一般用--spring.profiles.activeprod启动参数指定生产环境配置文件或者用环境变量动态注入。整个项目从需求分析到部署上线让我对Spring Boot的自动装配原理有了更直观的理解。比如为什么引入一个starter依赖功能就能用是因为Spring Boot在spring.factories或者AutoConfiguration.imports文件里定义了自动配置类当classpath下存在对应类时自动配置才生效这种“条件装配”的设计思路非常巧妙。理解了这个原理以后自己写starter、封装公共模块的时候思路就清晰了。最后分享一个小技巧。开发过程中切换不同Spring Boot版本调试问题比预期的麻烦。如果你还在用JDK 8最高只能用Spring Boot 2.7.x这个版本也恰好是目前兼容性和生态最稳的版本。如果非要尝鲜Spring Boot 3.x升级之前先检查所有第三方依赖的版本用一个检查依赖兼容性的工具把所有jar包过一遍能避免启动的时候一堆ClassNotFound的幺蛾子。我自己就曾经在升级之后因为一个旧版MyBatis Plus的适配问题折腾了一整天。 
长河君 · 2026/9/17 4:01:22 · 阅读 1.2k Spring Boot实验报告管理系统开发实战：从架构设计到部署避坑指南
先讲个我自己的经历。之前接了一个实验室管理相关的改造需求最核心的一块就是实验报告从纸质提交变成在线提交批改。当时技术选型几乎没纠结直接用Spring Boot搭后端前端配个Vue的管理界面。整个系统做下来最深的感受就是Spring Boot这种“约定大于配置”的玩法实在太适合这种业务逻辑清晰、又需要快速交付的管理系统了。这篇就完整复盘一下实验报告系统的设计和实现过程从模块划分、核心功能、Spring Boot关键特性的落地到实际开发中踩过的版本、配置、部署相关的坑一次性说清楚。这套系统功能上不复杂但覆盖面很全对学生来说是在线写报告、提交报告、查成绩对老师来说是发布实验任务、批改报告、导出成绩对管理员来说是管理课程、实验项目、学生教师账号。技术栈就是标准的Spring Boot MyBatis Plus MySQL前端用Vue 2 Element UI鉴权用JWT缓存用Redis。适合正在做Spring Boot课设、毕设或者想快速了解一个完整管理系统怎么落地的人参考。1. 项目整体设计与技术选型思路1.1 为什么选Spring Boot而不是Spring MVC这个项目本质上是一个典型的CRUD加业务流程管理系统和传统的Spring MVC工程比起来Spring Boot最大的优势就是把大量繁琐的配置自动化了。比如数据源、事务管理器、视图解析器这些Spring Boot通过自动配置机制帮你配好你只需要关心业务代码。这里要给新手解释一个概念Spring Boot并不是取代Spring框架而是让Spring用起来更简单。传统Spring MVC项目要写一堆XML配置文件配置扫描包、配置数据源、配置事务、配置拦截器项目还没开始写业务光配置就得折腾半天。Spring Boot把这些变成了一套自动装配机制你引入一个spring-boot-starter-web依赖内嵌的Tomcat就起来了引入mybatis-plus-boot-starter数据源和MyBatis就自动接好了。从我实际开发的角度说这个选择带来的直接好处是交付速度快。实验报告系统从需求确认到能跑通核心功能大概一周时间。如果换传统SSM项目光配置文件来回调就得花掉两三天。对于这种业务逻辑不复杂、但涉及角色权限和文件上传下载的系统Spring Boot的启动器和自动配置能省掉大量重复劳动。1.2 前后端分离还是服务端渲染这个项目我选的是前后端分离前端Vue 后端Spring Boot提供纯接口。原因有三个。第一是实验报告系统本身就涉及富文本编辑、文件上传、成绩展示这类交互用Vue做前端界面用户体验比服务端渲染的JSP好很多。第二是前后端分离以后接口可以复用以后如果要做移动端H5或者小程序后端接口基本不用动。第三是从毕设和课设的角度讲前后端分离的技术栈写进简历里也更完整。但前后端分离也有代价最直接的就是要处理跨域。我在开发的时候就遇到过前端请求后端接口报跨域错误这个后面在问题排查部分会详细讲。1.3 核心模块划分整个系统的功能模块我是这样拆的。用户认证模块学生、教师、管理员三种角色的登录与鉴权JWT生成和验证。课程与实验管理模块管理员创建课程、添加学生选课关系教师创建实验项目并关联到课程。实验报告提交模块学生选择实验项目提交实验报告富文本内容 附件支持查看历史报告和批改状态。报告批改模块教师查看待批改列表给报告打分并填写评语系统自动统计成绩。数据统计模块按课程、按实验项目统计提交率、平均分、通过率用图表展示。基础管理模块学生、教师账号管理学院班级管理系统公告等。模块拆分的思路是遵循单一职责原则每个模块只负责自己那一块业务模块之间通过Service层调用。比如提交报告的时候需要校验学生是否选了这门课那就由课程模块提供接口报告模块只负责报告本身的数据操作。这样的拆分方式好处很多最明显的是出了问题好排查。比如老师反映看不到某个学生的报告那我直接去查报告模块的日志判断是数据没提交上来还是课程关联关系有问题定位很快不用翻一大堆乱七八糟耦合在一起的代码。2. 核心功能实现与Spring Boot关键技术落地2.1 JWT登录鉴权拦截器 Token机制登录鉴权是每个管理系统都绕不开的部分。这个项目用的是JWTJSON Web Token相比于传统的Session方案JWT是无状态的服务器不需要保存会话数据特别适合前后端分离的架构。JWT的逻辑说起来很简单用户登录成功后后端生成一个包含用户ID、角色、过期时间的Token返回给前端。前端每次请求都在Header里带上这个Token后端通过拦截器解析Token拿到用户信息判断有没有权限访问对应接口。在Spring Boot里实现这个拦截器非常方便。定义一个类实现HandlerInterceptor接口在preHandle方法里解析Token然后把用户信息放到ThreadLocal或者请求上下文里方便后面的业务代码获取当前登录用户。注册拦截器只需要实现WebMvcConfigurer接口重写addInterceptors方法就行。要注意的点有三个。一是Token过期时间的设置。学生做实验可能比较久Token过期时间设短了写一半报告突然掉线很崩溃。我设置的是8小时刚好覆盖一个实验课的时间。老师和管理员的Token可以稍微短一点4小时安全一些。二是拦截路径的配置。放行登录接口、静态资源、Swagger文档这些不需要鉴权的路径其余所有接口都要验证Token。用excludePathPatterns方法写放行路径比一个个加拦截路径省事得多。三是角色权限控制。我封装了一个RequireRole注解标在Controller方法上配合拦截器实现角色校验。比如提交报告接口标注RequireRole(STUDENT)教师登录的Token即使能通过JWT验证也会因为角色不匹配被拦截下来。这样做的好处是权限逻辑集中在拦截器里业务代码不用到处判断当前用户是哪种角色。2.2 实验报告的富文本编辑与附件上传实验报告不是一个简单的文本输入框就能搞定的。学生写实验报告要包含实验目的、实验原理、实验步骤、实验结果分析这些内容纯文本体验太差必须用富文本编辑器。前端我用的富文本编辑器是wangEditor支持图片插入、表格、代码块够用还不臃肿。后端接收富文本内容很简单就是一个String字段。但有个细节需要注意富文本里的图片是Base64编码的如果学生贴了好几张截图整个内容体量会非常夸张数据库保存和页面加载都会有压力。我采取的策略是前端在插入图片的时候先把图片上传到后端后端返回图片URL然后富文本里存的是图片链接而不是Base64。这个操作需要前端配合在wangEditor的配置里自定义图片上传逻辑。附件上传这块我用的是Spring Boot的MultipartFile接口。需要注意的地方是配置文件里的上传大小限制。Spring Boot默认单文件上传限制是1MB做实验报告肯定不够我在application.yml里改成了50MB。改配置很简单但这个坑如果不注意测的时候传个大文件直接报错新手容易一脸懵。文件存储路径我建议不要放到项目目录里而是配置一个绝对路径比如/data/report-files/这样以后项目重新部署不会丢文件。数据库中只保存相对路径或者URL需要下载的时候再拼接完整路径。2.3 教师批改与成绩统计的业务逻辑教师批改报告的流程看起来只是个更新操作把分数和评语更新到报告记录里但实际要处理几个问题。第一个问题是成绩的修改记录。教师可能批改完之后觉得分数给低了重新修改分数这时候系统要有操作日志记录谁在什么时间把成绩从多少改成了多少。我加了一个report_score_log表批改和修改分数的时候都会写入一条日志可以追溯到每一次变更。第二个问题是重复批改。学生提交报告后状态是“待批改”教师批改完后状态变成“已批改”。如果学生还想修改报告需要申请退回教师同意后报告状态变回“待批改”学生才能重新编辑。这个状态机逻辑要用最严格的方式控制避免出现学生报告被批改了还能自己偷偷改内容的情况。状态变化我用了Spring Boot的Transactional注解保证事务性。比如批改报告这个操作要同时更新报告状态、写入成绩日志、更新课程成绩统计任何一个步骤失败整个操作都要回滚不能让成绩统计和报告状态不一致。成绩统计相对简单按课程维度、按实验项目维度做聚合查询就行。MyBatis Plus的QueryWrapper配合group by能搞定大部分需求。如果数据量大可以建一个统计表批改的时候实时更新统计数据比每次现算要快得多。2.4 数据展示用ECharts做课程维度分析系统里做了一个数据统计的可视化模块用ECharts展示。包括每门课程的实验完成率、成绩分布直方图、每个实验的平均分趋势等。后端接口负责返回统计数据前端负责渲染图表。比如成绩分布后端查数据库里这门课程所有实验报告的成绩按分数段分组统计返回给前端前端用ECharts的柱状图展示。这里要说一下效率问题。如果学生选课多、报告多每次打开统计页面都实时从原始数据聚合计算数据库压力会比较大。我的做法是写了一个定时任务每天凌晨统计一次前一天的数据存到统计表里统计页面读的是统计表而不是原始报告表。这样统计页面打开速度很快也不会拖垮主流程的数据库性能。3. 环境准备与核心代码实现细节3.1 Spring Boot版本选择别一上来就踩版本坑Spring Boot的版本选择是个非常实际的问题尤其对新手来说。Spring Boot 3.x 发布以后很多新项目直接用了3.x但要注意Spring Boot 3.x 是基于JDK 17的如果你电脑装的是JDK 8用3.x会直接报错。我自己开发这个项目用的是Spring Boot 2.7.13对应JDK 8。选这个组合的原因很朴素稳定生态兼容性好网上搜问题一堆解决方案。MyBatis Plus、Redis相关依赖、Vue前端的接口对接都在2.7.x版本上有成熟的实践。如果你要用JDK 17 Spring Boot 3.x也不是不行但要确认你用的所有第三方依赖都适配了jakarta.*命名空间。Spring Boot 3.x把javax.*换成了jakarta.*很多老版本依赖会直接运行时报ClassNotFound。版本选定以后创建项目我用的是IDEA自带的Spring Initializr勾选依赖很方便。我建议创建项目的时候只勾最基础的Spring Web后续用到什么再通过Maven手动加依赖这样项目结构更干净也方便理解每个依赖是干嘛的。3.2 Spring Boot常用注解清单这波是高频考点用Spring Boot开发注解是使用频率最高的东西。这个项目里我用的比较多的注解列一下顺便聊一下它们分别解决什么问题。SpringBootApplication这是启动类上的核心注解组合了Configuration、EnableAutoConfiguration和ComponentScan。写代码的时候不用管它内部组合了什么只要知道项目启动就靠它。RestController和RequestMapping这对组合是定义接口用的。RestController是Controller加ResponseBody的组合返回对象会自动转成JSON。RequestMapping用来定义URL路径支持类级别和方法级别的路径拼接。我习惯用PostMapping、GetMapping、PutMapping、DeleteMapping这些组合注解替代RequestMapping(method RequestMethod.XXX)语义更清晰写起来也短。Autowired和Resource都是依赖注入。Autowired是按类型注入Resource是按名称注入。项目里我统一用的是Autowired加构造器注入的方式避免循环依赖的坑也方便写单元测试。Service、Mapper、Component是用来声明Bean的。Service标注Service类Repository标注Dao层Mapper配合MyBatis Plus扫描Mapper接口。每个层次用不同注解代码可读性会好很多。ConfigurationProperties和Value是读取配置文件的。Value(${file.upload-path})可以很方便地注入单条配置。ConfigurationProperties适合把一组配置封装成一个类比如OSS配置、JWT配置集中管理应用起来更规范。Transactional是最常用的声明式事务注解标注在需要保证原子性的方法上。批改报告更新成绩这个操作就加了这个注解。Scheduled是做定时任务用的配合EnableScheduling使用。项目里用来做实验截止提醒和每日数据统计。3.3 登录接口和JWT工具类的实现思路登录接口本身逻辑很简单前端传账号密码后端查数据库验证通过就生成Token返回。但有几个安全细节要处理好。密码存储不能是明文。我用的是BCrypt加密Spring Security里自带BCryptPasswordEncoder单独引一个spring-security-crypto依赖就能用不用引入整个Spring Security。加密后的密码长这样$2a$10$...每次匹配用matches方法。JWT工具类封装了三个方法生成Token、解析Token、校验Token。生成Token的时候往里面放用户ID和角色过期时间设置8小时。密钥我放在配置文件里用Value注入不写死在代码里以后部署到不同环境可以换密钥。登录成功后前端会把Token存在localStorage里每次请求在axios拦截器里统一加上Authorization: Bearer token这个Header后端拦截器从Header里取Token解析。这个方案简单可靠实测没什么问题。需要注意Token如果泄露别人就能冒充身份操作所以在开发环境和测试环境我设置了较短的过期时间并且要求前端在Token过期后引导用户重新登录。3.4 报告提交的接口设计与状态流转报告提交的接口设计我花了点心思。学生的完整操作流程是选一门课程 - 选课程下的实验项目 - 提交报告内容 - 查看批改结果。这里涉及几个接口查询学生已选课程列表、查询课程下的实验项目列表、按实验项目查询学生自己的报告详情、提交或更新报告、提交后查看批改状态。状态流转我用一个整数类型字段status表示0草稿、1已提交待批改、2已批改、3已退回待修改、4已归档。状态变化都通过Service层的方法触发不允许直接改数据库字段。这个设计的核心是避免学生反复提交刷成绩。提交状态是“已批改”的报告前端是不允许再编辑的按钮直接置灰。如果确实需要修改要走“申请退回”流程教师同意后状态变回“待修改”学生才能编辑内容重新提交。3.5 Redis在项目里的实际用法Redis在这个项目里主要做了两件事第一是缓存高频读数据第二是记录在线状态。高频读数据的典型场景是课程列表和实验项目列表。这些数据基本不变学生每次登录都要拉取访问频率很高但更新频率极低非常适合放Redis缓存。我用Spring Cache的Cacheable注解做这件事方法上标一个注解第一次查询走数据库后续直接走Redis缓存代码侵入性很小。在线状态记录是指用户登录成功后把用户ID写入Redis设置过期时间和Token过期时间一致用于实现判断用户是否在线、强制下线这类功能。比如系统管理员强制某个教师下线只要删掉Redis里的记录配合拦截器里对Token有效性的校验就能让该用户下次请求时直接失效。Redis的配置要注意序列化器的选择。默认的JDK序列化在Redis可视化工具里看到的是乱码不方便排查问题。我把RedisTemplate的key序列化器换成了StringRedisSerializervalue序列化器用Jackson2JsonRedisSerializer这样在Redis里看到的就是人类可读数据。3.6 Spring Boot事件监听机制的实际场景Spring Boot的事件监听机制这个项目里用了一个很典型的场景教师批改完报告以后需要通知学生。如果直接在批改方法里写通知逻辑代码耦合度很高而且万一通知服务出问题还会影响批改主流程。我用的方案是Spring的事件机制。批改完成后通过ApplicationEventPublisher发布一个“报告已批改”事件事件里带上学生ID、实验名称、分数这些信息。有一个独立的EventListener监听器处理这个事件发站内信或者短信通知学生。这样做的好处是解耦。以后如果想增加邮件通知只需要再加一个监听器完全不用改动批改业务代码。Spring的事件监听是同步的如果想异步处理在监听器方法上标一个Async就行同时启动类要加EnableAsync启用异步支持。这个机制原理上讲就是观察者模式实际开发中非常实用。除了通知场景还可以用在写操作日志、更新统计数据、触发后续业务流程等场景新同事接手代码只看入口方法就能懂整体逻辑不需要追着一堆调用关系翻。3.7 多数据源与定时任务跑批系统进阶能力这个项目正常情况只需要连一个MySQL库就够了。但学校环境往往有特殊性比如学生信息来自统一身份认证系统教师信息来自人事系统如果需要在系统里同步这些外部数据就涉及多数据源的问题。Spring Boot整合多数据源有几种方式我推荐用dynamic-datasource这个开源库配置特别简单。在配置文件里定义多个数据源用DS(xxx)注解标注在方法或类上就能指定当前方法操作哪个数据源。比如同步学生信息的定时任务方法上标注DS(auth-db)操作的是统一身份认证的库查询完塞到本地库后再切回默认数据源。定时任务我用的是Scheduled注解配合cron表达式。这个项目里的定时任务有三个每天凌晨同步学生和教师数据、每天统计一次实验报告数据、每天检查实验截止时间并给未提交的学生发送提醒。写定时任务要注意防止重复执行尤其当部署多个实例的时候。我的方案是用Redis的setnx命令加一个分布式锁只有拿到锁的实例才执行任务执行完释放锁避免重复跑批导致数据异常。4. 开发中常见问题与排查技巧实录4.1 跨域问题前后端分离的第一道坎前后端分离项目最常遇到的就是跨域。前端跑在localhost:8080后端跑在localhost:9090前端发请求默认会被浏览器拦截控制台报错提示CORS。解决办法是在后端配置一个WebMvcConfigurer重写addCorsMappings方法允许跨域访问。要注意allowedOriginPatterns不要直接用*实际开发中我会定义成具体的域名或者地址。配置允许的请求方法要包含OPTIONS因为浏览器发送跨域复杂请求前会先发一个预检请求。这里踩过的坑是前端用了axios请求的时候如果带了自定义Header比如Authorization后端配置跨域的时候必须allowedHeaders(*)允许所有Header否则预检请求过不了接口照样调不通。4.2 时间格式的坑前后端显示不一致实验报告系统里涉及提交时间、批改时间、截止时间时间格式前后端对不上是高频问题。主要表现是后端返回的是时间戳或者带T的ISO格式而前端想要的是yyyy-MM-dd HH:mm:ss。解决方案是在后端的application.yml里配置统一的JSON序列化格式spring.jackson.date-formatyyyy-MM-dd HH:mm:ssspring.jackson.time-zoneGMT8。也可以用JsonFormat注解标注在时间字段上灵活指定格式。第二个坑是时区问题。服务器默认时区可能不是东八区数据库存的时间和前端显示的时间差8个小时。解决方法是数据库连接串里加上serverTimezoneAsia/Shanghai同时JVM启动参数加-Duser.timezoneGMT8。4.3 文件上传报错不是代码问题而是大小限制文件上传功能写好后本地测试小文件没问题传一个手机拍的实验过程照片就报错提示MaxUploadSizeExceededException。这个就是前面提到的上传大小限制问题。Spring Boot的默认单文件大小限制是1MB整个请求大小限制是10MB照片稍微大点就超了。配置修改方式有两种Spring Boot 2.x里用spring.servlet.multipart.max-file-size50MB和spring.servlet.multipart.max-request-size50MB。Spring Boot 3.x对应配置路径是spring.servlet.multipart.max-file-size写法一样。这里要提醒一点如果项目部署在Nginx后面Nginx默认请求体大小限制是1MB也要在Nginx配置里改client_max_body_size否则后端配置改了前端还是报错。4.4 数据库连接超时定时任务跑到一半断开项目部署到生产环境后隔一段时间访问接口就报连接超时错误。原因是MySQL有wait_timeout参数默认8小时连接池里的连接如果超过这个时间没有活动会被MySQL服务端断开。而HikariCP连接池可能还有空闲连接没有感知到断连下一次请求用到这个连接就直接抛异常。解决办法是在数据源配置里设置连接池的connection-test-querySELECT 1并且配置空闲连接的最大存活时间让连接池自己回收空闲超时的连接。HikariCP的默认值其实已经处理了这个问题但如果你的项目是个体量比较小的管理后台长时间没人访问再打开就容易触发。4.5 MyBatis Plus的坑逻辑删除和唯一索引打架MyBatis Plus的逻辑删除功能很好用但配合唯一索引会有坑。项目里学生和课程的关系表有联合唯一索引学生ID 课程ID如果用了逻辑删除删除记录只是把deleted字段置为1数据库里实际还保留着这条数据。这时候重新添加学生选课插入一条同名数据就触发了唯一索引冲突。解决方案有几个最简单的就是去掉数据库的唯一索引在代码里做唯一性校验。但高性能场景还是推荐用唯一索引配合复合唯一索引学生ID 课程ID deleted来做逻辑删除字段为0时保证唯一已删除的记录可以重复存在。开发这类系统的时候诸如此类边边角角的小问题其实是最耗时间的。我把常见的几个都记录下来同事接手项目的时候少走很多弯路。5. 实测部署经验与个人体会系统开发完成后部署我用的是非常朴素的方式后端打jar包扔到服务器上跑。在服务器上装好JDK和MySQL把jar包传上去用nohup java -jar挂后台启动日志输出到文件里方便排查问题。前后端分离前端打包后是静态文件用Nginx托管同时把接口请求反向代理到后端端口。部署阶段有两个细节值得说一说。一个是服务器防火墙和安全组要开放对应端口不然前端页面能打开但接口请求全失败。另一个是jar包运行时的环境变量。数据库密码、Redis地址这些敏感信息不要写在配置文件里跟着包走我一般用--spring.profiles.activeprod启动参数指定生产环境配置文件或者用环境变量动态注入。整个项目从需求分析到部署上线让我对Spring Boot的自动装配原理有了更直观的理解。比如为什么引入一个starter依赖功能就能用是因为Spring Boot在spring.factories或者AutoConfiguration.imports文件里定义了自动配置类当classpath下存在对应类时自动配置才生效这种“条件装配”的设计思路非常巧妙。理解了这个原理以后自己写starter、封装公共模块的时候思路就清晰了。最后分享一个小技巧。开发过程中切换不同Spring Boot版本调试问题比预期的麻烦。如果你还在用JDK 8最高只能用Spring Boot 2.7.x这个版本也恰好是目前兼容性和生态最稳的版本。如果非要尝鲜Spring Boot 3.x升级之前先检查所有第三方依赖的版本用一个检查依赖兼容性的工具把所有jar包过一遍能避免启动的时候一堆ClassNotFound的幺蛾子。我自己就曾经在升级之后因为一个旧版MyBatis Plus的适配问题折腾了一整天。