★ FEATURED ARTICLE 1. 项目概述与核心需求拆解1.1 这个系统到底解决什么问题第一次看到java springboot基于微信小程序的智慧校园系统学生选课程学习这个标题时我心里其实很清楚这又是一套典型的毕业设计级全栈项目但它和市面上那些图书管理班级管理类的老掉牙题目有本质区别——它把选课和课程学习两条线打通了而且前端跑在微信小程序里后端是SpringBoot单体应用。很多同学或者刚入行的开发者拿到这种项目第一反应是我去又要写前端又要写后端还有小程序怎么搞。但实际上这类智慧校园选课系统的核心并不复杂它本质上就是一个带权限控制的业务管理系统只是业务场景从管库存换成了管课程、管选课、管学习记录。从标题里的关键词可以拆出几层需求学生端功能通过微信小程序浏览课程列表、查看课程详情、在线选课、退选、查看已选课程、进入课程学习视频/文档、记录学习进度、查看成绩或学分。管理端功能管理员维护课程信息增删改查、管理学生账号、审核选课、发布成绩、统计选课数据。技术场景SpringBoot提供RESTful API微信小程序负责展示与交互数据持久化走MySQL前后端通过JSON通信。这套系统的典型应用场景是高校、职校的选修课管理也可以下沉到培训机构或在线学习平台。它的价值不在于某个单点功能多炫酷而在于完整走通了学生认证 → 课程浏览 → 选课 → 学习 → 记录/评分这条闭环链路。1.2 为什么是SpringBoot加微信小程序先说后端。SpringBoot在当前Java生态里几乎是入门和中小型项目的默认首选理由很朴素内嵌Tomcat打包成Jar就能跑不需要单独装容器Spring Data JPA或MyBatis整合数据库CRUD写起来极快Starter机制让依赖管理变得傻瓜化加依赖就是加一个Maven坐标自带监控、日志、异常处理体系调试成本低选它做智慧校园后端说白了就是快且稳而且网上资料铺天盖地遇到问题搜得到答案。对一个课程设计或者个人练手项目来说这是巨大的隐性优势。再说前端。微信小程序的好处不用我多说——用户零安装、即开即用学生扫个码就能进系统选课不需要下载App也不用记住网页地址。而且微信自带登录能力省掉了传统的账号密码注册流程虽然业务上最好还是要绑定学号。这套组合的爽点在于小程序端只负责UI和交互所有业务逻辑全部由SpringBoot后端统一处理数据模型清晰、职责分离。真出问题的时候定位也容易——页面不显示就查小程序端的数据绑定接口报错就打开后端日志边界非常清楚。2. 系统核心模块与功能设计2.1 用户角色与权限模型任何系统先定角色再定权限最后才写代码这是我一贯的做法做选课系统也一样。这套系统里的主体角色有两个学生通过微信小程序端使用系统核心操作是浏览课程、选课、退课、查看学习内容。这个角色是系统的中心所有功能设计都围绕学生的使用动线展开。管理员负责课程的上架下架、学生管理、成绩录入、选课数据处理。管理员不需要在小程序里操作用后台管理页面通常是一套简单的Web管理端就够了。有的项目还会拆出教师角色让教师发布课程和成绩。但从标题来看核心是学生选课程学习所以教师功能属于延展项基础版本不要贪多把学生和管理员两条线做扎实就足够了。权限控制在实现层面的核心是接口的鉴权。小程序端登录后每次请求要带上登录凭证通常用Token或Session后端做拦截器判断当前请求来自谁、有没有权限操作这个资源。这里有个很多初学者会踩的坑只校验了是否登录没校验操作人是不是资源主人。举例来说学生A不应该能查看学生B的选课记录更不能替B退课——这种归属校验必须写进业务逻辑里否则就是严重的越权漏洞。注意权限校验不能只在前端做前端的隐藏按钮仅仅是美观需要后端接口必须做独立的权限判断。否则别人直接构造请求就能越权操作这是技术面试时最容易被追问的点。2.2 学生端的选课学习闭环学生端的核心链路可以拆成四个环节这也是小程序页面的功能地图第一环微信授权登录与学号绑定小程序端点击登录先走微信的wx.login获取临时code然后传给后端后端拿code去微信接口换openid并根据openid查询本地用户表。首次进系统的学生需要绑定学号姓名——这一步很重要因为仅凭微信openid无法对应到真实学生身份必须让用户输入学号做一次绑定后续就能直接用openid自动登录。第二环课程大厅与课程详情小程序首页展示课程列表可按课程分类筛选、按课程名搜索。课程详情页展示课程的简介、封面图、课时、授课教师、选课人数、剩余名额。要注意一个细节课程状态分为未开始选课、选课中、选课结束、已结课不同状态下学生可以执行的操作完全不同。比如选课结束的课程只能查看详情不能提交选课。第三环选课与退课选课是整个系统里业务逻辑最重的点需要同时校验好几件事课程是否处于选课中状态当前学生是否已选过这门课不能重复选课程选课人数是否已满选课时间是否与已选课程冲突退课相对简单只要课程还在退课截止时间之前且选课记录存在就可以退退课后名额释放。第四环课程学习与记录选课成功的学生可以进入我的课程点开一门课查看课程章节列表每个章节关联一个学习内容视频或图文学生观看/阅读后系统记录学习状态。这块通常有一个进度字段比如已完成和未完成全部章节完成后可以把课程标记为已学完。2.3 管理后台的功能颗粒度管理后台最怕大而全却没重点一套课程设计式项目管理端只需要做好四件事课程管理发布新课程、编辑课程信息、设置选课时间区间和容量上限、上架下架。批量导入课程这个功能可以加分用Excel模板带字段解析导入后校验再入库。学生管理查看学生列表、重置绑定状态、手动新增学生账号。某些情况下学生换手机号或者微信绑定错误需要管理员介入。选课管理查看所有选课记录、按课程或学生查询、教师手动给学生补选课程、删除异常选课记录。成绩与统计录入学生成绩、按课程统计选课人数、按学院统计选课率。这块还能做数据可视化比如用ECharts画选课热门课程Top10的条形图。管理端的技术实现一般是另一个SpringBoot模块加Thymeleaf或Vue前端页面。如果项目时间紧直接用SpringBoot的模板引擎渲染后台页面也是可行的虽然交互糙一点但胜在开发快、没有任何前后端分离的联调成本。3. 数据库设计与核心实现思路3.1 核心表结构设计选课系统的数据库设计不需要很花哨但表关系必须清楚。我会建这几张表student学生表主键ID、学号、姓名、学院、专业、微信openid、绑定状态、创建时间。course课程表主键ID、课程名称、课程编号、授课教师、课程简介、封面图URL、上课时间用于冲突检测、选课开始时间、选课结束时间、容量上限、已选人数、状态。course_select选课记录表主键ID、学生ID、课程ID、选课时间、退课时间、状态已选/已退、成绩字段。这张表是业务核心表学生和课程是多对多关系通过中间表解耦。course_chapter章节表主键ID、课程ID、章节标题、章节序号、学习材料类型视频/文档、材料URL。属于课程的子表一门课多个章节。study_record学习记录表主键ID、学生ID、章节ID、学习状态未完成/已完成、完成时间。记录某个学生看了某个章节没有。notice公告表主键ID、标题、内容、发布时间。用于系统给所有学生推送选课通知。一个需要注意的设计点是课程表里的已选人数这个字段其实就是选课记录表里按课程ID做COUNT查询的缓存。维护这个字段的意义在于列表页展示选课进度时不需要实时COUNT聚合直接读累计值就可以性能会好很多。但缓存字段最怕数据不一致后面我会讲怎么在事务里保证它。课程表里的选课时间冲突检测也值得提前设计。一般高校的选修课时间格式是周一第3-4节系统需要把课程的上课时间存成结构化字段。简单做法是存星期几和节次日两个字段比如weekday1, period3, period_num2表示周一第3节起共2节。选课前用这两个字段与已选课程做交集判断即可查冲突。3.2 选课接口的事务与并发控制选课接口是这个系统里最需要认真写的代码没有之一。核心流程是1. 校验课程存在且状态是选课中 2. 校验学生没有选过这门课 3. 校验课程未满员已选人数 容量上限 4. 校验时间不冲突 5. 生成选课记录已选人数加一前四条扣下来最后一步看起来很简单实则藏着最大的坑并发下超选。假设课程容量是100目前已经选了99人而第100和第101个学生同时点了选课。如果第5步不做保护两个人都会选课成功最后数据库里变成101条选课记录超出容量。解决这个问题的思路有三条数据库层面在学号和课程ID的组合列上建唯一索引让重复选课在数据库层面直接失败。这一步必须做因为它是最后一道兜底防线。但光有这个还不够它只能防同一个学生重复选防不了两个不同学生同时抢最后一个名额导致超容。行级锁在更新course表的已选人数时用UPDATE course SET selected_count selected_count 1 WHERE course_id ? AND selected_count capacity这类带条件的原子更新数据库会锁住这行如果条件不满足更新影响行数为0程序据此判断选课失败并回滚事务。这个方案是SpringBoot单体应用下最简单有效的。分布式锁如果是微服务集群部署多个节点同时处理选课请求上面的行级锁依然有效因为锁在数据库层跨节点依然生效所以实际中单体应用不需要额外引Redis做分布式锁。如果团队非要引入分布式锁那锁粒度必须加在courseId上不要用全局锁。我在实际项目中还踩过一个更隐蔽的坑事务里先查再判再更新的读改写操作。比如代码写成先SELECT已选人数判断未满再UPDATE已选人数1两个并发事务都会读到同一个旧值判断都通过然后各自加一结果超容量。所以必须把条件更新合成一句原子UPDATE而不是拆成SELECT和UPDATE两步走。3.3 小程序与后端的认证方案选型小程序端如何携带用户身份访问后端有两种主流方案方案一传统Session Cookie。小程序请求自动携带Cookie后端用Session记录登录态。实现简单但Web端的跨域配置在小程序里反而几乎没有跨域问题小程序不是浏览器所以这个方案是可行的。方案二Token认证推荐。用户登录后后端返回一个Token可以是JWT也可以是随机UUID存Redis小程序端把它存到storage里每次请求放在Header的Authorization字段。后端拦截器解析Token拿到用户ID放入请求上下文。这个方案利于后续扩展App或Web端无状态、可横向扩展。我推荐方案二因为它在项目答辩里可讲的点更多Token过期机制、无状态认证、Redis缓存会话这些词听起来都更专业。实现上也很简单登录成功生成Token存Redis并设置过期时间比如2小时拦截器里校验Token存在且有效把用户信息注入ThreadLocal。每次请求不用都查数据库Redis查询快得多。小程序端要注意Token的续期问题。微信小程序不像Web端有Cookie自动管理Token过期后需要重新登录。体验好的做法是封装统一的request方法后端返回401时自动刷新Token调用刷新接口或静默登录这样用户感知不到登录态中断。大部分课程设计级的项目不会做这个但做了就属于明显的加分项。4. 项目环境搭建与关键功能实操4.1 从零开始的运行准备拿到源码之后第一步是把环境跑通。我来梳理一下标准步骤照着做就行。后端环境SpringBoot项目安装JDK 8或11项目如果是新版本可能用17看pom.xml里java.version字段安装Maven 3.6配置国内镜像源阿里云否则下载依赖能等到花开花落安装MySQL 5.7或8.0建一个数据库比如叫smart_campus然后导入项目里自带的SQL文件。这里要留意SQL文件里的utf8mb4字符集设置不然中文数据容易乱码打开application.yml改三项核心配置数据库连接地址、账号、密码。如果Redis也用了Redis的连接配置同样要改项目根目录执行mvn spring-boot:run或者用IDEA直接启动Application主类。看到Started Application in x seconds就说明后端起来了小程序端环境下载微信开发者工具导入项目里的mini-program或miniprogram文件夹在project.config.json或app.js里修改appid为测试号或自己的小程序appid个人开发者可以注册认证后用自己的也可以临时用测试号在全局配置或request工具类里把接口基础地址改成localhost对应的后端地址。注意微信开发者工具里本地调试必须勾选不校验合法域名否则无法访问本地接口编译运行模拟器里就应该能看到登录页管理后台如果有如果是Vue项目npm install然后npm run serve如果也是SpringBoot模板页面那直接访问后端服务的某个端口路径就行。我用Maven本地仓库依赖比了多个环境对新手最稳的组合是JDK 8 SpringBoot 2.x MySQL 8.0 微信开发者工具稳定版。这个组合的坑最少、资料最多千万别一上来就折腾SpringBoot 3.x和JDK 17Java 17的模块化限制和Jakarta命名空间迁移会把实时复杂的项目搅得更乱。4.2 核心接口与请求链路实操我按业务流梳理一遍关键接口这些是系统的命脉理解了一个项目就通了六成。为了方便对照接口约定用RESTful风格统一返回JSON结构{ code: 200, message: success, data: {} }登录相关POST /api/auth/login入参是微信code可能还有学号、姓名用于首次绑定后端换取openid后返回Token和用户信息课程相关GET /api/course/list课程分页查询支持条件筛选分类、关键词、状态GET /api/course/{id}课程详情含章节列表POST /api/course管理员新增课程PUT /api/course/{id}管理员更新课程选课相关POST /api/student/course/select入参courseId执行选课逻辑POST /api/student/course/cancel入参courseId执行退课逻辑GET /api/student/course/selected查询当前学生的已选课程列表学习相关GET /api/student/course/{courseId}/chapters获取课程章节POST /api/student/chapter/complete入参chapterId标记章节已完成管理端相关GET /api/admin/select/list查询所有选课记录POST /api/admin/select手动补选PUT /api/admin/score录入成绩小程序端的请求封装建议统一放在一个utils/request.js文件里在这里面做三件事拼接基础URL、附上Token到Header、统一处理HTTP 401跳转登录。这样每个页面只管调用不用操心认证逻辑。// utils/request.js 核心封装伪代码 function request(path, method, data) { const token wx.getStorageSync(token) return new Promise((resolve, reject) { wx.request({ url: baseUrl path, method: method, data: data, header: { Authorization: token }, success: (res) { if (res.data.code 200) { resolve(res.data.data) } else if (res.data.code 401) { // Token过期跳转到登录页 wx.navigateTo({ url: /pages/login/index }) } else { wx.showToast({ title: res.data.message, icon: none }) reject(res.data) } }, fail: reject }) }) }4.3 管理端页面的功能落点后台管理页面建议按菜单划分左侧导航一个菜单对应一个功能模块。课程管理列表页一般有搜索框、新增按钮、编辑/删除操作列。新增课程需要考虑一个很实际的问题课程封面图片怎么上传。在线教育平台里封面无处不在。SpringBoot实现文件上传不难Controller里加MultipartFile参数保存到本地或OSS就行。但本地保存要注意重启服务后静态资源路径要配置映射确保图片能在浏览器访问。如果不想搞文件存储也可以让用户直接填图片的URL链接省事归省事但管理体验会差一截。成绩录入是另一个容易做崩的模块。学生选了课学习完之后老师要打分成绩怎么挂常见的做法是在选课记录表course_select里加一个score字段管理员通过选课管理 → 搜索某课程 → 录入每个学生的成绩维护。页面上做成一排行内编辑框旁边加保存按钮数据量小的时候这是个非常直观的设计。统计页面建议用ECharts的柱状图展示热门课程Top10、各学院选课人数排行。数据来源都从选课记录表和课程表聚合查询SQL里用GROUP BY课程ID和COUNT计数然后封装成图表需要的结构返回。别小看这个页面的意义在最终验收展示时可视化图表是最容易被评审一眼看到价值的功能。5. 部署运行避坑实录5.1 本地联调的常见问题与排查这个项目在本地跑起来并不难但新手总会在几个固定位置卡壳。我直接列一个速查表对应症状和根因都能对上。症状根因解决办法小程序请求后端一直转圈本地调试未勾选不校验合法域名或后端没启动开发者工具详情里勾选不校验合法域名、web-view业务域名、TLS版本以及HTTPS证书另一侧确认后端真的起来了登录报code无效小程序的appid与后端配置的appid不一致检查app.js里和微信公众平台后台是否用的是同一个appid数据库中文乱码数据库或表字符集不是utf8mb4改数据库字符集或建库时直接指定CREATE DATABASE 库名 DEFAULT CHARACTER SET utf8mb4刷新Token之后请求还是401拦截器没放行OPTIONS请求或未处理带Token的预检请求在拦截器配置中放行预检请求实际小程序不像浏览器有复杂预检但如果是Web管理端就要注意打包成Jar后图片访问404本地文件上传路径没有映射静态资源SpringBoot里实现WebMvcConfigurer的addResourceHandlers把文件目录映射到/upload/**端口被占用其他服务占了8080改application.yml里的server.port或者kill占用进程5.2 线上部署时多花几分钟课程设计能跑通本地就够了但如果要演示给别人看或者做成一个小型产品就得放服务器上。这里有两个选择买一台轻量应用服务器或者本地内网穿透。内网穿透适合临时演示长期用还得上服务器。服务器部署的步骤也就是常规的Java项目部署三板斧服务器装好JDK和MySQL导入SQL文件后端mvn package打成Jar包上传到服务器nohup java -jar xxx.jar 运行小程序端的baseUrl改成服务器的公网IP加端口但这里有个课程设计项目最常见的隐藏坑微信小程序正式环境必须HTTPS。开发工具里能关掉规则校验但手机上真机预览时如果域名没有HTTPS证书请求会被微信直接拦截。解决办法有两个最省事买域名配SSL证书有免费证书用Nginx反向代理到后端端口临时代理用云服务的内网穿透不太稳定或暂时用开发者工具的真机调试模式但每次预览都要扫码且有效期很短这个问题我在多个项目里都碰到过每次都有同学在演示前一天晚上发现手机上打不开急得团团转。所以建议项目一开始就做好域名和HTTPS的前置规划。如果时间允许我甚至会先配好HTTPS再做小程序调试省得后面重复改。5.3 微信登录失败背后的逻辑微信登录是项目里故障率很高的接口因为它需要联调微信服务端。常见故障原因appid与secret不匹配。小程序改了appid但后端代码里secret还是旧的。这俩必须在同一套账号体系下。code一次只能换一次。微信的code有效期5分钟且只能用一次。如果后端接口被重复请求第二次用同一个code就会报invalid code。这一问题经常出现在前端请求重试逻辑里。手机号绑定流程设计不完善。有的项目登录时不让学生绑定学号全靠微信用户信息那后端就没法关联课程成绩。解决是把学号绑定做成强制步骤登录后如果未绑定就跳转绑定页绑定成功后才能进入首页。6. 常见问题速查与避坑技巧6.1 高频Bug的重现与修复选课系统开发过程中有几个Bug几乎是每届学生必踩的我挑三个最典型的详细说说。Bug一选课人数漂移症状是列表页显示已选99/100但详情页显示已选101/100或者选课人数统计会变来变去。根因就是选课和退课操作对selected_count的增减不是原子的多个请求错乱导致计数与真实记录数不一致。修复方法是改动和查询的边界要统一。选课成功时selected_count加一退课成功时减一更新语句必须是带条件的原子UPDATE并且如果更新失败整个事务回滚不落选课记录。UPDATE course SET selected_count selected_count 1 WHERE id ? AND selected_count capacityBug二时间冲突检测漏判课程A是周一第3-4节课程B是周一第4-5节其实也有时间交集第4节重叠。如果只比较星期几开始节次完全相同就会漏掉部分重叠的情况。正确判断区间重叠的方法是新选课程的开始节次号 已选课程的结束节次号 且 新选课程的结束节次号 已选课程的开始节次号。定义好第几节开始、持续几节后用标准区间重叠判定。Bug三小程序端数组数据不刷新前端下拉刷新后已选课程列表还是旧的。这类问题多是页面onShow生命周期没有重新拉数据或者下拉刷新事件没绑定setData。排查时先确认接口有没有返回新数据再确认setData是否执行一步步缩小范围。小程序端的setData是异步渲染调试时打console.log看数据别看UI。6.2 给项目加分的小技巧课程设计或者个人项目光能跑只是及格线想拿高分或者让技术亮点能被看见我建议补这几个小功能选课名额实时刷新列表页每30秒轮询一次接口更新剩余名额或者在用户停留课程详情页超过一定时间后自动刷新。这看起来小但能明显感受到系统的实时性。选课结果并发测试写一个简单的JMeter脚本模拟50个人同时抢最后一门课的1个名额证明系统不超卖。这个测试结果截个图放答辩PPT里比任何文字都有说服力。Redis缓存课程列表热门课程列表接口加缓存减少数据库压力。实现上注意缓存失效策略课程状态变更时主动删缓存避免脏数据。学习记录带时长前端在视频播放时上报观看进度比如播放到第30秒)后端记录后展示已学习30分钟这类数据。这能丰富学习记录模块的展示维度。6.3 数据初始化的策略拿到空数据库跑项目最痛苦的是页面上没数据看不出效果。所以SQL脚本里一定要初始一些演示数据10门课程、50个学生、几百条选课记录、若干成绩分数。这些数据不能随便造要造得有逻辑课程要有热门冷门之分选课人数从0到满员的分布都要有展示统计页时才好看学生的学号和班级要有规律比如2023010101这种看着就像真数据有部分学生的选课记录里要有成绩有部分还没有这样成绩模块的未录入状态也能演示要有一到两门课的选课时间刚好覆盖今天保证演示时能现场演示选课操作其他课都调成过期状态避免误操作7. 扩展方向与项目经验总结7.1 从选课系统走向智慧校园的扩展空间这个项目的标题叫智慧校园系统但核心功能目前集中在选课学习。如果真的往更完整的智慧校园发展我可以指出几个可延展的方向消息通知推送微信小程序可以用订阅消息或模板消息课程上架、选课结果、成绩发布时给对应学生推送通知。微信小程序订阅消息需要用户主动订阅授权要在前端配合做好引导这块做好了整个系统的智慧感立刻上升一个档次。多角色接入引入教师角色后课程发布和教学管理就能从管理员身上剥离出来教师可以在我的课程里查看选课学生名单、发布成绩、上传课件。数据库层面只需要扩展用户类型字段和对应的权限判断。学分与培养方案联动学生选课受所属专业的培养方案约束比如本专业必选修课名单每学期最多选X学分。这个逻辑在选课前端做校验系统就能承担更贴近真实教务的职责。数据大屏管理端做一个智慧校园大屏页面展示今日选课人数趋势、热门课程排行、各时段选课活跃度。技术上用SpringBoot提供统计接口加前端图表渲染演示效果非常拔群。7.2 我做了这类项目几次后的真心话这类全栈项目从拿到手到跑通快的两天慢的一周差别主要在对业务逻辑的理解深度。很多人栽跟头不在技术上而在想当然——觉得选课不就是把数据插进表里等到写代码时才发现并发、事务、状态机、权限、时间冲突这些细节一个个冒出来。我的建议是拿到项目先不要急着跑起来先花半小时把数据表关系画出来把每个角色的操作清单列出来把每个操作背后涉及哪些表改动写清楚。这半小时能帮你省后面三天改Bug的时间。另外一个小建议把视频讲解和运行视频当作使用说明而不是调试依赖。照着跑通当然快但面试或答辩时别人问你为什么这里要用事务为什么这里会有并发问题看视频是学不到底层逻辑的。你要能用自己的话把项目讲圆。最后再分享一个我屡试不爽的小技巧文档里一定要有部署过程中遇到的问题汇总比如你踩过的端口占用MySQL版本不兼容小程序合法域名报错把这些整理到文档的FAQ里。评阅人看到你的文档里有这个板块直观感受就是这个人真的动手做过了而不是拿别人项目来交差。项目本身做得再干净都不如把踩坑记录如实写下来更能证明功力。
阅读完成 · 觉得有帮助？
