每年毕业设计开题季实训平台、实习管理系统这类题目几乎成了“全栈入门必做题”。但你真去搜一圈就会发现网上大多数所谓“源码”要么结构混乱要么版本太老跑起来全是坑。这次分享的项目是一个基于SpringBoot Vue MyBatis MySQL的面向智慧教育实习实践管理系统代码结构清晰、前后端分离、带完整的权限控制和实习业务流程适合拿来做毕设、课程设计或者作为中小型管理系统的架构参考。这个系统解决的核心问题其实很具体高校实习实践环节中学生找实习、院系审批、指导老师跟踪进度、教务处汇总统计全靠线下Excel和纸质材料信息不同步、数据难追溯。系统把这套流程搬到了线上学生端能申报实习、提交周报、查看成绩教师端能审批、打分、指导管理员端能维护基础数据、看统计报表。整体技术栈非常主流SpringBoot做后端接口、Vue做管理后台和用户端、MyBatis负责数据库交互、MySQL存业务数据适合有Java基础和前端基础的同学二次开发。下面我会从需求拆解、技术选型、数据库设计、核心模块实现、部署实操到问题排查把整个项目掰开揉碎讲一遍。中间会穿插我在实际开发中踩过的坑和调试经验尽量让你看完不只是“会跑”而是真的“懂”。1. 需求拆解智慧教育实习实践系统到底要解决什么问题1.1 “智慧教育”不是口号是流程再造很多人看到“智慧教育”这四个字就头大觉得是蹭概念。实际上放在实习实践管理这个场景里“智慧”二字体现在三个地方一是数据通学生从申报实习到最终成绩评定全程数字化留痕谁审批了、谁打的分系统里都能查到二是流程顺审批节点从学生提交到指导老师初审再到院系审核全部线上流转不用各个办公室来回跑三是决策有依据管理员端能看到各专业实习人数、对口率、企业分布等统计图表这不是花架子是真能给教学管理提供参考的。我当时拿到这个题目的第一反应是先列角色再理流程。系统里三类核心用户学生、教师含指导老师和院系管理员、系统管理员。学生的核心操作是填报实习申请、查看审批进度、提交实习周报、查看实习成绩。教师的操作是审批实习申请、查看学生周报并回复、录入实习成绩、查看带教名单。管理员负责基础数据维护比如院系和专业管理、实习单位库管理、用户账号管理、系统统计。逻辑就是“学生申报、教师审批、过程留痕、结果统计”这十六个字。1.2 功能模块砍到多少才算够用实习实践系统的功能可以做得非常复杂比如对接第三方实习平台、在线签到打卡、AI简历诊断等等。但作为一套可落地、可演示、可二次开发的源码项目功能要“够用且完整”太少没有参考价值太多容易把代码结构撑散。这个项目的功能清单大概是这样的用户模块登录、注册、个人信息维护、密码修改实习申报模块学生填写实习申请实习单位、岗位、时间、指导教师、提交审批、查看审批进度审批模块教师端待办列表、通过/驳回、审批意见填写过程管理模块学生提交周报实习内容、心得、图片附件、教师查看并回复成绩模块教师按学生打分录入评语支持成绩导出实习单位模块管理员维护合作单位库供学生申报时选择统计模块按学院、专业统计实习人数、实习单位类型分布、成绩分布系统管理模块用户管理、角色权限分配、菜单管理、数据字典这套功能基本覆盖了实习实践从申报到归档的全流程而且每个模块都是独立的前后端接口拆开来学或者合在一起跑都行。1.3 权限模型三套界面还是同一套界面权限设计是这类系统里最容易翻车的地方。很多毕设项目做成了“一个登录口进来之后靠菜单显隐来区分角色”表面看能用但后端接口没有权限校验学生调一下接口就能访问管理员的数据这就很尴尬。这个项目采用的是RBAC模型用户、角色、菜单三级关联。登录的时候根据角色动态生成路由和菜单后端通过Spring Security或拦截器校验接口权限。前端区分了学生端和管理端两套布局学生端是简洁的申报和进度界面管理端是标准的左右布局后台管理界面。这样做的好处是视觉上符合真实产品的习惯同时学生端接口和管理端接口的URL前缀也分开了权限校验更清晰。数据库里提前预置了三种角色演示的时候直接切换账号就能看到不同视角。2. 技术选型为什么是SpringBoot Vue MyBatis MySQL2.1 SpringBoot 3.x 还是 2.x这是个选择题这个项目标注的是2025最新实际上对应的是SpringBoot 3.x JDK 17的组合。SpringBoot 3.x相比2.x最大的变化是底层基于Spring Framework 6使用了Jakarta EE命名空间也就是javax改成jakarta。这个改动对老项目迁移影响比较大但对新项目来说没任何历史包袱直接上3.x是更合理的决定。SpringBoot 3.x的优势主要有三块启动速度更快内存占用更低对GraalVM Native Image的支持更成熟打包成本地可执行文件成为可能安全性更新和依赖管理更及时。实际开发中我最在意的其实是第三点SpringBoot 2.7以下版本的漏洞公告已经很多了新项目真没必要守旧。当然如果你本地的JDK版本还是8那选择SpringBoot 2.7.18也能跑只是和“2025最新”的定位不太匹配。建议有条件就直接用JDK 17。2.2 MyBatis 和 MyBatis-Plus别再用原生XML写万金油SQL持久层框架选的MyBatis但如果你看源码就会发现实际开发中大量CRUD操作用的是MyBatis-Plus。这不算矛盾MyBatis-Plus本来就是MyBatis的增强工具只做增强不做修改引入后原有的XML映射文件还能继续用。MyBatis-Plus带来的好处非常直接单表CRUD不用写XML了继承一个BaseMapper接口insert、selectById、updateById这些方法直接用分页查询有内置的Page对象条件构造器LambdaQueryWrapper让动态SQL写起来像在写Java代码不需要拼字符串。在实习申报列表这种“按状态查、按学生查、按学院查、按时间段查”的多条件组合场景里LambdaQueryWrapper比XML拼SQL干净太多。不过有一点要提醒大家MyBatis-Plus虽然好用但多表联查它管不了还是得老老实实写XML。这个项目里的统计报表部分有几条SQL是联了三张以上表的手写SQL反而更直观、更容易控制索引。2.3 Vue 2 还是 Vue 3一眼看出项目新旧前端框架选的Vue具体是Vue 3 Vite Element Plus Pinia。看到Vue 3就放心了这个项目不是拿Vue 2的老代码凑数的。Vue 3和Vue 2相比组合式APIComposition API让我写业务逻辑的时候舒服很多一个功能点相关的状态和操作可以放在一起不用像Options API那样data、methods、watch各写各的。Vite替代Vue CLI带来的开发体验提升也是质的飞跃。冷启动按需编译项目大了以后热更新的速度差别非常明显。第一次跑这个前端项目的时候npm install之后执行npm run dev基本两三秒就起来保存代码刷新几乎没感知延迟。Element Plus作为后台管理的UI库组件丰富度是没得说的表格、表单、弹窗、日期选择器、树形控件这些都有而且支持按需引入。这个项目的学生端做得也比较精致申报表单的校验、周报的富文本编辑、材料附件的上传预览都有实际场景支撑。2.4 MySQL 8.0 是底线字符集记得一步到位数据库用的MySQL版本建议直接选8.0以上。原因有几个8.0的窗口函数很好用统计排名一类的SQL写起来可以少掉很多子查询默认字符集utf8mb4能正常存表情符号如果数据库是5.7甚至更老的版本建库时没注意字符集后面查数据看到问号就晚了8.0的JSON类型处理起来比5.7方便虽然这个项目用JSON不多但预留能力总归是好的。MySQL安装之后第一件事就是把字符集和排序规则固定好。我见过很多人本地跑项目时数据库表字段字符集用的默认latin1结果存中文全变乱码排查了半天最后发现是建库时没指定utf8mb4。这个项目的数据库脚本里每个表都显式指定了ENGINEInnoDB DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_general_ci不需要你再额外处理字符集问题但自己新建表的时候一定要记住这个操作。3. 数据库设计一张表讲清楚实习业务3.1 核心表结构和字段规划思路数据库设计是这类系统的灵魂表建不好后面写代码全是泪。这个项目的表大概有十几张我把核心的几张表拿出来说一下设计思路。实习申报表practice_apply是最核心的一张表字段设计基本决定了业务能不能跑通。这张表至少要有这些字段学生ID、实习单位ID、实习岗位、实习开始时间和结束时间、申报状态、指导老师ID、申报时间、审批意见、驳回原因、周报提交数量。状态字段我强烈建议用tinyint类型存数字0表示待提交1表示待审批2表示已通过3表示已驳回不要直接存中文状态字符串。数字的好处是查询条件和统计都好处理前后端再各自映射成文本展示。学生周报表practice_report围绕“过程留痕”设计核心字段包括所属实习申请ID、标题、内容、周报图片、提交时间、教师回复内容、回复时间。这里要注意一张周报表对应一个实习申请所以要建外键关联到practice_apply表的ID。而一个实习申请对应一个学生和一个批准过的实习单位属于一对一关系。加外键约束还是不加我的习惯是业务逻辑上要关联的表物理外键可以不加但逻辑外键必须建索引防止查询时全表扫描。3.2 审批状态机的设计从申报到归档的生命周期实习申请的状态流转是这个系统最需要注意的逻辑之一。设计的思路是状态机模型每个状态下允许的操作都明确限定。学生可以填报申报状态是草稿点提交之后状态变为待审核草稿可以撤回但提交后就不能改教师审核时可以选择通过或驳回通过后进入实习中状态驳回则回到学生端可以修改再提交实习结束后教师录入成绩状态变为已评定。这套状态机没有用专门的框架就是后端接口里用if判断当前状态和操作是否匹配。比如学生提交申请时如果当前状态不是待提交直接抛异常提示“当前状态不允许操作”。代码逻辑看着简单但确实是最可控的方式。引入重状态机框架SysStateMachine一类的组件在这个项目里反而显得多余。另外还有一个细节审批意见和驳回原因不要用update覆盖原记录。我的做法是设计一张审批记录表practice_audit_log把每一次审批的经办人、操作时间、操作类型、意见内容都流水记录起来。这样学生在学生端可以看到每一步的审批轨迹管理员排查问题时也有据可查。很多毕设项目省略了这张表等到演示时老师问“这个审批是谁操作的、什么时候操作的”你就只能尬住。3.3 附件与图片存储别把图片直接怼进数据库周报图片、实习证明附件、学生头像这些文件数据存储方式需要提前想清楚。这个项目采用的是本地文件存储方式上传的文件保存到服务器的一个指定目录下数据库里只存文件的访问路径。Stata路径存在varchar字段里访问时通过后端接口映射出来。这种方式的好处是简单可控适合开发和毕设演示。缺点是没有备份和容灾机制服务器磁盘坏了文件就丢了。有条件的话可以把文件存储模块抽象一下换成OSS或者云存储但作为源码项目本地存储更容易让学的人看懂文件上传的完整链路。上传时有一个比较坑的地方是文件大小限制。SpringBoot默认的单文件上传大小限制是1MB如果你传一个几MB的实习照片会直接报错上传失败。这个需要在配置文件中调整spring.servlet.multipart.max-file-size和max-request-size。另外文件类型校验也不能少前端选择了.jpg、.png后缀后端还得再校验一次MIME类型否则别人把exe改成png后缀传上来系统就成下载站了。4. 核心模块实现从登录到统计的完整链路4.1 基于JWT的登录态管理与权限控制前后端分离的系统中登录态的维持靠的是Token这个项目选用的是JWT。JWT的本质是把用户信息用签名打包成一个字符串服务端不存Session客户端每次请求带着Token后端验签后就能确认身份。这么做的好处是天然适合分布式部署多个后端实例共享同一个验签密钥就能同时服务所有用户。JWT生成的流程是这样的用户登录时后端验证用户名密码然后创建携带着用户ID、角色编码、过期时间戳的Token返回给前端。前端把它存进localStorage或者Pinia的状态管理里每次axios请求通过拦截器自动把Token塞进请求头。后端写一个拦截器或过滤器对所有非放行接口校验Token的合法性通过之后把用户信息放进ThreadLocal后面的业务代码随时可以取到当前登录用户。这里有几个细节值得注意。JWT的密钥一定要放在配置文件中不要硬编码在代码里过期时间设置多少合适太短要频繁登录太长又有安全风险我建议普通后台系统设置为2小时Token被窃取的话有风险所以关键操作比如改密码、驳回审批这些可以再叠加一次操作校验。4.2 实习申报与审批流程的关键代码逻辑实习申报这个功能是整个系统的核心闭环代码路径从前端表单到后端接口再到数据落库。前端页面用Element Plus的Form组件做申报表单字段包括实习单位下拉选择、岗位名称、实习开始时间、结束时间、岗位描述。表单校验规则要配好比如单位必填、时间范围不能倒置、岗位名称长度限制。后端接口接收请求后第一步校验当前用户是否有申报权限第二步校验时间段是否和已有实习冲突第三步把数据插入practice_apply表状态置为待提交。学生点“提交审批”后状态从待提交变为待审核同时往审批记录表插一条提交记录。这里有个容易踩的坑学生可能同时申报多个实习教师端显示审批列表时要有去重逻辑不然一个学生多申请几条列表中满屏都是同一个人的记录要按实习申请ID维度展示而不是按学生维度展示。审批端的接口逻辑也不复杂教师点击通过时后端更新申请状态为已通过更新指导老师字段记录审批意见点击驳回时状态变为已驳回写入驳回原因。关键点在于更新操作要加状态校验防止教师在A页面打开了一条审批单在B页面已经处理完了A页面回来再提交时会出现重复审批。加一个乐观锁版本号字段更新时校验version对不上就提示“该记录已被处理”。4.3 Vue Router路由守卫前端权限控制的正确姿势前端做权限控制核心是路由守卫配合动态路由。这个项目在路由配置上分了静态路由和动态路由。静态路由包括登录页、注册页、首页重定向这三类不需要权限的页面动态路由则是根据用户角色动态生成的路由表。具体实现方式是用户登录后后端返回这个用户的角色编码和权限菜单列表前端拿到菜单数据后动态生成对应的路由配置通过router.addRoute()方法注册到路由实例中。Vue Router的全局前置守卫beforeEach里做逻辑判断如果没有Token直接重定向到登录页如果有Token但路由还没注册先异步获取菜单并生成路由再放行当前导航请求如果已经注册了动态路由就正常放行。这里容易碰到一个页面刷新后路由消失的问题。因为动态路由是存在内存里的刷新页面内存清空路由表就没了。解决办法是在项目初始化时从后端重新拉取菜单数据并重新注册路由。这个项目的处理逻辑比较优雅初始化函数里用一个Promise确保首次路由跳转前动态路由已经注册完毕这样就不会出现刷新后白屏的尴尬。4.4 统计报表的数据实现一张图看懂实习状况管理员端的统计模块是这个项目里技术含量最高的一块。功能上主要包括三块各学院实习人数柱状图、实习单位类型分布饼图、实习成绩分布直方图。这些图表的数据来源是数据库聚合查询后端写SQL分组统计前端用ECharts渲染。学院实习人数统计的核心SQL大概是这样的select 学院名称, count(*) as count from 学生表 inner join 实习申报表 on 学生表.id 实习申报表.学生ID where 实习申报表.状态 已通过 group by 学院ID。数据量小的时候随便查数据量大的时候要考虑给状态字段和学生ID字段建联合索引。前端渲染的时候接口返回的数据结构是[{value: 25, name: 计算机学院}, ...]这样一组键值对ECharts的饼图数据格式正好匹配。柱状图和饼图的配置项网上有大量现成模板改一下数据源就能用。我的建议是统计模块的后端接口至少预留一个时间范围的筛选参数不然日后想按学期统计还得改代码。5. 部署实操从源码到跑起来的完整过程5.1 本地环境准备清单在动手跑这个项目之前先把环境准备好避免装到一半缺依赖。我列一个清单JDK 17以上配置好JAVA_HOME环境变量Node.js 16以上npm能正常使用MySQL 8.0以上本地启动服务Redis可以不装这个项目没有用到Redis缓存开发IDE用IDEA即可也可以直接用VSCodeJDK版本这一点大家一定检查好SpringBoot 3.x要求JDK最低是17你用JDK8跑是肯定起不来的。有些同学电脑里装了多个JDK版本命令行里java -version显示的可能是8实际IDE里配置的又是17这个要留意。5.2 数据库初始化别再手动建表了项目里一般会提供SQL脚本文件这个项目也不例外。拿到脚本后直接在MySQL命令行执行source 你的SQL脚本路径。脚本的内容会创建数据库、创建表结构、插入初始化的数据包括预置的三个角色的账号密码。初始化账号建议提前看一下脚本内容默认账号一般长得比较规律比如admin/123456、teacher/123456、student/123456这种。演示前最好先拿普通学生的账号登录一遍流程确认前端提交、后端审批整个链路没被改坏再把账号密码放在项目说明里。SQL脚本执行过程中如果报错大概率是MySQL版本或者SQL模式的问题。最常遇到的是SQL_MODE只包含STRICT_TRANS_TABLES而脚本里某个字段默认值在严格模式下会报错。解决方案是把SQL_MODE调整为去掉NO_ZERO_DATE等严格选项或者让脚本作者修正脚本的默认值定义。5.3 后端启动的Checklist后端项目导入IDE后第一步先看pom.xml确认依赖下载完成Maven仓库网络不好时下载依赖可能会卡住。配置文件application.yml里要重点检查数据源配置修改数据库地址、用户名、密码为你本机的信息。签名密钥如果写在配置里建议改成一个足够长的随机字符串。启动SpringBoot应用前确认MySQL服务已启动。启动成功后控制台会输出端口号一般是8080然后打开浏览器访问一下后端的接口文档地址。这个项目集成了Swagger或Knife4j的话接口文档页面能直接列出所有接口先跑通一个登录接口确认数据源没问题。5.4 前端联调跨域和代理必须提前搞定前端项目启动前要检查一下接口请求地址的配置。Vite开发环境的代理配置在vite.config.js里一般会把/api前缀的请求代理到后端地址http://localhost:8080。这样前端请求时相对路径为/api/login代理会自动转发到后端的对应接口同时规避了跨域问题。跨域还有另一个解决方法是后端配置CorsFilter允许指定的前端地址跨域访问。两种方案各有利弊前端代理只对本地开发环境生效后端CORS配置对生产环境也有影响从安全角度来说更建议用前端代理。项目里两种方式都兼容了你只需要确认代理目的地地址是不是本机后端的端口。5.5 构建生产包前后端分离部署的完整链路开发调试没问题之后可以尝试构建生产版本。前端执行npm run build构建产物是dist目录下的静态文件里面的JS和CSS被打包压缩过。后端执行mvn package打包成jar包。部署方式有几种简单的是把dist文件拷贝到后端项目的resources/static目录下然后一起打包出一个jar前后端合体运行。这样只需要维护一个服务端口适合演示和轻量部署。更规范的是Nginx部署前端静态文件反向代理到后端的8080端口这样前后端物理分离生产环境也更灵活。两种方式各写一份配置说明你自己选择。6. 常见问题与排坑实录6.1 数据库中文乱码问题这个坑我在初期就被坑过一次。现象是前端页面显示的用户名全是问号但数据库命令行查询时数据却是正常的。原因是数据库连接串里没加字符集参数。解决办法是在jdbc连接URL最后加上?useUnicodetruecharacterEncodingutf8。如果用的是SpringBoot配置文件里把url改成 jdbc:mysql://localhost:3306/dbname?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai。另外MySQL服务器本身的默认字符集也最好设置成utf8mb4不然新建数据库时不指定字符集还是会回到latin1的坑里。6.2 端口被占用超实用的排查命令启动后端时报端口被占用这是老生常谈的问题。Windows下执行netstat -ano | findstr 8080找到占用8080端口的进程PID然后在任务管理器里结束进程。或者直接用Admin权限执行netstat -ano | findstr 8080 taskkill /PID 进程号 /F两步带走。Mac系统用lsof -i:8080查看占用情况。这个排查方法不只是针对Java项目你做任何Web开发都会用到。6.3 前端请求跨域报错弹窗里报blocked by CORS policy说明请求发起方前端地址和后端接收地址不在一个域上。解决办法是优先检查前端代理配置是否生效。Vite的代理需要重启服务才生效改完配置一定重启一下。如果后端是8000端口接受请求前端代理指向了8080请求会404线上排查时优先看代理转发地址和端口是否有拼写错误。6.4 MyBatis日志在哪看执行的SQL排查数据问题时只看接口返回结果还不够需要看到最终执行的SQL语句。在application.yml里配置mybatis日志级别为debug级别控制台里会打印执行的所有SQL和带参数的数据。单独执行一条SQL排查参数拼接问题时还可以直接在MyBatis的XML里写上一个固定值临时测试确认SQL语义正确后再改回动态参数。6.5 第三方依赖下载慢或失败Maven依赖下载慢这个在国内环境很常见。备选方案一把Maven仓库地址改成阿里云镜像在settings.xml里加入mirror节点备选方案二对指定的几个下载不下来的依赖设置为可以先去Maven中央仓库官网搜索最新版本的坐标单独引一下。npm下载慢也是同理设置registry为国内镜像你项目下载依赖的速度会有质的飞跃。7. 二次开发方向和建议这套系统跑通之后还可以在几个方向上做一些很有意思的延伸。第一个方向是消息通知模块化目前的流程审批通过与否都是登录后进系统才看得到想升级用户体验可以对接邮件或企业微信通知服务审批结果推送到学生那里。第二个方向是数据分析增强现在的统计是静态报表可以加入预测模型基于历史实习数据预测热门岗位趋势这种“智慧教育”的卖点在答辩中也更有亮点。第三个方向是把实习过程从“提交周报”升级成“能力画像”让学生每周给自己的技能标签打分最后自动生成实习能力雷达图形成一个相对闭环的个人成长记录。从我个人的实践体会来说一个项目拿到手最重要的不是急着跑起来而是先花半小时把表结构和接口文档梳理一遍。表结构看懂了业务流程自然就通了一半。实习实践管理系统这个题目之所以经典是因为它涵盖了一个真实业务系统的所有标准要素多角色权限、状态流转、表单提交、文件上传、审批流程、数据统计。把这套逻辑吃透换成设备管理、招聘管理、课程管理等任何场景框架和思路都是可以复用的。最后再分享一个小技巧演示这种项目之前先把演示数据准备得丰富一点。比如学生的周报填上三四周的内容实习单位多维护几条各个状态的申请都保留一条统计图表的数据才饱满演示效果会好很多。空着数据库去演示再漂亮的前端页面也显得没内容这是踩过几次坑之后才体会到的。 
长河君 · 2026/10/15 23:46:47 · 阅读 1.2k 基于SpringBoot+Vue+MyBatis+MySQL的智慧教育实习实践管理系统设计与实现
每年毕业设计开题季实训平台、实习管理系统这类题目几乎成了“全栈入门必做题”。但你真去搜一圈就会发现网上大多数所谓“源码”要么结构混乱要么版本太老跑起来全是坑。这次分享的项目是一个基于SpringBoot Vue MyBatis MySQL的面向智慧教育实习实践管理系统代码结构清晰、前后端分离、带完整的权限控制和实习业务流程适合拿来做毕设、课程设计或者作为中小型管理系统的架构参考。这个系统解决的核心问题其实很具体高校实习实践环节中学生找实习、院系审批、指导老师跟踪进度、教务处汇总统计全靠线下Excel和纸质材料信息不同步、数据难追溯。系统把这套流程搬到了线上学生端能申报实习、提交周报、查看成绩教师端能审批、打分、指导管理员端能维护基础数据、看统计报表。整体技术栈非常主流SpringBoot做后端接口、Vue做管理后台和用户端、MyBatis负责数据库交互、MySQL存业务数据适合有Java基础和前端基础的同学二次开发。下面我会从需求拆解、技术选型、数据库设计、核心模块实现、部署实操到问题排查把整个项目掰开揉碎讲一遍。中间会穿插我在实际开发中踩过的坑和调试经验尽量让你看完不只是“会跑”而是真的“懂”。1. 需求拆解智慧教育实习实践系统到底要解决什么问题1.1 “智慧教育”不是口号是流程再造很多人看到“智慧教育”这四个字就头大觉得是蹭概念。实际上放在实习实践管理这个场景里“智慧”二字体现在三个地方一是数据通学生从申报实习到最终成绩评定全程数字化留痕谁审批了、谁打的分系统里都能查到二是流程顺审批节点从学生提交到指导老师初审再到院系审核全部线上流转不用各个办公室来回跑三是决策有依据管理员端能看到各专业实习人数、对口率、企业分布等统计图表这不是花架子是真能给教学管理提供参考的。我当时拿到这个题目的第一反应是先列角色再理流程。系统里三类核心用户学生、教师含指导老师和院系管理员、系统管理员。学生的核心操作是填报实习申请、查看审批进度、提交实习周报、查看实习成绩。教师的操作是审批实习申请、查看学生周报并回复、录入实习成绩、查看带教名单。管理员负责基础数据维护比如院系和专业管理、实习单位库管理、用户账号管理、系统统计。逻辑就是“学生申报、教师审批、过程留痕、结果统计”这十六个字。1.2 功能模块砍到多少才算够用实习实践系统的功能可以做得非常复杂比如对接第三方实习平台、在线签到打卡、AI简历诊断等等。但作为一套可落地、可演示、可二次开发的源码项目功能要“够用且完整”太少没有参考价值太多容易把代码结构撑散。这个项目的功能清单大概是这样的用户模块登录、注册、个人信息维护、密码修改实习申报模块学生填写实习申请实习单位、岗位、时间、指导教师、提交审批、查看审批进度审批模块教师端待办列表、通过/驳回、审批意见填写过程管理模块学生提交周报实习内容、心得、图片附件、教师查看并回复成绩模块教师按学生打分录入评语支持成绩导出实习单位模块管理员维护合作单位库供学生申报时选择统计模块按学院、专业统计实习人数、实习单位类型分布、成绩分布系统管理模块用户管理、角色权限分配、菜单管理、数据字典这套功能基本覆盖了实习实践从申报到归档的全流程而且每个模块都是独立的前后端接口拆开来学或者合在一起跑都行。1.3 权限模型三套界面还是同一套界面权限设计是这类系统里最容易翻车的地方。很多毕设项目做成了“一个登录口进来之后靠菜单显隐来区分角色”表面看能用但后端接口没有权限校验学生调一下接口就能访问管理员的数据这就很尴尬。这个项目采用的是RBAC模型用户、角色、菜单三级关联。登录的时候根据角色动态生成路由和菜单后端通过Spring Security或拦截器校验接口权限。前端区分了学生端和管理端两套布局学生端是简洁的申报和进度界面管理端是标准的左右布局后台管理界面。这样做的好处是视觉上符合真实产品的习惯同时学生端接口和管理端接口的URL前缀也分开了权限校验更清晰。数据库里提前预置了三种角色演示的时候直接切换账号就能看到不同视角。2. 技术选型为什么是SpringBoot Vue MyBatis MySQL2.1 SpringBoot 3.x 还是 2.x这是个选择题这个项目标注的是2025最新实际上对应的是SpringBoot 3.x JDK 17的组合。SpringBoot 3.x相比2.x最大的变化是底层基于Spring Framework 6使用了Jakarta EE命名空间也就是javax改成jakarta。这个改动对老项目迁移影响比较大但对新项目来说没任何历史包袱直接上3.x是更合理的决定。SpringBoot 3.x的优势主要有三块启动速度更快内存占用更低对GraalVM Native Image的支持更成熟打包成本地可执行文件成为可能安全性更新和依赖管理更及时。实际开发中我最在意的其实是第三点SpringBoot 2.7以下版本的漏洞公告已经很多了新项目真没必要守旧。当然如果你本地的JDK版本还是8那选择SpringBoot 2.7.18也能跑只是和“2025最新”的定位不太匹配。建议有条件就直接用JDK 17。2.2 MyBatis 和 MyBatis-Plus别再用原生XML写万金油SQL持久层框架选的MyBatis但如果你看源码就会发现实际开发中大量CRUD操作用的是MyBatis-Plus。这不算矛盾MyBatis-Plus本来就是MyBatis的增强工具只做增强不做修改引入后原有的XML映射文件还能继续用。MyBatis-Plus带来的好处非常直接单表CRUD不用写XML了继承一个BaseMapper接口insert、selectById、updateById这些方法直接用分页查询有内置的Page对象条件构造器LambdaQueryWrapper让动态SQL写起来像在写Java代码不需要拼字符串。在实习申报列表这种“按状态查、按学生查、按学院查、按时间段查”的多条件组合场景里LambdaQueryWrapper比XML拼SQL干净太多。不过有一点要提醒大家MyBatis-Plus虽然好用但多表联查它管不了还是得老老实实写XML。这个项目里的统计报表部分有几条SQL是联了三张以上表的手写SQL反而更直观、更容易控制索引。2.3 Vue 2 还是 Vue 3一眼看出项目新旧前端框架选的Vue具体是Vue 3 Vite Element Plus Pinia。看到Vue 3就放心了这个项目不是拿Vue 2的老代码凑数的。Vue 3和Vue 2相比组合式APIComposition API让我写业务逻辑的时候舒服很多一个功能点相关的状态和操作可以放在一起不用像Options API那样data、methods、watch各写各的。Vite替代Vue CLI带来的开发体验提升也是质的飞跃。冷启动按需编译项目大了以后热更新的速度差别非常明显。第一次跑这个前端项目的时候npm install之后执行npm run dev基本两三秒就起来保存代码刷新几乎没感知延迟。Element Plus作为后台管理的UI库组件丰富度是没得说的表格、表单、弹窗、日期选择器、树形控件这些都有而且支持按需引入。这个项目的学生端做得也比较精致申报表单的校验、周报的富文本编辑、材料附件的上传预览都有实际场景支撑。2.4 MySQL 8.0 是底线字符集记得一步到位数据库用的MySQL版本建议直接选8.0以上。原因有几个8.0的窗口函数很好用统计排名一类的SQL写起来可以少掉很多子查询默认字符集utf8mb4能正常存表情符号如果数据库是5.7甚至更老的版本建库时没注意字符集后面查数据看到问号就晚了8.0的JSON类型处理起来比5.7方便虽然这个项目用JSON不多但预留能力总归是好的。MySQL安装之后第一件事就是把字符集和排序规则固定好。我见过很多人本地跑项目时数据库表字段字符集用的默认latin1结果存中文全变乱码排查了半天最后发现是建库时没指定utf8mb4。这个项目的数据库脚本里每个表都显式指定了ENGINEInnoDB DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_general_ci不需要你再额外处理字符集问题但自己新建表的时候一定要记住这个操作。3. 数据库设计一张表讲清楚实习业务3.1 核心表结构和字段规划思路数据库设计是这类系统的灵魂表建不好后面写代码全是泪。这个项目的表大概有十几张我把核心的几张表拿出来说一下设计思路。实习申报表practice_apply是最核心的一张表字段设计基本决定了业务能不能跑通。这张表至少要有这些字段学生ID、实习单位ID、实习岗位、实习开始时间和结束时间、申报状态、指导老师ID、申报时间、审批意见、驳回原因、周报提交数量。状态字段我强烈建议用tinyint类型存数字0表示待提交1表示待审批2表示已通过3表示已驳回不要直接存中文状态字符串。数字的好处是查询条件和统计都好处理前后端再各自映射成文本展示。学生周报表practice_report围绕“过程留痕”设计核心字段包括所属实习申请ID、标题、内容、周报图片、提交时间、教师回复内容、回复时间。这里要注意一张周报表对应一个实习申请所以要建外键关联到practice_apply表的ID。而一个实习申请对应一个学生和一个批准过的实习单位属于一对一关系。加外键约束还是不加我的习惯是业务逻辑上要关联的表物理外键可以不加但逻辑外键必须建索引防止查询时全表扫描。3.2 审批状态机的设计从申报到归档的生命周期实习申请的状态流转是这个系统最需要注意的逻辑之一。设计的思路是状态机模型每个状态下允许的操作都明确限定。学生可以填报申报状态是草稿点提交之后状态变为待审核草稿可以撤回但提交后就不能改教师审核时可以选择通过或驳回通过后进入实习中状态驳回则回到学生端可以修改再提交实习结束后教师录入成绩状态变为已评定。这套状态机没有用专门的框架就是后端接口里用if判断当前状态和操作是否匹配。比如学生提交申请时如果当前状态不是待提交直接抛异常提示“当前状态不允许操作”。代码逻辑看着简单但确实是最可控的方式。引入重状态机框架SysStateMachine一类的组件在这个项目里反而显得多余。另外还有一个细节审批意见和驳回原因不要用update覆盖原记录。我的做法是设计一张审批记录表practice_audit_log把每一次审批的经办人、操作时间、操作类型、意见内容都流水记录起来。这样学生在学生端可以看到每一步的审批轨迹管理员排查问题时也有据可查。很多毕设项目省略了这张表等到演示时老师问“这个审批是谁操作的、什么时候操作的”你就只能尬住。3.3 附件与图片存储别把图片直接怼进数据库周报图片、实习证明附件、学生头像这些文件数据存储方式需要提前想清楚。这个项目采用的是本地文件存储方式上传的文件保存到服务器的一个指定目录下数据库里只存文件的访问路径。Stata路径存在varchar字段里访问时通过后端接口映射出来。这种方式的好处是简单可控适合开发和毕设演示。缺点是没有备份和容灾机制服务器磁盘坏了文件就丢了。有条件的话可以把文件存储模块抽象一下换成OSS或者云存储但作为源码项目本地存储更容易让学的人看懂文件上传的完整链路。上传时有一个比较坑的地方是文件大小限制。SpringBoot默认的单文件上传大小限制是1MB如果你传一个几MB的实习照片会直接报错上传失败。这个需要在配置文件中调整spring.servlet.multipart.max-file-size和max-request-size。另外文件类型校验也不能少前端选择了.jpg、.png后缀后端还得再校验一次MIME类型否则别人把exe改成png后缀传上来系统就成下载站了。4. 核心模块实现从登录到统计的完整链路4.1 基于JWT的登录态管理与权限控制前后端分离的系统中登录态的维持靠的是Token这个项目选用的是JWT。JWT的本质是把用户信息用签名打包成一个字符串服务端不存Session客户端每次请求带着Token后端验签后就能确认身份。这么做的好处是天然适合分布式部署多个后端实例共享同一个验签密钥就能同时服务所有用户。JWT生成的流程是这样的用户登录时后端验证用户名密码然后创建携带着用户ID、角色编码、过期时间戳的Token返回给前端。前端把它存进localStorage或者Pinia的状态管理里每次axios请求通过拦截器自动把Token塞进请求头。后端写一个拦截器或过滤器对所有非放行接口校验Token的合法性通过之后把用户信息放进ThreadLocal后面的业务代码随时可以取到当前登录用户。这里有几个细节值得注意。JWT的密钥一定要放在配置文件中不要硬编码在代码里过期时间设置多少合适太短要频繁登录太长又有安全风险我建议普通后台系统设置为2小时Token被窃取的话有风险所以关键操作比如改密码、驳回审批这些可以再叠加一次操作校验。4.2 实习申报与审批流程的关键代码逻辑实习申报这个功能是整个系统的核心闭环代码路径从前端表单到后端接口再到数据落库。前端页面用Element Plus的Form组件做申报表单字段包括实习单位下拉选择、岗位名称、实习开始时间、结束时间、岗位描述。表单校验规则要配好比如单位必填、时间范围不能倒置、岗位名称长度限制。后端接口接收请求后第一步校验当前用户是否有申报权限第二步校验时间段是否和已有实习冲突第三步把数据插入practice_apply表状态置为待提交。学生点“提交审批”后状态从待提交变为待审核同时往审批记录表插一条提交记录。这里有个容易踩的坑学生可能同时申报多个实习教师端显示审批列表时要有去重逻辑不然一个学生多申请几条列表中满屏都是同一个人的记录要按实习申请ID维度展示而不是按学生维度展示。审批端的接口逻辑也不复杂教师点击通过时后端更新申请状态为已通过更新指导老师字段记录审批意见点击驳回时状态变为已驳回写入驳回原因。关键点在于更新操作要加状态校验防止教师在A页面打开了一条审批单在B页面已经处理完了A页面回来再提交时会出现重复审批。加一个乐观锁版本号字段更新时校验version对不上就提示“该记录已被处理”。4.3 Vue Router路由守卫前端权限控制的正确姿势前端做权限控制核心是路由守卫配合动态路由。这个项目在路由配置上分了静态路由和动态路由。静态路由包括登录页、注册页、首页重定向这三类不需要权限的页面动态路由则是根据用户角色动态生成的路由表。具体实现方式是用户登录后后端返回这个用户的角色编码和权限菜单列表前端拿到菜单数据后动态生成对应的路由配置通过router.addRoute()方法注册到路由实例中。Vue Router的全局前置守卫beforeEach里做逻辑判断如果没有Token直接重定向到登录页如果有Token但路由还没注册先异步获取菜单并生成路由再放行当前导航请求如果已经注册了动态路由就正常放行。这里容易碰到一个页面刷新后路由消失的问题。因为动态路由是存在内存里的刷新页面内存清空路由表就没了。解决办法是在项目初始化时从后端重新拉取菜单数据并重新注册路由。这个项目的处理逻辑比较优雅初始化函数里用一个Promise确保首次路由跳转前动态路由已经注册完毕这样就不会出现刷新后白屏的尴尬。4.4 统计报表的数据实现一张图看懂实习状况管理员端的统计模块是这个项目里技术含量最高的一块。功能上主要包括三块各学院实习人数柱状图、实习单位类型分布饼图、实习成绩分布直方图。这些图表的数据来源是数据库聚合查询后端写SQL分组统计前端用ECharts渲染。学院实习人数统计的核心SQL大概是这样的select 学院名称, count(*) as count from 学生表 inner join 实习申报表 on 学生表.id 实习申报表.学生ID where 实习申报表.状态 已通过 group by 学院ID。数据量小的时候随便查数据量大的时候要考虑给状态字段和学生ID字段建联合索引。前端渲染的时候接口返回的数据结构是[{value: 25, name: 计算机学院}, ...]这样一组键值对ECharts的饼图数据格式正好匹配。柱状图和饼图的配置项网上有大量现成模板改一下数据源就能用。我的建议是统计模块的后端接口至少预留一个时间范围的筛选参数不然日后想按学期统计还得改代码。5. 部署实操从源码到跑起来的完整过程5.1 本地环境准备清单在动手跑这个项目之前先把环境准备好避免装到一半缺依赖。我列一个清单JDK 17以上配置好JAVA_HOME环境变量Node.js 16以上npm能正常使用MySQL 8.0以上本地启动服务Redis可以不装这个项目没有用到Redis缓存开发IDE用IDEA即可也可以直接用VSCodeJDK版本这一点大家一定检查好SpringBoot 3.x要求JDK最低是17你用JDK8跑是肯定起不来的。有些同学电脑里装了多个JDK版本命令行里java -version显示的可能是8实际IDE里配置的又是17这个要留意。5.2 数据库初始化别再手动建表了项目里一般会提供SQL脚本文件这个项目也不例外。拿到脚本后直接在MySQL命令行执行source 你的SQL脚本路径。脚本的内容会创建数据库、创建表结构、插入初始化的数据包括预置的三个角色的账号密码。初始化账号建议提前看一下脚本内容默认账号一般长得比较规律比如admin/123456、teacher/123456、student/123456这种。演示前最好先拿普通学生的账号登录一遍流程确认前端提交、后端审批整个链路没被改坏再把账号密码放在项目说明里。SQL脚本执行过程中如果报错大概率是MySQL版本或者SQL模式的问题。最常遇到的是SQL_MODE只包含STRICT_TRANS_TABLES而脚本里某个字段默认值在严格模式下会报错。解决方案是把SQL_MODE调整为去掉NO_ZERO_DATE等严格选项或者让脚本作者修正脚本的默认值定义。5.3 后端启动的Checklist后端项目导入IDE后第一步先看pom.xml确认依赖下载完成Maven仓库网络不好时下载依赖可能会卡住。配置文件application.yml里要重点检查数据源配置修改数据库地址、用户名、密码为你本机的信息。签名密钥如果写在配置里建议改成一个足够长的随机字符串。启动SpringBoot应用前确认MySQL服务已启动。启动成功后控制台会输出端口号一般是8080然后打开浏览器访问一下后端的接口文档地址。这个项目集成了Swagger或Knife4j的话接口文档页面能直接列出所有接口先跑通一个登录接口确认数据源没问题。5.4 前端联调跨域和代理必须提前搞定前端项目启动前要检查一下接口请求地址的配置。Vite开发环境的代理配置在vite.config.js里一般会把/api前缀的请求代理到后端地址http://localhost:8080。这样前端请求时相对路径为/api/login代理会自动转发到后端的对应接口同时规避了跨域问题。跨域还有另一个解决方法是后端配置CorsFilter允许指定的前端地址跨域访问。两种方案各有利弊前端代理只对本地开发环境生效后端CORS配置对生产环境也有影响从安全角度来说更建议用前端代理。项目里两种方式都兼容了你只需要确认代理目的地地址是不是本机后端的端口。5.5 构建生产包前后端分离部署的完整链路开发调试没问题之后可以尝试构建生产版本。前端执行npm run build构建产物是dist目录下的静态文件里面的JS和CSS被打包压缩过。后端执行mvn package打包成jar包。部署方式有几种简单的是把dist文件拷贝到后端项目的resources/static目录下然后一起打包出一个jar前后端合体运行。这样只需要维护一个服务端口适合演示和轻量部署。更规范的是Nginx部署前端静态文件反向代理到后端的8080端口这样前后端物理分离生产环境也更灵活。两种方式各写一份配置说明你自己选择。6. 常见问题与排坑实录6.1 数据库中文乱码问题这个坑我在初期就被坑过一次。现象是前端页面显示的用户名全是问号但数据库命令行查询时数据却是正常的。原因是数据库连接串里没加字符集参数。解决办法是在jdbc连接URL最后加上?useUnicodetruecharacterEncodingutf8。如果用的是SpringBoot配置文件里把url改成 jdbc:mysql://localhost:3306/dbname?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai。另外MySQL服务器本身的默认字符集也最好设置成utf8mb4不然新建数据库时不指定字符集还是会回到latin1的坑里。6.2 端口被占用超实用的排查命令启动后端时报端口被占用这是老生常谈的问题。Windows下执行netstat -ano | findstr 8080找到占用8080端口的进程PID然后在任务管理器里结束进程。或者直接用Admin权限执行netstat -ano | findstr 8080 taskkill /PID 进程号 /F两步带走。Mac系统用lsof -i:8080查看占用情况。这个排查方法不只是针对Java项目你做任何Web开发都会用到。6.3 前端请求跨域报错弹窗里报blocked by CORS policy说明请求发起方前端地址和后端接收地址不在一个域上。解决办法是优先检查前端代理配置是否生效。Vite的代理需要重启服务才生效改完配置一定重启一下。如果后端是8000端口接受请求前端代理指向了8080请求会404线上排查时优先看代理转发地址和端口是否有拼写错误。6.4 MyBatis日志在哪看执行的SQL排查数据问题时只看接口返回结果还不够需要看到最终执行的SQL语句。在application.yml里配置mybatis日志级别为debug级别控制台里会打印执行的所有SQL和带参数的数据。单独执行一条SQL排查参数拼接问题时还可以直接在MyBatis的XML里写上一个固定值临时测试确认SQL语义正确后再改回动态参数。6.5 第三方依赖下载慢或失败Maven依赖下载慢这个在国内环境很常见。备选方案一把Maven仓库地址改成阿里云镜像在settings.xml里加入mirror节点备选方案二对指定的几个下载不下来的依赖设置为可以先去Maven中央仓库官网搜索最新版本的坐标单独引一下。npm下载慢也是同理设置registry为国内镜像你项目下载依赖的速度会有质的飞跃。7. 二次开发方向和建议这套系统跑通之后还可以在几个方向上做一些很有意思的延伸。第一个方向是消息通知模块化目前的流程审批通过与否都是登录后进系统才看得到想升级用户体验可以对接邮件或企业微信通知服务审批结果推送到学生那里。第二个方向是数据分析增强现在的统计是静态报表可以加入预测模型基于历史实习数据预测热门岗位趋势这种“智慧教育”的卖点在答辩中也更有亮点。第三个方向是把实习过程从“提交周报”升级成“能力画像”让学生每周给自己的技能标签打分最后自动生成实习能力雷达图形成一个相对闭环的个人成长记录。从我个人的实践体会来说一个项目拿到手最重要的不是急着跑起来而是先花半小时把表结构和接口文档梳理一遍。表结构看懂了业务流程自然就通了一半。实习实践管理系统这个题目之所以经典是因为它涵盖了一个真实业务系统的所有标准要素多角色权限、状态流转、表单提交、文件上传、审批流程、数据统计。把这套逻辑吃透换成设备管理、招聘管理、课程管理等任何场景框架和思路都是可以复用的。最后再分享一个小技巧演示这种项目之前先把演示数据准备得丰富一点。比如学生的周报填上三四周的内容实习单位多维护几条各个状态的申请都保留一条统计图表的数据才饱满演示效果会好很多。空着数据库去演示再漂亮的前端页面也显得没内容这是踩过几次坑之后才体会到的。