基于SpringBoot和微信小程序的家校交流系统开发实战

每年到毕业设计季总能收到大量私信“学长我的题目是‘基于SpringBoot的两河学校家校交流微信小程序’该从哪里下手”这个题目看起来平平无奇但真正做起来方向选错的人特别多。有人把它做成了仿微信群聊有人一上来就堆了一堆聊天室接口结果数据库建了十几张表最后答辩时被老师一句“这和微信群有什么区别”问得说不出话。这篇文章我不讲客套话直接把这套系统的需求和实现拆开揉碎。项目本身不复杂核心就是利用SpringBoot做后端接口服务用微信小程序做家长和老师之间的信息桥梁。它的重点从来不是“聊天”而是“通知、作业、成绩、请假、班级关系”这几条业务线的闭环。我会从需求边界、技术选型、数据库设计、登录权限、接口实现一直写到小程序上线的坑适合正在做类似毕设题目、或者想了解家校类小程序完整开发流程的同学参考。1. 先看清“家校交流”四个字的真实需求它不是聊天软件1.1 这个项目的本质是“信息分发”不是“即时通讯”很多同学看到“交流”二字就直接奔着聊天功能去了做了个类似微信的单聊群聊模块然后发现越做越复杂——消息表、会话表、未读表、ws推送……工作量爆炸而且和微信自带功能严重重合做完没有说服力。我曾经带一个学生做过两次类似题目第一次就是栽在“聊天”上第二次重新梳理需求后彻底想通了学校环境里的“家校交流”实际上是一种低频、单向为主、偶尔双向确认的信息流。老师发一条国庆放假通知家长收到并点击“确认”老师布置一道数学作业家长拍照上传完成情况孩子请假家长提交申请班主任审批。这些场景里核心动作是“发布—触达—反馈”不是“实时对话”。所以这个系统最合理的定位是班级维度下的消息发布与业务办理平台。把通知、作业、成绩、请假这几个高频场景做扎实比做一个半吊子聊天室有价值得多。1.2 三类角色和三类典型使用场景系统使用角色一般只有三类家长、老师、系统管理员。老师内部还可以再区分班主任和任课老师但权限模型不需要分得太细用角色字段加一个“是否班主任”标记即可。我建议按下面这张表来定义场景角色核心诉求典型操作家长及时获取孩子在校信息查看通知、查收作业、查询成绩、提交请假班主任统一管理班级信息发通知、布置作业、导入成绩、审批请假任课老师对自己所教科目负责布置本学科作业、上传本学科成绩管理员维护基础数据管理年级班级、分配账号、重置绑定这里有个容易被忽略的点入参“班级”不能直接暴露给前端乱传。家长只看得到自己孩子的班级老师只操作自己任教的班级不然越权漏洞一个接一个。这个后面展开讲它在数据库设计和接口设计里都有体现。1.3 功能模块怎么切割骨架、加分项、勇敢砍掉毕设有时间限制功能不是越多越好。我按“必须做、建议做、再不济就砍掉”三层来归类必须做通知公告、家庭作业、成绩查询、请假审批、班级通讯录、个人中心。建议做作业打卡/完成回执、通知签收统计、家长留言或反馈、系统消息订阅。尽量砍掉实时单聊群聊、朋友圈式班级圈、音视频通话、复杂课表。班级圈如果时间充裕可以做但它的价值远不如“通知签收”大。老师最头疼的事情是不知道家长到底看没看到通知所以“已读/未读统计”反而是一个很讨巧的亮点功能答辩时能拿出来讲。2. SpringBoot 技术选型与版本搭配为什么我坚持这套组合2.1 SpringBoot 2.7.18 比 3.x 更适合毕设项目先给结论如果你的毕业设计没有明确要求必须用最新版SpringBoot 选 2.7.18Java 选 JDK 1.8 或 JDK 11。原因很实际。SpringBoot 3.x 最低要求 JDK 17网上能找到的教程、博客、踩坑案例大部分还是基于 2.x 写的。你用 3.x 万一遇到兼容性问题搜不到现成答案又赶上答辩时间紧会非常被动。2.7.18 是 2.x 系列的最后一个维护版本稳定而且对老教程兼容性好。这里有个真实的教训有一年我带的学生用 IDEA 初始化项目时Spring Initializr 默认选了 SpringBoot 3.1.2结果引入 MyBatis-Plus 后发现版本对不上一直报Invalid bound statement。查了半天才发现是 mybatis-spring 和 SpringBoot 3 的集成方式变了。后来退回 2.7.18十几分钟就全部跑通。建议的 pom 依赖组合parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency dependency groupIdcn.hutool/groupId artifactIdhutool-all/artifactId version5.8.22/version /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt/artifactId version0.9.1/version /dependency /dependenciesHutool 不是必须的但它的 HttpUtil、DateUtil、IdUtil 能省很多事尤其是调用微信 code2Session 接口时有它就不用写一堆原生 HttpClient 了。2.2 MyBatis-Plus 不是偷懒是帮你把重复劳动砍掉有些导师听到 MyBatis-Plus 会觉得“你是不是不会写 SQL”我一般建议学生这样解释MyBatis-Plus 负责单表 CRUD多表关联和复杂统计仍然手写 SQL。这样既省时间又能体现 SQL 能力。它最大的价值是内置分页插件和逻辑删除。毕设里所有列表接口基本都要分页selectPage一行搞定用户数据不硬删除用TableLogic注解标记逻辑删除操作简单又安全。另外代码生成器强烈建议用起来User、Clazz、Notice、Homework 这些单表的 Entity、Mapper、Service、Controller 一次生成省下来的时间拿去画时序图、写文档性价比很高。2.3 Redis 不是用来炫技的只解决一个痛点登录状态共享小程序无状态、后端多实例如果用传统 Session每次重启服务或者多实例部署时登录状态就丢了。所以用 Redis 存 token简单可靠。但毕设不需要做得太重流程是这样的用户登录后后端生成一个随机 token 字符串以token为 key用户ID为 value存入 Redis设置过期时间为 7 天前端把它存到小程序的wx.setStorageSync里每次请求放在 header 的Authorization字段后端拦截器每请求校验一遍。这样实现清晰答辩也好讲。3. 数据库设计班级-学生-家长-老师的关系必须一次理顺3.1 用户表设计单表加角色不拆三张表有些设计喜欢拆 user、parent、teacher、student 四张表看着很正规实际用起来全是 JOIN权限判断到处绕。我建议一张user表存登录主体搭配student和teacher两张扩展表。user表核心字段字段类型说明idbigint主键openidvarchar(64)微信小程序登录唯一标识phonevarchar(20)手机号微信授权获取roletinyint1家长 2老师 3管理员nicknamevarchar(50)昵称avatarvarchar(255)头像地址bind_statustinyint绑定状态0未绑定 1已绑定deletedtinyint逻辑删除老师的信息比如工号、入职时间放teacher表学生的信息比如学号、姓名、班级ID放student表。家长和学生之间是多对多关系用parent_student关联表记录“哪个家长负责哪个孩子”因为一个家长可能有多个孩子一个孩子也可能绑定了父母双方。3.2 班级关系的三张核心表班级体系涉及三张表class_info、teacher_class、student。class_info就是班级表字段简单id、年级、班级名称、班主任ID、入学年份。这里班主任ID可以直接存查询班级详情时免一次关联。teacher_class是老师与班级的任教关系表因为一个老师可能教多个班一个班也有多门课的老师。字段为id、teacher_id、class_id、subject科目、type1班主任 2任课老师。这套结构能把“查询某个老师教的全部班级”和“查询某班所有老师”都变成简单 SQL。数据关系理顺后接口设计就顺了。比如家长端首页要显示“孩子所在班级的最新通知”SQL 链路是parent_student查出孩子的 student_id → 从 student 表取出 class_id → 按 class_id 查通知列表。这条链路必须在后端完成不能信任前端传 class_id。3.3 四张业务表通知、作业、成绩、请假这四张表是整个项目的核心字段设计得越细后面写接口越省事。通知表noticeid、class_id、title、content、publisher_id、publish_time、attachment_url区分“全校通知”和“班级通知”class_id 为 0 表示全校否则是班级定向。加一个is_top置顶字段排序时ORDER BY is_top DESC, publish_time DESC。作业表homeworkid、class_id、subject、title、content、teacher_id、deadline、create_time每日作业按班级存储。如果还要做“完成反馈”再加一张homework_submit表id、homework_id、student_id、content、images、submit_time、status。这里有个设计小心机作业发布时间存deadline家长端列表展示时可以直接算出“还剩几天”这个字段在前端很出效果。成绩表scoreid、student_id、subject、exam_name、score、class_id、is_publish、create_time成绩是敏感数据建议先存后发布。老师录入时is_publish0只有确认后才置为 1家长才能查到。这个逻辑答辩时讲出来很加分因为体现出了“权限管控意识”。请假表leave_requestid、student_id、class_id、type事假/病假等、start_time、end_time、reason、status、teacher_comment、create_time请假的关键是状态流转建议用 tinyint 表示0待审批、1已通过、2已拒绝、3已销假。每次变更要填update_time便于追溯。3.4 建表时容易忽略的坑所有表都加 create_time 和 update_timeMyBatis-Plus 的字段填充可以自动维护。不要用 timestamp 存日期学生请假结束时间、作业 deadline 建议用 date、datetime避免时区问题。status 这类枚举字段写注释不然三个月后回来看自己都忘了 0 和 1 代表什么。外键不要加到数据库层面用逻辑关联。毕设系统并发低不需要数据库级外键约束免得不小心删数据时被外键卡住。4. 微信登录、身份绑定与权限控制一条链路解决掉“你是谁、能看什么”4.1 wx.login 只是开始openid 对应不了真实身份微信小程序的登录流程看起来简单wx.login拿 code后端用 code 调微信接口换 openid 和 session_key。但这里有个关键问题openid 只能证明“这是同一个微信用户”证明不了他是哪个孩子的家长、哪门课的老师。所以登录必须拆成两步静默登录小程序启动时调用wx.login后端拿到 openid 后查询 user 表。查不到说明是新用户返回一个“未绑定”标记前端跳转到绑定引导页。查到了且 bind_status1直接签发 token进首页。身份绑定新用户引导页里家长用微信手机号快捷授权再填写学生学号或者扫班级码完成绑定老师由管理员在后台导入或分配账号后微信手机号和 openid 进行关联。后端调用微信接口换 openid 时直接让 Hutool 的 HttpUtil 发 GET 请求String url https://api.weixin.qq.com/sns/jscode2session? appid appid secret secret js_code code grant_typeauthorization_code; JSONObject json JSONUtil.parseObj(HttpUtil.get(url)); String openid json.getStr(openid); String sessionKey json.getStr(session_key);这里有个操作细节appid 和 secret 不要硬编码在代码里放到 application.yml提交代码时记得把真实 secret 替换掉。每年都有学生不小心把微信小程序密钥传到 GitHub导致后台被恶意刷接口。4.2 手机号授权新版接口和旧版不一样别踩版本坑2023 年后微信小程序对手机号快速验证组件做了调整现在推荐使用button的open-typegetPhoneNumber配合getPhoneNumber事件拿到 code 后再传给后端调用phonenumber.getPhoneNumber接口解密手机号。后端拿到手机号后不要急着创建用户。先拿手机号去 user 表查一下查到且角色明确 → 更新 openid 和 token完成绑定。查不到 → 返回提示“该手机号未在系统中登记请联系管理员”。这是我实际做过的最稳妥的方案。之前我见过有人设计成“家长自己注册账号”最后产生一堆垃圾用户老师根本分不清谁是谁。家校系统必须由学校或老师先维护好学生、家长的手机号名单家长只做“匹配”而不是“注册”。4.3 用拦截器 注解做权限控制比每个方法手写判断优雅得多后端接口没有权限控制就等于裸奔。最简单的做法是写一个 Spring 拦截器统一做 token 校验再通过注解标记接口需要的角色。拦截器核心逻辑public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (!(handler instanceof HandlerMethod)) { return true; } HandlerMethod method (HandlerMethod) handler; if (method.hasMethodAnnotation(PassToken.class)) { return true; } String token request.getHeader(Authorization); if (StrUtil.isBlank(token) || !redisTemplate.hasKey(login:token: token)) { throw new BusinessException(请先登录); } LoginUser user (LoginUser) redisTemplate.opsForValue().get(login:token: token); UserContextHolder.set(user); return true; }然后再写一个RequireRole(role RoleConstant.PARENT)注解在 Controller 方法上标注访问角色。后台用 AOP 或者再写一个拦截器判断都行原理一样。这样接口层的权限逻辑很干净。UserContextHolder是一个本地 ThreadLocal 工具类保存当前请求的用户信息。后面所有接口要判断“当前家长的孩子是谁”“当前老师教的班是哪个”都从这里取不要从前端参数里取。5. 高频接口的细节实现成绩、作业、请假里最容易踩的坑5.1 查询作业列表班级范围必须由后端推导不能信任前端参数家长端首页有个常见功能展示当前孩子的作业列表。初学者最容易写出的危险接口是GetMapping(/homework/list) public Result list(RequestParam Long classId) { return Result.success(homeworkMapper.selectByClassId(classId)); }问题在于把 classId 当前端传参那家长把自己的 classId 改成别的班不就查到别的班作业了正确的做法是先从UserContextHolder里取出当前登录用户再根据用户角色推导班级。家长角色要先查parent_student找到孩子再查student表拿到 class_id老师角色则检查 classId 是否存在于自己的teacher_class表里不存在就抛异常。运行时写两个工具方法public ListLong getParentClassIds(Long userId) { // 查 parent_student - student - class_id } public ListLong getTeacherClassIds(Long userId) { // 查 teacher_class }这样接口里不再有“越权”的可能答辩时也能直接说所有班级维度数据都做了归属校验。5.2 成绩查询家长看孩子班主任看全班但都要有“已发布”限制成绩模块的隐私性最强。家长接口返回单科成绩即可建议用 DTO 而不是把整张实体表直接返回。Data public class ScoreVO { private Long studentId; private String studentName; private String examName; private String subject; private BigDecimal score; private String klassName; }班主任接口需要看全班成绩时除了基础列表还可以加一个统计接口班级平均分、最高分、最低分、分数段分布。这样页面展示更丰满也体现出你的 SQL 聚合能力。比如查询班级某次考试某科目的平均分SELECT AVG(score) FROM score WHERE class_id #{classId} AND exam_name #{examName} AND subject #{subject} AND is_publish 1有个细节必须提醒未发布的成绩只能老师自己可见。所有家长端成绩查询 SQL 都必须带is_publish 1条件。如果漏了等于把老师还没核对的成绩泄露给了家长绝对算重大事故。5.3 请假审批状态机写清楚才不会出现“已拒绝还能销假”的逻辑漏洞请假模块的业务规则其实是个简单的状态机家长提交 → 状态 0等待审批。班主任审批通过 → 状态 1拒绝 → 状态 2。如果通过后请假时间已经过去家长可以操作“销假” → 状态 3。限制条件只有状态为 0 时可以审批。只有状态为 1 时可以销假。拒绝时老师必须填写理由前端展示用。接口设计时校验状态的操作要放到事务里。一个简单的效验方法Transactional(rollbackFor Exception.class) public void approve(Long leaveId, Long teacherId, Integer result, String comment) { LeaveRequest leave leaveRequestMapper.selectById(leaveId); if (leave null || !leave.getStatus().equals(0)) { throw new BusinessException(当前请假单状态不允许审批); } // 校验 teacherId 是否有权审批该班级 ... leave.setStatus(result); leave.setTeacherComment(comment); leaveRequestMapper.updateById(leave); }如果项目里用了 Redis审批操作后可以考虑删除对应缓存保证数据一致性。毕设规模不大不引入消息队列也是完全合理的。6. 微信小程序端最容易拖后腿的几件事订阅消息、图片上传、提审材料6.1 一次性订阅消息解决“通知触达”但别跟微信的规定较劲家长最需要的是“老师发通知时我能收到微信提醒”。微信小程序提供订阅消息能力但只有一次性订阅消息而且是用户主动授权一次才能发一次。这个限制很让人头疼。我的落地思路是老师在发布通知前点击页面上“提醒家长查看”按钮调用wx.requestSubscribeMessage。但是这里有个问题老师授权后发送对象是家长所以应该是在家长端做授权。家长端可以在设置页放一个“接收通知提醒”按钮点击后向微信申请一次订阅授权。后端把这个授权次数存到 Redis比如 key 为subscribe:count:{parentId}值为可用次数。当老师发通知、作业或成绩发布后后端发送订阅消息时先查这个次数次数大于 0 就调微信接口发送并扣减次数次数为 0 就跳过不影响主流程。这样实现虽然不能做到“无限推”但至少保证家长主动开启了通知后能收到一些关键提醒。答辩时如果有人问“为什么不能像公众号那样随意推送”你就能解释微信的订阅消息授权机制这是加分的点。后端发送订阅消息核心代码示意String accessToken getAccessToken(); // 从 Redis 中获取定时刷新 String url https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token accessToken; JSONObject body new JSONObject(); body.set(touser, parentOpenid); body.set(template_id, templateId); body.set(page, pages/notice/detail?id noticeId); JSONObject data new JSONObject(); data.set(thing1, new JSONObject().set(value, noticeTitle)); data.set(date2, new JSONObject().set(value, dateStr)); body.set(data, data); HttpUtil.post(url, body.toString());6.2 图片上传wx.uploadFile 必须处理并发和服务器路径作业反馈、请假凭证都涉及家长上传图片。小程序端用wx.chooseMedia选择图片然后用wx.uploadFile传给后端。容易出问题的点有三个并发限制一次选多张图时如果循环里同时发起多个wx.uploadFile手机上经常出现部分请求失败。稳妥做法是控制并发数比如每次同时最多上传 3 个或者按顺序逐个上传。后端保存路径开发时可以存到本地磁盘但上线后本地路径很难访问。建议后端配置一个静态资源映射或者直接用一个独立域名映射到上传目录。nginx 配置类似location /uploads/ { alias /data/school-app/uploads/; }大小限制SpringBoot 默认单文件上传限制是 1MB需要自己调大spring: servlet: multipart: max-file-size: 10MB max-request-size: 20MB不调大这个配置家长传一张手机照片都会报错而且报错信息还不直观。6.3 小程序提审前先解决类目、隐私协议和备案很多学生项目做到最后代码没问题卡在上线审核上。我重点提醒三件事第一小程序类目要选“教育 教育信息服务”或者其他匹配类目。如果选了电商或工具类审核大概率不过。第二隐私协议必须写清楚收集了哪些信息。这个项目收集用户手机号、微信头像昵称、位置可能涉及学校定位在“小程序后台-设置-服务内容声明-用户隐私保护指引”里要逐项勾选并说明用途。从 2023 年起微信对未经声明就调用隐私接口的审核更加严格。第三服务器域名必须是 HTTPS。开发时可以关闭域名校验但提交体验版和正式版时必须把后端域名加到小程序后台的 request、uploadFile 合法域名里且证书要有效不能用自签名证书。我见过一个学生因为贪便宜买了一个没有证书的服务器结果小程序一直报request:fail最后重新换了域名才上线。域名和备案这件事最好在项目开发早期就处理不要拖到最后。6.4 关于 iOS 和安卓的网络差异调试时多留个心眼小程序开发中一个很常见的现象是安卓手机正常iOS 上网络请求偶尔失败。错误信息里如果出现handshake failed due to invalid upgrade header: null多半是服务器对 WebSocket 或 HTTP 升级头处理有异常。如果项目不涉及 WebSocket可以不用管但如果出现这种报错先确认后端是 HTTPS、证书完整、且没有额外的网关干扰。另一个 iOS 上的坑开发调试时如果开启了“不校验合法域名”在 iOS 真机上经常不稳定。建议尽快把正式域名配置好别在真机预览阶段浪费太多时间。最后分享一点过来人的经验这类项目真正花时间的不是增删改查而是把“家长只能看自己的孩子、老师只能管自己的班级”这条权限线理清楚。数据模型只要按班级、用户、关联表三层来设计后面所有功能都能快速堆出来。我自己做完这个项目后的体会是演示数据比代码更重要。答辩前一定要准备一套完整的演示数据——至少三个班、每个班一个班主任、两个任课老师、五位家长、八个学生、十条通知、五份作业、两次考试成绩、三条请假记录。这样演示的时候页面不会空荡荡老师看起来也更有代入感。如果时间允许再准备一个管理员后台的录屏展示如何导入学生名单、如何给老师分配班级整个项目的完整度和说服力会提升一个档次。