最近帮人调试一套基于SpringBootVue的大学生实习与就业管理系统这类项目在Java方向的项目里属于典型的管理系统练手选题。学生端要写实习申请、交周报企业端要发招聘岗位、看简历教师端负责审批审核管理员做数据统计一套业务逻辑完整但又不至于复杂到做不下去很适合用熟悉前后端分离开发的完整流程。整套系统从需求拆解、数据库设计、前后端联调、服务器部署再到项目文档整理我前前后后走了两遍踩了不少坑。这篇文章会把整个链路串一遍重点讲清楚每一步为什么这么选SpringBoot版本太高怎么处理、前端环境装不上的常见原因、部署后接口404怎么排查这些高频问题都会展开说。如果你正在准备课程设计或毕业设计或者刚学完SpringBoot和Vue框架想拿一个完整项目练手可以参考这套方案。1. 项目整体设计与技术选型1.1 核心需求拆解这类系统到底要管什么大学生实习与就业管理系统听名字很大拆开看核心就两件事实习过程管理就业信息管理。参与的角色主要有四类学生、企业HR、教师、管理员。学生端要处理的是“找实习、找工作的过程管理”填写实习申请、提交每周周报、查看教师审核结果、浏览企业发布的岗位、投递简历、接收面试或录用通知。企业端相对简单发布招聘岗位、查看收到的简历、变更投递状态待查看、已查看、面试邀请、已录用、已拒绝。教师端集中在审核和统计审批学生的实习申请、查阅学生周报、按专业或班级统计就业率。管理员则管用户账号、角色分配、公告发布、基础数据维护。两条业务主线再拉细一点实习是“申请-审批-周报-评价”的闭合流程就业是“企业入驻-岗位发布-简历投递-录取反馈”的信息流。设计时只要把这两条线走通页面分布基本就出来了。学生端是首页看板、实习申请、周报填写、岗位大厅、简历中心、个人中心教师端是审核中心、学生实习档案、就业统计企业端是岗位管理、简历管理管理员端是用户管理、公告管理。做这类系统最忌讳一上来就堆功能。先把用例图画出来一条一条列清楚每个角色能做什么再决定页面和接口后面写代码乱不到哪去。很多人项目做到一半改需求基本都是前期这块没做透。1.2 技术栈选型的底层逻辑为什么是SpringBootVueSpringBoot在这个场景下几乎是标准答案。相比SSH那些老框架SpringBoot的自动配置把大量重复配置工作消掉了内嵌Tomcat让应用可以java -jar一键启动starter机制按需引入依赖生态又足够成熟网上能搜到的问题资料也很多。对于学生项目来说短期内能快速落地、答辩时能讲清楚原理这两点比技术炫技重要得多。Vue这边的优势是组件化开发和前后端分离。Element Plus组件库可以快速砌出后台管理界面Vue的响应式数据绑定让表单和表格操作非常顺手而且前后端分离后后端接口只要按照约定的JSON格式返回数据前端页面怎么组织完全独立分工调试都方便。版本选型这块是很多人栽跟头的地方我直接给一套目前最稳的组合后端SpringBoot 2.7.x JDK 8 MyBatis-Plus 3.5.x MySQL 8.0前端Vue 3 Vite Element Plus Axios Vue Router PiniaSpringBoot到底用2.7还是3.x这里需要多说两句。SpringBoot 3.0之后强制要求JDK 17同时把javax包迁移到了jakarta很多老教程、老依赖、代码生成工具在新版本下直接不可用。网上经常看到“springboot版本太高”的求助基本都是新建项目时直接选3.1、3.2结果MyBatis-Plus的配置类找不到或者启动报javax的相关错误。我做这类项目一律锁在2.7.x把pom里的parent版本写死不随便往上动。数据库选MySQL 8.0而不是5.7主要考虑8.0在时间精度、字符集支持、JSON类型上更友好连接驱动也更规范避免后面因为驱动版本问题折腾。2. 数据库设计与核心模块实现2.1 表结构设计角色权限、核心业务表项目的表结构我分三层来看。第一层是用户层一张sys_user表统一放账号密码用role字段区分学生、教师、企业、管理员四种角色第二层是扩展信息层学生信息、企业信息、教师信息单独建表存各自有业务含义的字段第三层是业务表实习申请、周报、岗位、投递记录、简历、公告全部挂在核心业务下。统一用户表的好处是登录逻辑只要写一套JWT签发、拦截器校验、权限判断都围绕role字段做判断后面要给某个角色加字段扩展信息表里加列即可不会牵扯到登录认证。不建议建三张用户表再各自维护登录状态那是给自己埋雷。实习申请表的重点字段包括student_id、company_name、position、start_date、end_date、status、teacher_comment。status用整型字典表示0待审核、1已通过、2已驳回前端用字典翻译成文字。这样设计是为了数据库层面查询方便例如教师端“待我审核的申请”直接where status 0不用匹配字符串。周报表相对简单student_id、report_date、content、images注意一个学生可能会补交旧周报所以在业务层面加个唯一约束一个学生一个周期内只能有一条周报避免重复提交。岗位表在就业信息流里是核心。公司ID外键、岗位名称、岗位类型、薪资范围、岗位描述、状态、截止日期。投递记录表那就是岗位ID、学生ID、状态外加企业备注。这里特别说明一下外键策略外键可以在MySQL层声明但实际业务增删改时很多项目选择让Service层做逻辑校验。如果用了MyBatis-Plus外键约束会导致一些自动填充逻辑不好处理。我这里的情况是表结构保留外键字段但不强制加FOREIGN KEY查询时用JOIN或关联查询自己组装数据灵活度更高。简历表如果做得轻可以是一张resume表存姓名、电话、教育经历、项目经历、自我评价等字段。如果做得重推荐content字段存JSON字符串前端用富文本编辑器生成HTML后端原样存储。JSON方案能让简历排版自由度非常高而且不用频繁改表结构。另外每张业务表都要带上create_time、update_time、deleted这三个字段。MyBatis-Plus的TableLogic字段配合逻辑删除删除记录时自动变成update deleted1比物理删除安全得多这个习惯值得坚持。2.2 登录认证与权限控制的实现思路登录认证这块我用的方案是JWT令牌加HandlerInterceptor拦截器没有把Spring Security整套引进来。先解释为什么不用Spring Security。学生管理系统虽然有四类角色但权限模型并不复杂每个接口基本就是判断一下当前用户的role有没有权限。Spring Security配置繁琐对于简易业务来说是负担。JWT加拦截器的方式直观代码量小答辩时也容易讲清楚。密码加密用BCrypt单独引入spring-security-crypto这个工具包就行不需要整个Spring Security。注册时用BCryptPasswordEncoder.encode加密登录时matches校验数据库里存的是不可逆的密文即使数据库泄露密码也不会以明文形式暴露。登录接口流程是账号密码校验通过后用用户ID和角色生成JWT返回给前端。前端把token存localStorage每次请求由axios拦截器塞进请求头。后端拦截器从Header里取token解析失败或过期直接返回401状态码和统一错误信息。解析成功就把用户信息塞到ThreadLocal里Controller层直接用方法取出当前用户ID不用每次在参数里传userId。前端路由守卫同样做一层控制。router.beforeEach里先判断有没有token没有就跳登录页有token再根据角色判断当前路由是否在其允许访问的列表里不在就跳403页面。后端有接口层校验前端有页面级路由控制两层叠加权限模型就比较扎实了。核心代码片段并不复杂拦截器里主要是JWT解析逻辑。注册拦截器时需要排除登录、注册、验证码、文件下载等公开接口这块漏了就出现“登录之后一切正常但登录前那些公开接口也被拦截了”的困扰。2.3 学生端核心业务实习申请与周报、简历投递实习申请的流程可以看作一个简单的状态机。学生填写公司名称、实习岗位、起止时间提交后状态为0待审核。教师端从待审核列表里看到申请点击通过后状态变为1驳回时必填审核意见。学生端展示的状态会根据数字映射为不同标签颜色未通过的申请允许修改后再次提交重新提交时状态回到0。这里要特别处理一个并发问题学生可能双击提交按钮导致生成两条申请记录。解决方案有两个层面前端提交时按钮加loading和disabled后端在Service里对同一个学生的待审核状态记录做唯一性校验。两个都做了基本不会出问题。周报这块就是纯CRUD没啥复杂的。唯一要注意的是周报内容支持图文混排图片上传到服务器的upload目录或对象存储数据库里只存图片访问URL路径。上传文件时后端要校验文件大小和扩展名配置文件里设置spring.servlet.multipart.max-file-size避免学生传个几十兆的视频把服务器打爆。简历投递的逻辑是从岗位大厅点击“立即投递”先检查该学生是否已创建简历没创建就跳转提示去简历中心完善简历已创建就往投递记录表插一条数据状态置为待查看。企业端看到新投递后依次更新状态已查看、面试邀请、已录用或已拒绝。就业信息流里最重要的统计逻辑就是这个企业录用了多少人、各专业初次就业率多少基于投递记录表的数据做聚合统计即可。3. 前后端联调与部署实操3.1 SpringBoot后端关键配置与常见版本坑直接给一份我在项目中实测可用的application.yml核心配置里面几个点都有讲究server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/internship_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 123456 servlet: multipart: max-file-size: 10MB max-request-size: 20MB mybatis-plus: mapper-locations: classpath*:mapper/**/*.xml configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0连接MySQL 8.0时url里的serverTimezoneAsia/Shanghai基本是必备的不加这个参数数据库连接可能报错或者时间凭空多出8小时。useSSLfalse是告诉驱动不需要SSL握手单纯为了省事生产环境建议根据实际情况调整。MyBatis-Plus的map-underscore-to-camel-case表示数据库下划线字段自动映射为驼峰属性。这一项必须开启。否则查出来的数据全是null但不是数据库的问题是映射规则没配置好。分页插件这个坑要说一下。MyBatis-Plus的PaginationInnerInterceptor必须手动加入配置类否则Page对象虽然看起来传入QueryWrapper实际查询结果却返回全部数据分页完全失效。CORS配置这块容易写错。用WebMvcConfigurer重写addCorsMappings时allowCredentials(true)和allowedOrigins()同时使用会导致浏览器直接报错要么用allowedOriginPatterns()要么就不开allowCredentials。实际上开发环境前端用Vite代理解决跨域生产环境用Nginx代理后端CORS完全可以不开我这里的习惯是后端只对本地调试时的前端地址开放保持接口的安全边界。再强调一遍版本坑。新建项目如果选了SpringBoot 3.x后面查资料看到的大部分代码示例都可能跑不起来javax.servlet不存在、MyBatis-Plus的分页插件包路径变了、部分代码生成器不支持。很多同学报“springboot版本太高”没法处理我只能建议换回2.7.x。等到真正理解了底层差异再升级3.x也不迟。3.2 Vue前端环境配置与接口对接先配置Node.js环境。Vite要求Node版本16.0以上我建议直接用Vue3的基础上装Node 18或20的LTS版本用nvm-windows或nvm管理多版本避免以后切换项目版本麻烦。npm默认源在国内安装依赖很慢先把镜像切到淘宝源npm config set registry https://registry.npmmirror.com创建项目时我推荐用npm create vitelatest命令选择Vue和JavaScript模板。不太建议选TypeScript模板除非你本身熟悉TS以及各种类型声明。热词里经常看到failed to load tsconfig vue/tsconfig/tsconfig.web.json这种就是Vue3 TS模板在部分环境下配置不完整导致的对初学者来说直接换JS模板最省心。项目创建后安装核心依赖npm install vue-router4 pinia element-plus axiosaxios封装可以直接参考下面的写法。这个文件是前后端联调的命脉很多接口报错都出在拦截器这里。import axios from axios import { ElMessage } from element-plus import router from ../router const request axios.create({ baseURL: import.meta.env.VITE_API_BASE_URL || /api, timeout: 10000 }) request.interceptors.request.use(config { const token localStorage.getItem(token) if (token) { config.headers.Authorization token } return config }) request.interceptors.response.use( response { const res response.data if (res.code ! 200) { ElMessage.error(res.msg || 请求出错) return Promise.reject(new Error(res.msg)) } return res }, error { if (error.response error.response.status 401) { localStorage.removeItem(token) router.push(/login) } ElMessage.error(error.message || 网络异常) return Promise.reject(error) } ) export default request开发环境的跨域交给Vite代理处理。在vite.config.js里配置server: { host: 0.0.0.0, port: 5173, proxy: { /api: { target: http://localhost:8080, changeOrigin: true, rewrite: (path) path.replace(/^\/api/, ) } } }这个配置的含义是前端请求/api/login会被代理到后端http://localhost:8080/loginpath开头的/api被干掉。后端接口路径不需要带/api前缀。前后端约定好一套路径规则后面部署时Nginx也沿用这个思路。3.3 部署上线从本地到服务器的完整流程本地跑通只是第一步很多系统拿到服务器上就各种404、500。我这里从买完服务器开始把部署流程完整过一遍。服务器配置选2核4G系统用Ubuntu 22.04或CentOS 7.9都行。首先要做的是在安全组规则里放行80和443端口后端8080端口不需要对外开放对外只暴露80由Nginx转发到本机8080这样后端接口不会直接暴露在公网环境。环境准备这部分JDK用8版本MySQL用8.0Nginx直接通过apt或yum安装。数据库建库和初始化mysql -uroot -p create database internship_db default character set utf8mb4;后端打包之前先把数据库连接配置改成服务器环境然后再执行mvn clean package -DskipTeststarget目录下生成的jar包用scp或宝塔面板上传到服务器然后后台启动nohup java -jar internship-system.jar system.log 21 启动后用curl验证接口是否正常curl http://localhost:8080/api/health前端打包则是npm run build生成dist目录把dist里的所有文件上传到Nginx的web目录比如/usr/share/nginx/html。Nginx配置文件是部署时的重点放一份直接可用的配置server { listen 80; server_name _; root /usr/share/nginx/html; index index.html; location / { try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }location /里的try_files是给前端history路由用的没有这一行页面刷新时就会出现404。location /api/里的proxy_pass末尾的斜杠会把/api前缀去掉转发到后端时就是干净的接口路径。重新加载Nginx配置nginx -s reload整个链路是浏览器访问服务器80端口Nginx返回静态页面文件页面里的请求/api开头Nginx把请求转发到localhost:8080的Java后端后端操作MySQL并把JSON返回给前端。这一条链路想清楚部署时很多问题都能自己判断出是卡在哪一环。4. 常见问题与排查技巧实录4.1 SpringBoot启动异常高频问题我整理了实际调试中高频出现的后端启动问题直接对照着排查问题现象根本原因解决办法Port 8080 was already in use端口被其他进程占用lsof -i:8080找到进程kill或改server.portFailed to configure a DataSource数据源配置缺失或连接串错误检查application.yml里的url、账号、密码ClassNotFoundException: javax.servletSpringBoot 3.x与旧依赖不兼容回退SpringBoot 2.7.x或升级第三方依赖Whitelabel Error PageController返回路径对应不上检查RestController/RequestMapping注解Invalid bound statement (not found)Mapper XML没扫描到检查mapper-locations路径是否匹配分页查询返回全部数据未注册PaginationInnerInterceptor配置类里添加分页拦截器白标错误页这个问题值得单说。出现Whitelabel Error Page大多是SpringBoot没有找到对应的处理逻辑要么404要么500日志里其实已经打印了完整堆栈。排查时先看控制台日志最后几行有没有Caused by那个才是真正的异常根因。4.2 Vue项目运行异常高频问题前端的问题也整理成速查表问题现象根本原因解决办法npm install卡住或报错网络源慢或依赖版本冲突切换到npmmirror源删除node_modules和lock文件重装Vite启动后页面空白组件没正确挂载或路由配置错误检查main.js中mount、router配置、控制台报错failed to load tsconfig vue/tsconfigTS模板配置文件缺失改用JS模板或手动补齐tsconfig配置接口请求404前端代理没生效或接口路径拼错检查vite proxy配置、baseURL、后端路径刷新页面就404部署环境未处理history路由Nginx添加try_files配置部署后接口不通前端访问的是静态文件域名后端代理未生效检查Nginx的location /api配置及后端端口axios响应拦截器很容易忽略一个点如果后端返回的状态码是200、但业务code不是200这时不要直接return response而是先判断code否则前端拿到的数据会出现“接口报错但业务继续执行”的怪问题。上面代码里已经把这层校验写上去了直接抄就行。另外一个实用技巧前端调试接口时打开DevTools的Network面板请求状态、响应时间、参数详情全都能看到。大部分人“明明调不通”其实都是带了不该带的参数或忘记加tokenNetwork面板里一眼就能看穿。4.3 项目文档与交付经验这类项目通常会附带部署文档和项目说明这也是整个交付环节容易被低估的部分。写部署文档的原则是按时间顺序一个命令一行说明假设看文档的人完全没接触过这套环境。我习惯的文档结构是环境要求JDK版本、Node版本、MySQL版本→ 数据库初始化建库、执行SQL脚本→ 后端打包启动mvn命令、nohup命令→ 前端打包npm install、npm run build→ Nginx配置给出完整配置文件→ 访问地址与内置账号说明。最后再加一个常见问题附录把端口占用、数据库连不上、接口404三个经典问题先写上去。文档里固定账号这点很实际。给系统内置两三个演示账号比如学生账号、教师账号、企业账号权重标注清楚。答辩演示时直接切换账号展示不同角色页面比现场注册一个企业账号再走完流程要快得多。还有个小建议写文档之前先把代码里的TODO清理一遍删掉无用的System.out.println和调试用的临时接口。别人拿到你的项目第一印象不是功能多炫而是代码干不干净。这属于职业习惯不只是学生项目要注意。最后分享一点个人体会这套系统做下来我最深的感受是前后端分离项目真正难的不是某个单一技术点而是把环境、依赖、版本、部署串成一条完整的链路。本地能跑只是第一步部署到服务器后能不能活才是关键。所以我接手这类项目时第一件事就是统一版本组合SpringBoot 2.7 JDK8 MySQL8 Vue3 Vite Nginx这一套组合目前兼容性很稳网上能查到的资料也最多。我自己更建议的做法是不要直接拿开源的代码跑完交差而是亲手把实习申请的状态流转和就业投递的统计逻辑自己实现一遍。这两个业务点覆盖了表设计、状态机、权限校验、聚合查询四个核心能力做完以后你对SpringBoot和Vue的掌握程度会有一个明显提升。过程中把每一步踩过的坑记录下来整理成自己的问题清单比背十篇框架教程都有用。如果这篇文章能帮你把项目跑通少走几步弯路那我花在折腾版本和调试上的时间就没白费。动手写代码之前先把表结构和接口文档理清楚后面你会感谢自己的。