Spring Boot毕业设计实战：计算机学院教研信息平台全流程开发

为什么偏偏选了“计算机学院教研信息平台”这个题目说实话很多同学做毕业设计到了开题阶段才发现找个“能做、能讲、能跑通”的题目比想象中难。纯电商、图书管理、新闻发布这类题太大众答辩老师一眼就看穿是照着教程改的太偏算法的题目又容易把自己坑进去数据、模型、效果都说不清楚。教研信息平台恰好卡在一个很舒服的位置它有明确的业务场景、有角色权限、有增删改查、有统计报表既能体现Spring Boot的开发能力又能把软件工程的完整流程展示出来工作量也符合本科毕设的要求。今天就把我做这个项目的完整思路、环境搭建、数据库设计、核心功能实现和部署调试过程全写出来给准备用Spring Boot做毕设或者练手的同学一份可以直接“抄作业”的参考。先说明一下这个平台到底解决什么问题。计算机学院的日常教研工作其实很琐碎教师基本信息分散在Excel里教研活动记录靠纸质签到表课题申报和成果统计每年都要反复填表学院汇总的时候各种格式不统一。这个平台就是把教师信息管理、教研活动登记、课题申报审核、成果录入统计这几件事统一起来通过不同角色权限控制数据流向普通教师录入和查看自己的数据教研室主任审核活动与课题学院管理员做总览和导出。整套系统基于Spring Boot开发数据库用MySQL前端采用服务端渲染模板配合原生JavaScript实现基础交互部署目标是一个普通Linux服务器完全符合校内毕设演示环境。适合谁参考这篇内容一种是正在选题或者已经在做Spring Boot毕设的本科生另一种是想系统梳理Spring Boot开发流程、但不想看枯燥文档的初学者。文章里不会只贴代码会把每一步“为什么这么做”讲清楚。比如为什么要用MyBatis-Plus而不是纯MyBatis为什么权限那块不用Shiro而用简单的拦截器方案为什么数据表要拆成五张而不是三张。这些思考过程在写论文和答辩的时候都是加分点。1. 项目整体设计与技术选型1.1 需求拆解别一上来就设计表拿到“教研信息平台”这个题目第一步不是建数据库而是把业务角色和核心流程捋出来。我一开始也犯过这个错误上来就画了十几张表后面写代码发现逻辑完全对不上又删掉重来。正确做法是先用一句话描述系统“让计算机学院教师能在线完成教研活动登记、课题申报和成果维护管理人员负责审核与统计。”顺着这句话角色就出来了教师普通用户维护个人资料、发起课题申报、登记教研活动参与记录、录入个人教研成果。教研室主任审核角色查看本教研室数据审核活动记录和课题申报必要时退回并填写原因。学院管理员系统角色管理教师账号、管理教研室信息、查看全院数据汇总、导出统计报表。角色清楚了核心流程也就清楚了。课题申报的流程是教师提交申请书 - 主任审核 - 通过后进入立项状态 - 结题时教师提交结题材料。教研活动的流程是发布活动通知 - 教师报名/签到 - 活动结束后负责人录入简报。成果管理相对简单教师直接录入论文、教材、软著、获奖等条目关键字段是成果类型、级别、时间、佐证材料链接。把这些流程写在纸上再开始设计功能模块。模块不需要多六个就够了登录注册、教师档案、活动管理、课题管理、成果管理、统计分析。每个模块下再做列表页、新增页、编辑页、审核页。这个页面量对毕设来说刚好工作量饱满但不失控。1.2 技术栈选择Spring Boot 为什么是主力选技术栈不能只看“流行”要看你能否在答辩时替自己辩护。Spring Boot在Java后端项目里已经是事实标准选它有足够的理由内嵌Tomcat打成jar包就能跑部署不需要单独配置外部容器这对毕设演示非常友好。自动装配机制省掉大量配置起步阶段不会因为一个XMLBean定义卡半天。Spring生态成熟社区资料丰富遇到问题搜索一下就有答案责任在我身上可控。配合Spring Data JPA或者MyBatis-Plus数据层代码量能少一半。前端我没有刻意使用Vue、React这类前后端分离方案而是用Thymeleaf模板引擎加Bootstrap配合少量JavaScript做表单校验和异步请求。原因有三个一是这个项目时间跨度长前后端分离意味着要维护两套工程答辩演示还要同时启动两个服务风险更高二是模板方案天然支持页面权限控制后端在渲染前就知道当前用户是谁可以直接拼接菜单三是论文写作时模块划分和数据传递描述起来更容易不需要花大量篇幅解释跨域和API鉴权的问题。有一个容易被忽视的点JDK版本。我用了JDK 8 Spring Boot 2.7.x组合而不是JDK 17 Spring Boot 3.x。不是新的就一定好学校机房电脑配置参差不齐很多同学反馈Spring Boot 3.0以上版本在某些老机器上内存占用高、启动慢而且数据库驱动包名字变了排查起来更麻烦。JDK 8配合Spring Boot 2.7是一套经过大量验证的稳定组合毕设项目求稳比求新重要。1.3 为什么选择MyBatis-Plus这个项目的核心就是增删改查但纯MyBatis手写SQL太多JPA又不太符合“看着踏实”的传统Java思维。MyBatis-Plus是个折中方案单表操作几乎不用写SQL内置方法就能完成复杂统计查询可以手写注解SQL也不影响控制力。比如分页查询用户列表用Page对象加LambdaQueryWrapper几行代码就搞定翻页参数都不用自己算。另外MyBatis-Plus的saveOrUpdate方法在新增和编辑合一时特别有用配合TableId(type IdType.AUTO)可以省去很多重复的“判断是insert还是update”逻辑。仅靠这一点我在写课题模块的时候就少了差不多两百行代码。当然用这个框架必须注意表字段命名规范数据库表字段如果带下划线如course_name实体类就用courseName并开启map-underscore-to-camel-case配置否则字段对不上排查起来很痛苦。提示使用MyBatis-Plus时最好在调试阶段开启SQL日志打印日志里能看到框架自动生成的SQL判断是不是哪条字段映射出了问题。2. 开发环境搭建与源码结构2.1 环境清单与安装要点我的开发环境如下Windows 11系统IDEA 2023.2JDK 1.8.0_202Maven 3.8.8MySQL 8.0.34Navicat 16Redis没有引入毕设项目避免引入过多中间件减少答辩风险。很多同学在装JDK时踩了坑明明装了多个版本IDEA里选好了命令行java -version还是旧的。建议把系统环境变量JAVA_HOME明确指向一个JDK路径同时把IDEA的Project SDK以及Maven的JAVA_HOME都设置一致。Maven有两种配置方式。一种是下载二进制包解压后自己配环境变量另一种是直接用IDEA内置的Maven插件。我推荐自己装一个Maven并把仓库地址改为国内镜像常见阿里云仓库配置写在settings.xml的mirror节点。这样做的好处是命令行也能用mvn命令部署到服务器时不需要依赖IDEA国内镜像能解决依赖下载失败、卡顿问题。具体配置网上有很多重点是把localRepository改到你自己的目录不要放C盘默认位置免得系统盘满了以后各种诡异报错。MySQL先装好Navicat连接时如果提示“Public Key Retrieval is not allowed”记住在连接属性里设置allowPublicKeyRetrievaltrue这是MySQL 8.0常见问题。数据库名建议直接用jd_admin或teach_research这种见名知意的短名称不要用中文也不要带空格。字符集选择utf8mb4排序规则选utf8mb4_general_ci这样存emoji或者特殊字符不会报错也符合主流习惯。2.2 源码目录结构与职责边界项目采用标准Maven结构源码根目录是src/main/java资源目录是src/main/resources。我习惯把包名按功能分层而不是按技术分层。举例来说包结构是这样com.example.jdadmin ├── config // 配置类拦截器、跨域、数据源配置 ├── controller // 控制层接收请求、返回页面或JSON ├── service // 业务层具体业务逻辑 ├── mapper // 数据访问层MyBatis-Plus接口 ├── entity // 实体类对应数据表 ├── model // 数据传输对象、请求体、VO ├── common // 通用工具、统一返回结果、异常处理 └── interceptor // 登录与权限拦截器config包容易被人忽略但它承担了全局过滤器、拦截器注册、MyBatis-Plus分页插件注册等重要工作。controller层只负责参数接收和结果响应不写业务细节service层写核心流程mapper层只声明接口entity和数据库表一一对应。这样分层的直接好处是定位问题快接口报错了先在controller看参数是否接住再看service逻辑再看mapperSQL。论文画架构图时分层结构也更好描述。resources目录下application.yml放主配置application-dev.yml放本地开发配置application-prod.yml放服务器部署配置分环境管理是必须养成的习惯。static目录放CSS、JS、图片templates目录放Thymeleaf模板页面。模板页面按模块建子目录比如teacher/、activity/、subject/、result/每个模块下的列表页和表单页分开命名。2.3 application.yml 配置避坑一个典型的application.yml核心配置长下面这样但有几个地方必须画重点server: port: 8080 servlet: context-path: /jdadmin spring: datasource: url: jdbc:mysql://localhost:3306/jdadmin?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false servlet: multipart: max-file-size: 20MB max-request-size: 50MB mybatis-plus: mapper-locations: classpath*:mapper/*.xml configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl map-underscore-to-camel-case: true第一数据库连接串里serverTimezoneAsia/Shanghai必须写不然本地时间正常、部署到云服务器后时间可能会相差8小时然后你会在凌晨收到“发现当天没有数据”的问题。第二characterEncodingutf8也不能省否则中文会变成问号这种Bug排查半天都想不到是连接串问题。第三Thymeleaf的cache: false在开发阶段必须打开否则你改了页面刷新不生效还要手动重启服务。关于context-path我建议加一个上下文路径比如/jdadmin。好处是部署到服务器时可以在Nginx里把某个路径反向代理到这个服务不加路径也没关系但加上去之后前后端调用时容易认出路径归属。只是要注意如果配置了context-path登录跳转、静态资源引用、Controller返回的视图路径都要带上否则页面会404。3. 核心功能实现与数据库设计3.1 数据库表结构设计从业务对象到实体我设计了六张核心表外加一张用户角色关联表。这里说几个关键表的设计理由。用户表sys_user主键id、用户名、密码、姓名、角色普通教师/主任/管理员、所属教研室id、手机号、邮箱、头像地址、状态。密码字段我直接存了MD5加盐后的哈希没有引入Spring Security——不是不能而是这个项目没有复杂的密码策略需求自己写一个MD5工具类就行。如果用了Security答辩时得解释过滤链、UserDetailsService、Session管理一整串机制如果准备不充分反而容易露怯。这里说的“加盐”是指在原密码后面拼一串固定字符再算MD5比如user123 #salt#能稍微增加破解成本。真正的安全项目肯定不能这么干但毕设项目要把核心逻辑讲清楚不必强行上高深技术。教师信息表teacher_profile主键user_id关联用户表、姓名、性别、职称、学历、研究方向、入职时间、授课方向、个人简介。这里有意识做成user_id作主键而不是单独生成一个id是为了保证一个用户只能有一条教师档案记录数据库层面就限制了重复。这种设计思路在答辩时可以提一句“业务上的唯一约束下沉到数据库层”显得有设计感。教研活动表activity活动名称、类型教学研讨/听课评课/集体备课、活动时间、地点、组织人、参与人数、活动状态、活动简报内容。参与人数不是一个数字字段而是在活动报名表中关联记录数汇总出来的。这里涉及一个细节如果只存数字教师报名时每次都要去更新人数并发高的时候容易出错用关联表统计可以保证数据一致查询时用COUNT即可。活动状态有草稿、已发布、已结束用于控制教师能否报名。课题申报表subject课题名称、课题类型教改项目/科研项目/横向项目、申报人user_id、所属教研室、经费预算、研究周期、课题状态草稿/待审核/通过/退回/结题、申报书附件路径、审核意见、审核人、审核时间。课题状态的流转是系统里最复杂的业务逻辑后面单独说。教研成果表result成果名称、成果类型论文/教材/专利/软著/获奖、成果级别国家级/省级/校级、第一作者、本人排名、发表时间、期刊名、佐证材料路径、审核状态。成果表相对简单但字段“本人排名”容易被忽略很多老师论文是多人合作必须记录本人是第几作者后面统计权重的时候要按排名算分。关联表就一个活动报名表activity_signup主键id、活动id、教师user_id、报名时间、签到状态。总共八张表不多不少。如果你基础不太好也可以把用户表和教师信息表合成一张减少关联查询。但会有一个问题用户表里既有登录账号信息又有职称、研究方向这种扩展信息字段会很杂而且权限控制代码里查询用户信息时每次都要带上很多无关注册字段。拆开后逻辑干净很多论文里也能写“数据库设计遵循第三范式职责单一”。3.2 登录与权限控制不用Shiro也够用登录功能没用什么高深框架就是传统Session方案。用户输入账号密码后端校验通过后把用户id、姓名、角色存到session里然后进入首页。但是在实现权限控制时我用了两种方式配合拦截器做URL级粗粒度控制页面内做按钮级细粒度控制。拦截器代码如下逻辑一目了然public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object user session.getAttribute(loginUser); if (user null) { response.sendRedirect(/jdadmin/login); return false; } // 角色控制根据访问路径前缀判断 String uri request.getRequestURI(); if (uri.startsWith(/jdadmin/admin/)) { Object role session.getAttribute(userRole); if (!ADMIN.equals(role)) { response.setStatus(403); return false; } } return true; } }注册拦截器时要记得排除登录页、登录接口、静态资源路径否则CSS和JS会被拦住导致页面光秃秃。这是新手最容易踩的坑。角色控制在拦截器里只判断前缀比如所有/admin/开头的请求只允许管理员访问对应地在后端Controller里我会在班级管理类接口上再单独加注解校验确保深层Bug不会发生。前端菜单渲染时根据当前用户角色决定显示哪些入口教师看不到统计报表菜单主任看不到管理员相册管理菜单。这样粗粒度和细粒度结合安全性和开发效率兼顾。3.3 核心业务逻辑课题申报状态机课题模块是这个项目最有含金量的部分因为它的状态变化不是简单的增删改查而是一个状态机草稿 - 待审核 - 通过/退回 - 立项中 - 结题/终止。实现方式是用一个Integer类型的status字段配合常量类定义状态值在Service层写状态流转校验方法。核心逻辑是操作前先查当前状态判断目标状态是否合法合法才更新同时记录操作日志到一张subject_log表。比如退回操作只允许“待审核”状态的课题被退回退回时必须填写审核意见审核意见内容会关联查询后展示给申报人。结题操作必须满足“立项中”且已经有成果录入否则提示“请先录入至少一项成果”。这个状态机的优势在于答辩时你可以拿它讲“业务规则的闭环”演示路径教师提交 - 主任列表中看到待审核消息 - 点击审核通过 - 教师端看到状态变为立项中 - 录入结题报告 - 主任审核结题。整个过程数据在变状态在变页面内容在变比单纯演示几次增删改查有说服力得多。实现状态流转时我写了一个checkStatusTransition方法private boolean checkStatusTransition(Subject subject, int targetStatus) { int current subject.getStatus(); // 草稿可以提交为待审核待审核可以通过或退回通过后进入立项中立项中可以结题 if (current 0 targetStatus 1) return true; if (current 1 (targetStatus 2 || targetStatus 3)) return true; if (current 2 targetStatus 4) return true; if (current 4 targetStatus 5) return true; return false; }这种硬编码状态图虽然简单但对毕设够用了。如果要展示更优雅的方案可以在数据库里建一张subject_status_config表把允许流转的路径存进去用配置文件驱动状态机。但那样会增加很多代码量和论文篇幅我综合考虑后没采用。同学们可以根据自己情况取舍。3.4 数据统计与导出让报表能讲出故事统计分析模块我用的是SQL聚合加ECharts图表。一个典型的统计需求“统计全院各教研室近三年教研成果数量”。这条SQL怎么写用GROUP BY加年份计算SELECT department_name, YEAR(create_time) AS stat_year, COUNT(*) AS cnt FROM result r JOIN teacher_profile t ON r.teacher_id t.user_id WHERE r.status 2 GROUP BY department_name, YEAR(create_time) ORDER BY dept_name, stat_year;得到的数据放在一条ECharts的柱状图里横轴是年份每个教研室一个系列。这种图在论文里拿出来、答辩PPT里放一张比满屏表格有冲击力。还要实现一个简单导出功能把统计结果导出为Excel。强烈推荐直接用Easy Excel或Apache POI但EasyExcel的API更简洁。导出按钮对应的Controller方法里先查数据然后调用EasyExcel.write(outputStream).sheet(成果统计).doWrite(list)前端用window.location.href触发下载即可。导出的作用不仅是功能亮点还关系到答辩演示时的流畅度。我记得有一次演示导出因为服务器上缺少中文字体导出的Excel里中文全部变成乱码当场翻车。后来在服务器上装了一个字体包问题就解决了。这个问题在本地开发几乎不会出现所以特别提醒大家部署环境检查字体和时区不是可选项而是必需项。4. 调试部署与常见问题排查4.1 本地运行与打包从IDEA到命令行本地开发时直接在IDEA中运行主类就行。但实际项目过程中我发现很多问题只在打包后才会出现比如依赖冲突、资源文件没打进jar、静态资源路径不对。所以建议每隔几天就执行一次完整打包mvn clean package -DskipTests。打包命令加上-DskipTests是为了跳过测试避免因为测试类没写导致失败。如果你项目里有测试类且包含RunWith等注解打包失败的概率更高可以先跳过等毕业答辩前再补一个简单的测试。打包产物会出现在target目录文件名是jdadmin-0.0.1-SNAPSHOT.jar。本地验证打包是否成功时直接在当前目录下运行java -jar target/jdadmin-0.0.1-SNAPSHOT.jar这里有一个经验默认jar包里已经把resources目录下的application.yml打进包中了如果你修改过本地配置还没重新打包运行的就是旧的配置容易造成“我明明改了数据库密码为什么还报错”的问题。解决方法是启动时指定外部配置文件java -jar target/jdadmin-0.0.1-SNAPSHOT.jar --spring.config.locationfile:/home/jdadmin/config/application.yml这样你可以不改jar包内容、只改外部配置文件就能调整部署环境非常实用。4.2 服务器部署Linux环境下的一键启动脚本服务器我用的是CentOS 7环境配置步骤是先安装JDK 8再安装MySQL 8然后把本地导出的SQL文件导入最后上传jar包。依次执行下面几条命令# 导入数据库 mysql -u root -p jdadmin jdadmin.sql # 上传jar包后赋予可执行权限 chmod x jdadmin-0.0.1-SNAPSHOT.jar # 后台启动 nohup java -jar jdadmin-0.0.1-SNAPSHOT.jar --spring.profiles.activeprod --server.port8080 app.log 21 通过tail -f app.log看日志看到“Started JdadminApplication”就是启动成功了。对于学生部署不建议直接用Docker除非你非常熟悉容器概念。因为Docker会引入镜像、容器网络、数据卷挂载、日志收集一堆概念答辩时万一被追问一个细节答不上来反而扣分。普通nohup方式足够稳定也容易解释。有一点必须提出服务器上MySQL如果开了防火墙或者云服务商安全组没放行3306端口本地Navicat连接不上但系统运行未必受影响。这是因为项目里数据库连接是后端程序发起的只要程序所在机器能访问3306即可本地Navicat连接不上排查的是安全组。这两件事别混在一起。4.3 高频Bug排查速查表做项目期间我整理了一份问题速查表只写那些真正高频的、浪费过我时间的现象可能原因解决方案启动时提示端口被占用之前没关掉旧进程Windows用netstat -ano数据库连接失败: Access denied用户名密码错误或数据库未创建检查application.yml中密码先手动用客户端工具连接验证中文乱码数据库字符集或连接串缺characterEncoding确保建库用utf8mb4连接串加characterEncodingutf8页面排版错乱且CSS失效拦截器拦了静态资源在拦截器排除路径中加入/static/**、/css/**、/js/**表单提交保存后没有数据实体类字段名与表字段映射不对开启驼峰映射或检查MyBatis-Plus的实体类注解导出Excel中文乱码服务器缺字体或列宽设置异常安装fontconfig、ttf-mscorefonts后重启服务上传附件后访问404上传路径不是项目可访问目录配置文件上传目录并映射为静态资源路径或使用虚拟路径映射部署后时间差8小时MySQL时区为UTC数据库连接串加serverTimezoneAsia/Shanghai同时系统设置时区4.4 避坑经验毕设项目最该注意的三个原则第一不要追求技术炫技。使用微服务、分布式锁、消息队列这类技术除非你能把原理说得非常透否则会给答辩增加风险。这个项目就是单体Spring Boot简单、清晰、可靠反而能拿高分。第二强密码策略不要卡自己。很多同学喜欢在前端加复杂的密码校验规则结果演示时输入不通过台上尴尬。我们在正式演示时用Admin123456这样的密码但项目验收后可以再展示密码强度规则。第三数据导入不要只靠手动录。建好表后用Navicat的导入向导快速生成一批模拟数据至少每个表要有十到二十条统计图表才能画得有模有样。模拟数据占演示成功一半这不是开玩笑。5. 论文写作与答辩准备的额外心得既然标题里提到“带论文文档”论文这一块也必须说。我的论文结构是绪论、需求分析、系统设计、系统实现、系统测试、总结。这个结构最稳不容易被质疑。写的时候记住一个核心原则论文中每一个图、每一张表都要来自你实际开发中的真实内容。比如用例图就用你自己项目的角色和流程来画ER图就按照你的数据库表来画千万不要直接抄模板图。答辩老师见过的论文很多一看图与文字对不上印象分会直接掉。系统测试章节别只写“全部通过”。要列出测试用例表比如登录模块测试用例包含“输入正确密码登录成功”“输入错误密码提示错误”“未登录访问后台跳转登录页”等每条标注预期结果和实际结果。这样测试部分就不是虚无缥缈的客套话而是实打实的证据。答辩PPT要围绕两条主线讲角色操作线和技术实现线。首先演示教师账号如何登录、如何申报课题再切到主任账号审核最后切到管理员查看统计。技术方面讲三张图系统架构图、数据库ER图、核心业务流程图。其他框架配置不用细讲不是每个老师都关心你用了哪个版本的Spring Boot但每个老师都关心你这个系统是不是你自己写的。回答问题时如果你能把某个功能的SQL或异常链由来说清楚比如“数据库字段如果加上一个唯一索引会怎样”这种深度比背100个定义都管用。最后分享一个小技巧项目的README文件一定要写好。里面写清楚环境要求、启动步骤、默认账号密码、常见问题不仅能帮老师快速部署查看也是你毕业设计资料的附件之一。当时我在README里放了启动失败排查表老师直接照着操作没有额外问我任何环境问题答辩过程顺了很多。这个项目做完之后我又试着把部分模块改成了前后端分离版本练手把后端接口改成REST风格前端用Vue3重写。改完才意识到当初用Thymeleaf做毕设的决定太正确了——后端逻辑不变只换了数据格式和页面渲染方式核心架构还能沿用。从这个角度看教研信息平台这个题目留给你的扩展空间也很大之后不管是要继续深造还是找工作都可以作为一段扎实的项目经历拿出来讲。你现在拿到这个题目不需要焦虑按着需求梳理、环境搭建、数据库设计、接口实现、页面调试、部署这个路线一步步走毕设稳稳拿下。