每次带毕设项目辅导碰到最多的就是两类题目一类是各种管理系统另一类也是各种管理系统。区别只是前面的技术栈不同。今天写一篇后台很多学生问过的基于JavaSSMFlask课堂管理系统项目复盘。这个题目很有意思它不是单纯的SSM也不是单纯的Flask而是用Java后端跑核心业务用Python Flask做辅助能力比如智能排课、课堂行为分析、推荐题目这类偏算法的功能。整套系统包括源码、LW文档、调试说明和配套讲解是一个比较完整的毕设型项目。用户角色一般分三类管理员、教师、学生。核心功能围绕课堂这个场景展开比如班级管理、课程安排、学生考勤、成绩录入、作业布置、课堂互动签到、随机点名、弹题等。这种项目最大的价值在于它在同一个系统里打通了一条Java和Python协作开发的完整链路而这个点恰恰是很多学生没接触过的。先说明一下我这里讲的内容是基于这类项目的普遍实现方式来拆解的。每个人的题目细节略有差异但核心链路基本一致SSM负责页面和业务流转Flask负责算法和数据处理两边通过HTTP接口互通。1. 项目定位学籍、课堂、作业、成绩四条线的闭环1.1 课程管理系统的核心业务场景这个项目名为课堂管理系统但实际覆盖的不只是上课这一个动作。从数据流转来看它要管理四条线学籍线、课程线、课堂活动线、成绩线。学籍线解决的是谁在学的问题包含学生信息、班级信息、年级信息课程线解决的是学什么的问题包含课程、教师、学期、教室课堂活动线是这套系统的特色包含签到、点名、课件、随堂测验成绩线就是考试、作业、平时分、总评。这四条线不是孤立的而是有清晰的主线逻辑。拿一个典型场景来说管理员先建立班级和学生账号教师登录后创建课程并关联班级上课时发起签到课后布置作业学生提交后教师批改最终生成综合成绩。这个流程里最容易被忽略的是课堂活动这个维度。很多管理系统只做静态数据管理但这套系统强调课堂内外的互动所以我在数据库设计时专门为签到、课堂测验、随机提问单独建表这也成了答辩时的一个亮点。1.2 双后端架构的本质意图为什么同一个项目里要同时出现SSM和Flask两套后端这是很多评审老师喜欢问的问题也是你必须在LW文档里讲清楚的一点。SSMSpring SpringMVC MyBatis擅长做结构化业务比如用户登录、权限校验、数据增删改查。它的类型约束强事务管理成熟适合做核心业务的数据落库。Flask轻量、上手快、Python生态里做文本处理和数据分析非常方便所以适合做那些需要算而不是存的功能。举个例子系统如果要做智能排课或者基于学生历史成绩的薄弱点分析用Python写算法比用Java要方便得多。Flask作为独立服务跑着Java通过HTTP去调用两边用JSON交换数据互不干扰。这就是这种混合架构的价值所在。实际项目中Flask端做的往往是两类事情一类是推荐和匹配比如根据课程标签给学生推荐选修课另一类是统计和预测比如根据考勤和作业记录生成学情预警。2. 技术选型SSM做业务Flask做能力MySQL做底座2.1 为什么选SSM而不是Spring Boot现在很多新项目直接上Spring Boot但毕设场景里SSM仍然占很大比例。原因有两个第一SSM的结构更适合展示分层思想Controller、Service、Mapper三层清清楚楚答辩时讲解起来有层次感第二很多学校SSM相关的基础课程和实训作业用的就是这套组合学生上手更快。SSM里面Spring管对象和事务SpringMVC管路由和参数绑定MyBatis管SQL和结果映射。我在调试过程中最常提醒自己的一件事是SSM的配置太容易出问题了尤其是Spring和MyBatis整合时的mapper扫描路径、事务管理器配置、web.xml里的DispatcherServlet映射。如果你用了Mavenpom.xml里各个依赖的版本协调也是必修课。比较稳的搭配是Spring 5.x MyBatis 3.5.x Jackson 2.xJava版本在8或者11都可以。2.2 Flask在这个系统里承担什么职责Flask在这里不需要做复杂的项目架构它的定位是边缘服务。我建议把Flask的代码控制在一个较小的范围只暴露有限的几个接口比如/api/recommend_course根据学生历史课程成绩推荐课程/api/analyze_attendance分析学生出勤趋势/api/generate_report生成班级学情报表为了跑起来方便Flask端直接使用自带的开发服务器和SQLite存储中间计算结果是完全可以的。如果数据不需要回写主库Flask甚至可以做成无状态服务用JSON接收Java传过来的数据算完再返回JSON。这种设计让Flask的权重变得可大可小——你的演示重点在Java Web上那么就弱化Flask如果你的创新点放在学情分析上那么就把Flask这部分做重甚至配合ECharts展示可视化的图表。2.3 前后端与两个后端之间的通信方式这个项目的通信链路一共两条。一条是浏览器到Java后端走的是传统Web流程浏览器访问JSP页面表单提交或Ajax请求到SpringMVC的ControllerController调ServiceService调Mapper最后返回ModelAndView或JSON给前端。另一条是Java后端到Flask后端走的是HTTP接口调用。Java端用RestTemplate或者HttpClient把要分析的数据作为JSON POST给FlaskFlask处理完回传结果。开发调试时建议在Flask的每个接口单独写一个测试入口这样不用启动Java项目就能单独验证Python端逻辑是否正常。我见过很多学生卡在Java返回的数据Flask读不到这个问题上十有八九是JSON字段名对不上或者中文编码没有处理成UTF-8。这个在后面的排查章节会重点说。3. 核心模块拆解权限、数据、课表、互动3.1 三类角色的权限边界与管理端功能课堂管理系统的用户角色基本固定为管理员、教师、学生。权限划分不复杂但边界必须明确这在答辩时属于必考知识点。管理员的核心功能包括用户管理增删改查、重置密码、分配角色、班级管理创建班级、分配辅导员、课程管理创建课程、指定授课教师、系统参数设置。教师的核心功能包括查看班级列表、创建课程、发起签到、布置作业、录入成绩、查看课堂统计。学生的核心功能包括查看课表、加入课程、签到、提交作业、查看成绩。这里有一个很容易忽略的设计细节教师和学生之间的选课关系通过选课表来关联而不是直接往课程表里加字段。很多新手会直接把学生ID写在课程表里这是不对的。多对多关系一定要用中间表选课表来解耦否则后面做班级维度统计时会非常痛苦。课堂互动这块建议做高频小功能因为它是课堂管理系统和普通教务系统的差异点。比如一键签到生成签到码、随机点名前端显示滚动效果、随堂测验单选判断题自动评分。这三个功能代码量不大但很能提现系统的课堂感。3.2 数据库表设计与几个关键关系数据库设计直接影响开发效率。这里列一下我推荐的全局表结构核心是9张表sys_user用户表字段有id、username、password、real_name、rolesys_class班级表字段有id、class_name、grade、major、head_teachersys_student_class学生和班级的关联表course课程表字段有id、course_name、teacher_id、semester、class_idstudent_course选课关联表attendance签到记录表字段有id、course_id、student_id、date、statusassignment作业表字段有id、course_id、title、deadline、contentassignment_submit作业提交表score成绩表字段有id、course_id、student_id、score、type需要注意的坑有四个。第一password字段不要明文存放至少用MD5加盐或者BCrypt处理虽然很多毕设演示不在乎这个但写进LW文档会显得专业。第二所有状态字段建议用数字枚举比如status字段用0/1/2代表未提交、已提交、已批改避免用中文字符串比较。第三时间字段统一用datetime类型Java端用String接收后再格式化否则前端展示容易出问题。第四成绩表可以冗余一个course_name字段方便统计时少几次连表查询。3.3 登录鉴权与拦截器的落地写法SSM项目的登录鉴权不用上Spring Security太复杂用拦截器就足够了。核心思路是用户登录成功后将用户对象存入session然后写一个LoginInterceptor拦截所有需要登录的请求校验session中是否存在用户对象。我提供一个常用的小技巧写拦截器时定义一个常量数组存放白名单路径。只放行登录页、登录接口、静态资源和注册接口其他请求全部拦截。拦截到未登录请求时如果是Ajax请求就返回401状态码前端判断后跳转登录页如果是普通页面就直接redirect到login.jsp。另外建议在拦截器里把用户角色也查出来放到request域中方便JSP页面用c:if标签控制不同角色的功能按钮显示。这一步做得好前端页面会干净很多不需要在每一个Controller里面重复判断权限。4. 实操记录从搭建到跑通核心链路4.1 开发环境与工程初始化我用的是JDK 1.8版本、Maven 3.6、Tomcat 8.5这些老的但很稳定的组合。IDE这边我用的是IDEA 2020版本以上都行。MySQL用的5.7因为对中文排序和JSON支持都比较友好。工程结构按SSM标准来分层src/main/java ├── com.example.controller ├── com.example.service ├── com.example.mapper ├── com.example.entity ├── com.example.interceptor src/main/resources ├── jdbc.properties ├── spring-mvc.xml ├── spring-mybatis.xml └── mybatis-config.xml src/main/webapp ├── WEB-INF/web.xml ├── WEB-INF/jsp └── static注意几个容易出错的地方IDEA创建Maven Web项目后要手动确认webapp目录被识别为Web资源根目录Spring的配置文件要注入数据源MyBatis的mapper接口扫描和mapper XML扫描要分别配置路径写错是启动报错最常见的原因。4.2 登录功能与通用返回封装登录功能是所有模块的地基。建议封装一个统一的返回结果类Result属性包含code、message、data。这样无论是登录、查列表、保存数据都能用同一个格式返回前端只需要固定解析这样一个JSON结构就可以了。Controller里写一个简单的登录方法接收username和password调用service根据用户名查用户比对密码。如果密码错误返回code500如果账号存在但角色未启用返回code403登录成功则把用户对象放进session后返回code200同时把用户角色一并返回前端据此跳转到不同首页。密码比对这一块提醒一点如果数据库存的不是明文比对时要把输入密码做同样的哈希处理后对比而不是把数据库密码解密后再比对。加盐策略也简单直接用一个固定的盐拼在密码后面再做MD5毕设阶段够用。4.3 签到功能的设计与实现签到算这个系统的灵魂功能。我采用的方案是“动态签到码时限窗口”。教师发起签到时后端生成4位随机数存到Redis如果没有Redis用ConcurrentHashMap也行毕设够用并设置2分钟过期同时记录签到开始时间。学生在页面输入签到码后端校验码是否匹配、是否在时限窗口内、是否重复签到。如果不想依赖RedisJava端用HashMap模拟一个内存存储容器也能完成这个功能。但要注意并发问题内存Map必须加锁或使用ConcurrentHashMap。从答辩的角度来看如果你能讲清楚“用内存缓存替代Redis是为了降低部署复杂度生产环境可以无缝替换为Redis”反而是加分项。签到统计页建议用ECharts做一个柱状图按日期显示到课率。这个可视化效果很直观答辩演示时放一张图比说十句话都管用。4.4 作业模块和成绩模块的数据流转作业模块的业务比较简单教师创建作业学生提交文本或附件教师批改并给分。这里需要注意文件上传的处理。SSM里用CommonsMultipartResolver配置上传大小本地磁盘指定一个上传路径然后把文件路径存到数据库不要把文件Base64编码后存进数据库那样数据库会迅速膨胀。成绩模块要注意分数类型我的设计里成绩表有一个type字段1代表平时成绩、2代表考试成绩、3代表总评。总评成绩一般由平时成绩和期末成绩按权重自动计算比如平时40%期末60%。这个计算逻辑既可以在Java里做也可以在SQL里算但为了可读性Java端做比较好并且别忘了保留两位小数。4.5 Java调用Flask接口的完整实现这个环节是整个项目技术含金量最高的地方也是我推荐你在LW文档里重点展开的部分。我先说需求场景系统需要根据课程名称和学生成绩做学情分析生成一段文字报告这个用Python处理最简单。Java端代码可以这样写用的是RestTemplateAutowired private RestTemplate restTemplate; public String analyzeClassReport(Integer courseId) { MapString, Object param new HashMap(); param.put(courseId, courseId); param.put(avgScore, 83.5); param.put(attendanceRate, 0.92); HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_JSON); HttpEntityMapString, Object request new HttpEntity(param, headers); String flaskUrl http://localhost:5000/api/analyze_attendance; ResponseEntityString response restTemplate.postForEntity(flaskUrl, request, String.class); return response.getBody(); }需要在Spring配置里注册RestTemplate这个Bean这个非常简单。Flask端对应接口实现from flask import Flask, request, jsonify app Flask(__name__) app.route(/api/analyze_attendance, methods[POST]) def analyze_attendance(): data request.get_json() course_id data.get(courseId) avg_score data.get(avgScore) attendance_rate data.get(attendanceRate) if attendance_rate 0.7: advice 该班级出勤率偏低建议加强课堂管理 elif avg_score 85: advice 班级整体成绩优秀可适当增加拓展内容 else: advice 班级整体表现中等建议增加课后辅导 return jsonify({courseId: course_id, advice: advice}) if __name__ __main__: app.run(host0.0.0.0, port5000, debugTrue)这样Java端拿到返回的文字建议就可以保存到数据库或直接展示给教师看。整体链路是浏览器 - Java后端 - Flask后端 - 返回JSON - 数据集缓存或落库 - 展示。调试时要先单独启动Flask并用浏览器访问接口测试通再启动Java项目联调。不要在两边都启动的情况下盲目找问题逐层排查才是效率最高的方式。5. 部署调试与常见问题处理5.1 本地部署完整流程这个项目是标准的前后端混合部署模式本地跑起来的步骤很固定按顺序来就能减少很多坑。第一步导入SQL脚本创建数据库确保MySQL的字符集设为utf8mb4否则中文会乱码。第二步修改jdbc.properties中的数据库连接信息用户名、密码、URL里的端口和库名都要确认。第三步在IDEA里配置Tomcat把项目的war包部署进去启动时如果端口被占用Tomcat报错信息会直接告诉你改一下Tomcat的HTTP端口就行。第四步启动Flask服务命令行执行python app.py确认5000端口正常监听。第五步打开浏览器访问Java项目地址先用管理员账号登录创建班级、教师、课程再用教师账号体验完整流程。5.2 高频问题排查速查表我根据实际调试经验整理了一张问题排查表基本覆盖了学生问过我的80%以上的问题。问题现象可能原因解决方案启动Tomcat报ClassNotFoundMaven依赖没有完整下载执行mvn clean install再Reimport一次登录页面正常但验证码不显示静态资源被拦截器拦截检查拦截器白名单是否包含/static/**数据库中文乱码数据库字符集不是utf8mb4检查连接URL加characterEncodingutf8MyBatis查询报BindingExceptionMapper接口和XML文件路径不匹配检查mybatis配置中mapperLocations路径Ajax请求返回302而不是JSON请求被拦截器重定向到登录页拦截器中判断请求头X-Requested-WithFlask返回中文变\uXXXXFlask默认JSON编码问题使用jsonify并设置app.config[JSON_AS_ASCII]False跨域请求失败端口不同导致的跨域问题Flask端添加CORS支持或者Java端用HTTPClient转发5.3 安全性自查清单与答辩准备虽然这是毕设项目但安全上的基本意识还是得有。我的自查清单是登录接口有没有防SQL注入一定用PreparedStatement或MyBatis的#{}占位符密码是否明文存储建议哈希后存储拦截器是否拦截了所有敏感路径上传文件是否限制了类型和大小Flask接口是否需要鉴权建议至少加一个简单的Token参数。答辩时老师可能会问这几个问题提前准备好回答思路。SSM的常用注解要能脱口而出Controller、Service、Repository、Autowired、RequestMapping、RequestParam、ResponseBody、Transactional。Spring的IOC和AOP要知道核心概念和落地场景比如用AOP可以做什么日志记录、事务管理。MyBatis中#{}和${}的区别必须说明白#{}是预编译防注入${}是字符串拼接不安全。Flask这边应对为什么用两个后端这个问题标准答法是SSM承担结构化业务和数据持久化Flask发挥Python在数据处理和算法方面的优势两者通过HTTPJSON解耦分工明确便于扩展。6. 写在最后的项目复盘与第二次开发建议这个项目做下来最大的体会是SSM和Flask单独拿出来任何一个都不算新颖但把它们放在一个系统里协作就形成了业务系统分析服务的架构分层。很多实际项目就是这么玩的Java做中台Python做算法服务两边用接口沟通彼此不干扰。如果你拿到的是类似题目我建议在动手前先把LW文档的目录理清楚再按目录推进开发。很多学生是代码快写完才开始写文档结果经常发现代码设计配不上文档描述来回改动非常痛苦。反过来先定业务流程图、数据流图、用例图再编码效率和顺畅度会完全不一样。最后给一个实用的二次开发建议如果时间允许把Flask端的学情分析做重一点比如接入分词算法做课堂反馈分析或者根据历年成绩做基础的趋势预测。不用做得很深哪怕就是简单的规则引擎加一点统计都能让项目从管理系统升级为带智能分析的辅助决策系统这个亮点能明显拉开和其他同类型毕设的距离。