1. 为什么「家校互动」会成为毕业设计里的热门选题1.1 双减政策带来的业务变化我之前带过好几届学生的毕业设计每年6月改论文那阵子微信消息都是刷屏的。今年明显发现一个问题做管理系统的学生选题越来越往「教育服务」这个方向靠。尤其「家校互动」这个方向几乎占了三分之一。原因也很简单。双减政策落地之后表面上学生作业总量少了、考试次数少了但学校跟家长之间的沟通需求反而变多了。课后服务要不要参加、作业减下来之后孩子在家干什么、学校发了什么通知、孩子在学校的表现怎么同步给家长——这些事在过去靠家长群、靠老师挨个打电话效率低而且没人记录。一个统一的家校互动管理系统解决的就是「信息同步」和「过程留痕」这两件事。Spring Boot 在高校课程里几乎是标配框架了用它可以快速把一套 B/S 结构的系统从零跑起来。所以「Spring Boot 家校互动 双减场景」这个组合既能体现业务理解能力又能展示技术功底确实很适合作为毕业设计的选题。1.2 系统到底解决什么问题先把业务痛点盘一下这套系统一般要覆盖四类场景课后服务管理课程发布、学生报名、人数限制、出勤记录作业管理教师发布作业、家长或学生查看、提交情况跟踪、教师批改反馈家校沟通一对一留言家长和班主任、系统通知公告、已读未读状态学生成长记录考试成绩、综合素质评价、教师评语这类长期档案从技术架构上看用户角色通常分成三类管理员、教师、家长学生账号往往由家长账号下面挂靠。不同的角色在同一个系统里看到的内容完全不同这也就引出了整篇文章里我认为最关键的一块——权限设计。1.3 这套系统适合谁来参考如果你是准备做毕业设计的学生这个项目可以作为完整的可复现案例如果你是刚工作的初级 Java 开发想找一个不太复杂、但涉及完整 CRUD 权限 文件上传的管理系统练手它也很合适。源码、数据库脚本、部署文档我建议至少完整跑两遍再做二次开发这个后面专门讲。2. 「角色权限」是这类系统最核心的设计决策2.1 三种角色的业务边界很多学生做管理系统上来就写登录然后所有请求都放行这是个严重误区。家校互动系统里权限一旦混乱家长能看到所有学生的作业、老师能改别的班的数据演示的时候当场翻车答辩也会被追问。合理的权限矩阵大概是这样的功能模块管理员教师家长/学生班级与用户管理全权查看本班不可见作业发布与批改可查看统计本班操作查看提交课后服务课程管理审核/维护申请开设课程报名通知公告发布全局发布班级查看家校留言不参与与家长对应与班主任对应数据统计全校维度本班维度仅本人权限设计的本质不是把功能写复杂而是把「谁能动哪些数据」的边界定义清楚。2.2 Spring Security JWT 的落地方式这个系统我推荐使用 Spring Security 加 JWT 的组合。为什么不用 ShiroSpring Security 虽然是配置繁琐一些但对注解支持好和 Spring Boot 集成时自动配置能力强而且角色基于权限表达式控制非常灵活。关键配置步骤是引入依赖spring-boot-starter-security和jjwt写一个JwtTokenFilter负责从请求头里解析 token解析成功之后把用户信息放进SecurityContextHolder在SecurityConfig里放行登录接口和静态资源其余接口统一走认证通过PreAuthorize(hasRole(TEACHER))做方法级权限控制核心过滤器核心代码大概长这样Component public class JwtTokenFilter extends OncePerRequestFilter { Autowired private JwtUtil jwtUtil; Override protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain) throws ServletException, IOException { String authHeader request.getHeader(Authorization); if (authHeader ! null authHeader.startsWith(Bearer )) { String token authHeader.substring(7); String username jwtUtil.getUsernameFromToken(token); if (username ! null SecurityContextHolder.getContext().getAuthentication() null) { UserDetails userDetails userDetailsService.loadUserByUsername(username); UsernamePasswordAuthenticationToken authentication new UsernamePasswordAuthenticationToken(userDetails, null, userDetails.getAuthorities()); authentication.setDetails(new WebAuthenticationDetailsSource().buildDetails(request)); SecurityContextHolder.getContext().setAuthentication(authentication); } } chain.doFilter(request, response); } }需要注意JWT 里不要塞太多信息只放 userId、username、roleId 就够了其它信息每次从数据库里查避免改昵称之后 token 里还是旧数据。2.3 登录状态与 Token 过期的处理前端每次请求都带 token这里最容易踩的坑是「token 过期之后用户体验断崖」。我的做法是后端统一返回 401前端拿到 401 之后删掉本地 token跳回登录页。同时把 token 有效期设成 12 小时前端在发起请求前做一个本地有效期预判提前 10 分钟就用 refreshToken 换新。JWT 做刷新一定要生成新 token 并且保证旧 token 在 30 秒内还能被接受避免并发请求互相踢掉。3. 数据库设计这6张表撑起了整个系统3.1 先想清楚「人」的关系再想业务表家校互动系统最核心的实体不是作业不是课程而是「人」。我这里说的人包括管理员、教师、班主任、学生、家长。学生和家长是两个账号体系一个学生可以关联多个家长一个家长也可以关联多个学生。这种多对多的关联关系如果用一张user表加一个parent_child关联表来处理后续查「我的孩子列表」「某学生的家长列表」都很方便。核心表设计user_teacher 教师表 user_parent 家长表 user_admin 管理员表 student_parent 学生家长关联表 class_info 班级表教师和班级的关系是一对多一个班一个班主任一个教师可以带多个班。学生和班级的关系是多对一一个班 40 个学生。这几个关系如果建模错了做班级维度的统计时会非常痛苦。3.2 作业与课后服务两个最核心的业务表作业模块需要两张表作业表homework和作业提交表homework_submit。homework 表的核心字段我建议这么定字段类型说明idbigint主键class_idbigint班级IDteacher_idbigint发布教师titlevarchar作业标题contenttext作业内容attachment_pathvarchar附件路径deadlinedatetime截止时间statustinyint1进行中 2已截止homework_submit 表记录每一次提交包含 submitted_by、content、file_path、score、comment、submit_time。注意约束一个学生针对同一份作业只能提交一次要加唯一索引(homework_id, student_id)防止重复提交。课后服务模块是双减场景的独特之处两张表course 课程表和 course_registration 报名表。course 里要有 total_count、registered_count每次报名成功后 registered_count 加 1同时事务里用SELECT ... FOR UPDATE对课程行加锁避免超员。3.3 消息通知与成长档案系统消息这块我见过两种设计一种是所有消息存一张表字段里放 receiver_id另一种分主题每个功能模块有自己的通知表。对于这种体量的系统建议统一消息表。message - id - sender_id - receiver_id - title - content - type (1系统公告 2作业提醒 3课后服务确认 4留言) - is_read - create_time成长档案表特别适合做教师评语和历史成绩的节点记录表字段不需要多exam_name、subject、score、comment、record_date每个学期大概 10 条左右就够了。做统计时直接按学期聚合。数据表总数控制在 12 张左右是最舒适的区间既满足业务闭环又不会因为表太多导致后期维护加班到凌晨。4. 核心业务模块的实现逻辑4.1 作业管理发布、提交、批改的闭环作业管理是这个系统的门面功能演示时必须顺畅。我建议实现顺序按三步走教师发布作业、学生/家长端查看并提交、教师批改打分。第一步教师发布作业。表单包含班级选择、标题、内容、附件上传、截止时间。附件上传这里有个细节MultipartFile 存储路径不要放在项目目录下因为重新部署会丢失。我会配置一个外部路径比如/data/files/homework/文件名用UUID 原始文件名的后缀重命名防止重名。第二步提交作业。家长和学生端看到的是「待提交」状态列表。提交支持填写文字和上传附件。提交时要校验是否在截止日期内过了 deadline 后端直接返回错误码。这个场景其实非常适合用Transactional因为提交作业要同时更新 submit 表插入记录和 message 表生成通知。第三步教师批改。批改页展示已提交列表教师可以打分百分制和写评语。批改完成后成绩会实时同步到家长端家长在首页能看到最近一次作业评价。我强烈建议加上一个「作业完成率」的统计接口某份作业已交人数 / 班级总人数。SQL 写法是SELECT ht.id, ht.title, COUNT(hs.id) AS submitted_count FROM homework ht LEFT JOIN homework_submit hs ON hs.homework_id ht.id WHERE ht.class_id #{classId} GROUP BY ht.id4.2 课后服务选课并发报名与防超额课后服务模块最核心的难点不是 CRUD而是并发。一个班 40 个学生同时抢同一门课如果不加限制极有可能出现实际报名人数超过 total_count 的情况。处理逻辑分两层第一层在报名接口内加乐观锁校验。course 表加版本号字段 version执行更新时用UPDATE course SET registered_count registered_count 1, version version 1 WHERE id #{id} AND version #{version}如果更新影响行数为 0说明已被其他同学抢走返回「课程名额已满」。第二层在 course_registration 表上加唯一索引(course_id, student_id)就算事务并发漏到了数据库层也会因为唯一索引报错回滚。双保险之后超报问题基本杜绝。这里有一个实操心得自助选课成功后立即异步发送一条确认消息给家长。不要用同步发送因为如果消息模块偶发异常会导致报名整个失败。通过Async注解可以很优雅地解决。4.3 家校留言与通知公告留言模块的交互模式是「家长给班主任发消息班主任回复」。我设计的表是 message_reply每条留言挂 parent_id做了两级回复就够了不要做多级嵌套树开发成本和收益不成正比。通知公告分成两大类管理员发的全校公告和教师发的班级通知。发布班级通知时后端做「推模式」还是「拉模式」的设计选择——通知刚发布时可以给该班级全量家长各插入一条 message 记录推。班级人数少这样的写法简单直接查询快后续统计已读未读也直观。4.4 统计报表答辩时能加分的模块大部分学生做到这个功能就停止了其实加一个简单的统计模块非常抢眼。我建议做三个统计接口教师维度本月布置作业数、批改平均耗时班级维度本月作业提交率、课后服务参与率学生维度历史作业平均分、缺交次数接口返回聚合结果前端用柱状图展示不需要引入复杂的数据可视化组件ECharts 完全够用。统计模块在答辩现场结束时亮出来很多老师会对你的「业务深度」印象加深因为这说明你真的思考过数据怎么用而不只是做了个增删改查。5. 从0到1搭建开发环境并跑通项目5.1 环境清单与版本选择这类 Spring Boot 项目的环境选型我建议保守原则不追新版本选经过千锤百炼的稳定组合。组件推荐版本说明JDK1.8与大多数教材一致兼容性最好Maven3.6.x镜像用国内源MySQL5.7 或 8.05.7 最稳定8.0 需要注意连接驱动版本IDEIDEA 2023社区版足够Spring Boot2.7.x2.x 版本资料最多遇到问题好搜Spring Boot 2.7 对应 Spring Security 5.7配置方式和网上大多数教程一致遇到问题时 Stack Overflow 上随便一搜一大把对新手友好得多。Spring Boot 3 虽然性能更好但 SpringSecurity 6 的配置变化很大很多旧资料没法用不建议毕设阶段冒险。5.2 项目结构与核心配置我习惯的分层结构src/main/java/com/example/homework/ ├── controller # 控制层 ├── service # 业务层 ├── mapper # MyBatis 或 JPA 数据访问层 ├── entity # 实体类 ├── dto # 前端交互对象 ├── config # 配置类Security、WebMvc ├── util # 工具类JwtUtil、FileUtil └── aspect # 切面日志记录application.yml 里最关键的三个配置server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/homework_system?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/Shanghai username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 10MB max-request-size: 50MB mybatis-plus: mapper-locations: classpath:mapper/*.xml configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl这段配置我踩过太多坑了第一次写项目时数据库连接串忘了写serverTimezoneAsia/Shanghai导致插入时间数据总是和本地差 8 小时查了半天才发现是时区问题。5.3 数据库初始化与造数据拿到数据库脚本后不要直接一股脑执行。先看脚本里的建表顺序特别注意外键关联的表必须先建主表再建从表。如果脚本里有外键约束导入失败多半是顺序问题。初始化完结构之后一定要造一批「能讲故事」的演示数据。比如一个班级三年级二班35 个学生一个班主任账号teacher01 / 123456三个家长账号parent01 / parent02 / parent03两个学生关联到家长账号下已经发布并提交过 3 份作业且有批改成绩课后服务有 2 门课一门满员一门还有名额有了这些数据演示系统时每一步操作都有反馈不会被空列表卡住。5.4 启动项目与常见问题启动步骤很简单在 IDEA 里找到主类HomeworkApplication右键 Run。如果启动失败90% 是以下三种原因数据库密码不对报Access denied for user驱动没加载pom 里漏了 mysql-connector-java 依赖端口占用8080 被其它进程占了端口占用时使用netstat -ano | findstr 8080 taskkill /F /PID 你的进程号这个操作我每次给别人调环境时都会先检查一遍。6. 我调试这套系统时踩过的几个实实在在的坑6.1 日期错乱永远记着时区这个坑前面提过一次但忍不住再强调一遍。MySQL 的 JDBC 连接串里没有serverTimezone的时候你从LocalDateTime.now()存入数据库的时间和实际时间会差 8 小时。尤其在作业截止时间这个场景下一旦时区错了晚上的作业晚上 8 点提交数据库记录显示的是凌晨 4 点会导致家长端显示「逾期」。排查方法很简单先在 MySQL 命令行里执行select now();如果返回时间和本地时间不一致先把数据库时区纠正过来再看连接串。6.2 Lombok 和 JDK 版本打架项目里大量使用 Lombok 的Data注解省去 getter/setter。Lombok 版本如果太老配合新版 JDK 会出现「编译器无法解析 getter 方法」的奇怪问题。处理方案是pom 里 Lombok 版本不要自己瞎调直接使用 Spring Boot 父工程管理的版本或者显式指定 1.18.30 及以上。另一个问题是 IDEA 里必须安装 Lombok 插件并且开启 Annotation Processing否则代码里到处标红。6.3 跨域问题登录成功但请求数据拿不到前后端分离开发时前端跑在 8081后端跑在 8080默认会被浏览器的同源策略拦截。我见过太多学生卡在这个环节登录接口明明成功返回了 token但后续的请求全是 403。解决办法是在后端加一个全局 CORS 配置Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(*) .allowedMethods(GET, POST, PUT, DELETE, OPTIONS) .allowedHeaders(*) .allowCredentials(true) .maxAge(3600); } }同时注意 Security 配置里面放行 OPTIONS 预检请求否则跨域请求会先被 Spring Security 拦截返回 401。6.4 JWT 放请求头还是直接参数我建议放在Authorization: Bearer token请求头里。不要在 URL 上拼接因为 URL 会被记录到日志里token 就泄露了。另外前端 axios 配置拦截器时对 401 状态统一做处理不要每个请求手写判断否则代码可读性很差。实际操作中还有一个细节如果用户连续点按钮触发两个并发请求其中一个请求的 token 刚好过期后端返回 401 后前端就跳登录页。用户体验很差。所以前端拦截器的逻辑我做了优化401 时先不发跳转等待 1 秒如果同时有其他请求也拿到了 401只执行一次跳转。这个小细节写进项目说明里演示时会显得你考虑得很周全。6.5 静态资源访问与文件存储上传的作业附件、教师头像之类的文件如果保存在项目本地重新部署就没了。我建议配置文件服务器映射把本地的/data/files/目录通过 WebMvc 配置映射到 URL 路径/files/**上Configuration public class WebMvcConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/files/**) .addResourceLocations(file:/data/files/); } }这样前端展示附件图片时直接用/files/xxx.jpg就能访问不经过后端控制器带宽压力小、实现也简单。最后再分享一点我的建议这套系统从开始搭骨架到完整跑通正常节奏是两周左右第一周搞定数据库和核心后端接口第二周做前端页面和联调。如果你是做毕设一定要把「双减」这个业务背景吃透答辩时老师大概率会问为什么这个系统是必须有而不是可有可无把「课后服务管理」和「作业减量提质」这两条业务线讲清楚比单纯背技术点有用得多。整个项目做下来我的经验是管理系统的难度从来不在某个技术难点上而在「边界意识」——权限边界、数据边界、状态边界。把每种角色能做什么、每个数据字段从哪来到哪去都理清楚代码自然就清晰了。这套系统的扩展方向也很明确接入短信或微信模板消息做通知触达、把课后服务的出勤记录做成自动签到、再加一个在线支付的缴费模块就是一个可以直接进校试用的完整产品了。