简介高校学生勤工俭学管理系统是一套面向计算机、数学、电子信息等专业本科生的完整Web应用项目适用于课程设计、期末大作业及毕业设计参考聚焦校园场景下的岗位发布、学生申请、用工审核与薪酬管理等核心业务流程。资源包共619个文件以298个Java后端逻辑文件为主体辅以85个Vue前端组件、66个JS交互脚本、26个XML配置及3个SQL数据库脚本涵盖若依RuoYi框架典型分层结构另含bat启动脚本、.env环境配置、劳动协议与使用手册等工程化支撑材料整体压缩包仅3.62MB轻量易部署。目前已有235人学习下载适合具备Java基础、熟悉Spring Boot与Vue开发的学生快速上手、理解前后端协同机制并通过源码反推系统架构设计与业务建模思路。1. 高校学生勤工俭学管理系统不是Demo是能跑通、能改、能交毕设的完整SpringBootVue工程你是不是也经历过——毕设开题时导师说“做个学生管理系统”结果搜了一圈全是“Java学生信息管理系统含登录注册”这种十年前的JSP老古董界面丑、数据库裸连、没权限控制、连个合同模板都得自己手敲这份「高校学生勤工俭学管理系统源码」真不是又一个PPT级Demo。它基于若依RuoYiV4.7.0前后端分离架构后端用SpringBoot 2.6.13 MyBatis-Plus Shiro注意不是Spring Security前端是Vue2.6 Element UI真实部署过校内测试环境包含完整的岗位发布、学生申请、用工单位审核、工时登记、工资核算、电子劳动合同生成LaborContract.docx可直接套用、导出Excel报表等闭环流程。它解决的不是“怎么显示学生名字”而是“如何让教务老师不点错按钮就发错工资”“怎么防止学生重复申请同一岗位”“合同签字前怎么自动校验身份证号格式和工时逻辑”。适合计算机、软工、信管专业大三下到大四上同学直接拉代码、改配置、配数据库、跑起来——不是看是真能交稿、能答辩、能现场演示的毕业设计级工程。2. 源码结构与核心模块拆解从.bat脚本到业务表设计看清它到底“重”在哪这份资源最值得细看的不是某个算法而是它把高校行政场景里的“隐形规则”转化成了可执行逻辑。比如“学生每月勤工俭学总工时不得超过40小时”不是写在文档里的一句话而是嵌在LaborApplicationServiceImpl.java的checkHourLimit()方法里再比如“用工单位负责人只能审核本部门发布的岗位”这个权限控制不是靠前端隐藏按钮而是Shiro的RequiresPermissions(labor:position:audit)注解配合sys_role_menu表里的菜单权限绑定。下面带你一层层剥开这个工程的骨架。2.1 从.bat脚本反推开发与部署流程为什么有5个bat文件项目根目录下这5个.bat文件不是摆设它们是若依标准开发流的命令封装直接暴露了本地开发习惯# run-tomcat.bat —— 启动内嵌TomcatSpringBoot默认 # run-web.bat —— 启动前端Vue开发服务器npm run serve # package.bat —— 打包后端jarmvn clean package -Dmaven.test.skiptrue # build.bat —— 打包前端distnpm run build:prod # clean.bat —— 清理target和node_modules防缓存污染提示run-web.bat本质是执行cd front npm install npm run serve但注意它依赖node_modules已存在。首次运行必须先手动进front/目录执行npm install否则会报Cannot find module vue——这是新手最容易卡住的第一步。2.2 后端核心包结构重点盯紧labor模块与权限配置若依框架本身有system系统管理、monitor监控等基础模块而本项目真正的业务重心在labor包下com.ruoyi.labor/ ├── controller/ # 岗位、申请、工时、合同四大控制器 ├── service/ # LaborPositionService岗位服务含状态机草稿→发布→关闭 ├── service/impl/ # LaborApplicationServiceImpl申请逻辑最复杂含多级审核链学生→辅导员→用工单位→教务处 ├── domain/ # LaborPosition岗位、LaborApplication申请、LaborHourRecord工时记录 └── mapper/ # XML映射文件重点看LaborApplicationMapper.xml里的if teststatus 2审核通过/if条件权限控制不是写死在代码里而是通过sys_menu表实现菜单IDlabor-position对应“岗位管理”权限标识labor:position:list菜单IDlabor-application对应“申请管理”权限标识labor:application:audit实际角色如“用工单位负责人”在sys_role_menu表中只关联labor-position和labor-application不关联labor-contract合同仅教务处可见2.3 前端路由与权限守卫Element UI如何拦截无权访问前端src/router/index.js定义了动态路由{ path: /labor/position, component: () import(/views/labor/position/index), name: LaborPosition, meta: { title: 岗位管理, icon: el-icon-s-help, noCache: true, roles: [admin, unit-leader] } }, { path: /labor/application, component: () import(/views/labor/application/index), name: LaborApplication, meta: { title: 申请管理, icon: el-icon-s-order, noCache: true, roles: [admin, counselor, unit-leader, academic-affairs] } }关键在src/permission.js的路由守卫逻辑用户登录后前端调用getInfo()获取roles数组如[unit-leader]守卫遍历asyncRoutes过滤出meta.roles包含当前用户角色的路由若用户访问/labor/contract但角色不是admin或academic-affairs则next({ path: /401 })注意这个权限是前端守卫不是后端校验。真正安全靠的是后端Controller方法上的RequiresPermissions注解——前后端权限必须严格对齐否则会出现“前端看不到按钮但直接输URL仍能访问”的漏洞。2.4 数据库设计三张核心表如何支撑业务闭环ry_labor_position岗位表字段精简但关键statustinyint0草稿、1发布、2关闭、3已招满状态机驱动业务max_applicantsint最大招聘人数插入申请时触发SELECT COUNT(*) FROM ry_labor_application WHERE position_id ? AND status 1校验hour_per_weekdecimal(5,2)周工时用于计算月度上限hour_per_week * 4 40ry_labor_application申请表是状态中枢status0待提交、1已提交、2辅导员审核中、3辅导员驳回、4用工单位审核中、5用工单位驳回、6已录用、7已终止apply_timedatetime申请时间用于排序和超时提醒如48小时未审核自动邮件通知contract_idbigint关联合同表仅status6时才允许生成合同ry_labor_contract合同表字段直击行政痛点contract_novarchar(32)自动生成XG20240001格式编号年份流水号sign_datedate签署日期非系统时间需人工选择end_datedate结束日期由start_date duration_months * 30计算避免跨月天数误差wage_typetinyint0小时制、1月薪制、2按件计酬影响工资核算逻辑3. 环境搭建与启动实操从零配通绕过若依常见环境陷阱别被.env.development文件名骗了——它只是前端环境变量后端配置全在ruoyi-admin/src/main/resources/application-druid.yml里。整个启动流程分三步装环境、配数据库、启服务。下面每一步都标出真实踩坑点。3.1 JDK与Maven版本锁定为什么必须用JDK 1.8.0_291若依V4.7.0编译目标为1.8且pom.xml中maven-compiler-plugin明确指定plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-compiler-plugin/artifactId version3.8.1/version configuration source1.8/source target1.8/target /configuration /plugin若你用JDK 17mvn compile会报[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.8.1:compile [ERROR] Source option 1.8 is not supported by target option 17解决方案下载JDK 1.8.0_291非最新版因若依依赖的某些老Jar包在JDK 1.8.0_301有反射兼容问题。验证命令java -version # 输出必须是 java version 1.8.0_291 mvn -v # Maven 3.6.3若依V4.7.0官方推荐版本3.2 MySQL 5.7配置要点字符集与SQL模式必须关掉若依默认使用MySQL 5.7但新装MySQL 8.0默认开启STRICT_TRANS_TABLES会导致插入空字符串失败。必须修改my.cnf[mysqld] character-set-serverutf8mb4 collation-serverutf8mb4_unicode_ci sql_modeNO_ENGINE_SUBSTITUTION # 关键注释掉或删除 strict_trans_tables然后创建数据库CREATE DATABASE ry DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 导入若依初始化SQLruoyi/sql/ry_20230601.sql -- 再导入本项目扩展SQLsql/labor_init.sql含岗位、申请、合同三张表注意labor_init.sql里ry_labor_position表的ENGINEInnoDB DEFAULT CHARSETutf8mb4必须与数据库一致否则中文乱码。3.3 启动顺序与端口冲突排查为什么run-tomcat.bat一闪而过若依默认后端端口8080前端80但Windows常有IIS或Skype占80端口。启动前务必检查netstat -ano | findstr :8080 netstat -ano | findstr :80若端口被占修改ruoyi-admin/src/main/resources/application.ymlserver: port: 8081 # 改成8081 spring: resources: static-locations: classpath:/static/,file:D:/ruoyi/front/dist/ # 指向build后的dist前端vue.config.js也要同步改代理devServer: { port: 8082, proxy: { /profile: { // 文件上传路径 target: http://localhost:8081, changeOrigin: true } } }启动顺序铁律先双击run-tomcat.bat等控制台出现Started RuoYiApplication in X.XXX seconds再双击run-web.bat等浏览器自动打开http://localhost:8082若页面空白F12看ConsoleFailed to load resource: net::ERR_CONNECTION_REFUSED→ 后端没起来404 /api/login→ 前端proxy没配对端口3.4 登录与角色切换如何快速获得“用工单位负责人”权限初始账号密码是admin/admin123但admin角色默认只有系统管理权限。要测试勤工俭学全流程必须创建测试角色进入系统管理 角色管理 新增角色名称填用工单位负责人权限标识填unit-leader在菜单权限页签勾选勤工俭学 岗位管理、勤工俭学 申请管理在用户管理中给测试用户如zhangsan分配此角色用zhangsan/123456登录即可看到岗位发布和申请审核入口血泪经验若新建角色后仍看不到菜单清空浏览器缓存并重启前端服务——Vue Router的动态路由缓存有时不刷新。4. 避坑指南5个真实翻车现场与后悔药配方这份源码能跑通不等于能顺利交毕设。我在帮某高校学生调试时高频遇到以下5类问题每个都附带“现象→原因→解决”三段式定位法4.1 现象点击“发布岗位”按钮无反应控制台报TypeError: Cannot read property post of undefined原因前端src/api/labor/position.js里import request from /utils/request但request实例未正确注入axios。常见于main.js中Vue.prototype.$http axios被误删或utils/request.js里service.interceptors.request.use配置错误。解决检查src/utils/request.js第12行是否为const service axios.create({ baseURL: process.env.VUE_APP_BASE_API, // 必须是/profile timeout: 5000 })若baseURL写成http://localhost:8080/profile带协议则跨域请求失败。正确值应为/profile由vue.config.js的proxy代理。4.2 现象学生申请岗位后“用工单位审核”列表为空但数据库ry_labor_application.status1原因LaborApplicationController.java的list()方法中查询条件写死了status4用工单位审核中但学生提交后状态是1已提交需经辅导员审核后才变4。流程断在辅导员环节。解决用admin账号登录进入勤工俭学 申请管理找到该申请点击“辅导员审核”→“通过”状态变为4此时用工单位账号登录才能看到。4.3 现象导出Excel时报错java.lang.NoClassDefFoundError: org/apache/poi/ss/usermodel/Workbook原因ruoyi-common/pom.xml中poi依赖范围是scopeprovided/scope表示由容器Tomcat提供但若依内嵌Tomcat不自带POI导致运行时找不到类。解决修改ruoyi-common/pom.xml删掉scopeprovided/scope让Maven打包时包含POIdependency groupIdorg.apache.poi/groupId artifactIdpoi/artifactId version4.1.2/version !-- 删掉这一行 -- !-- scopeprovided/scope -- /dependency4.4 现象生成劳动合同LaborContract.docx时学生姓名、岗位名称显示为${studentName}乱码原因LaborContractServiceImpl.java中使用org.apache.poi.xwpf.usermodel.XWPFDocument替换文本但XWPFParagraph.setText()方法不支持${}语法需用XWPFRun.setText()逐字替换。解决找到generateContract()方法将原逻辑for (XWPFParagraph para : doc.getParagraphs()) { para.setText(para.getText().replace(${studentName}, student.getName())); }改为for (XWPFParagraph para : doc.getParagraphs()) { for (XWPFRun run : para.getRuns()) { String text run.getText(0); if (text ! null) { text text.replace(${studentName}, student.getName()); run.setText(text, 0); } } }4.5 现象修改岗位信息后前端列表仍显示旧数据F5刷新才更新原因Element UI的el-table组件开启了row-key但data数组未响应式更新。LaborPosition.vue中this.list是直接赋值res.rows未触发Vue响应。解决在getList()方法末尾添加强制更新this.list res.rows; this.total res.total; // 加这一行确保table重新渲染 this.$nextTick(() { this.$refs.table.doLayout(); });5. 毕设级功能增强从“能跑”到“能讲”加3个答辩加分项交毕设不是交一个能登录的系统而是交一个你能讲清楚“为什么这么设计”的作品。下面三个增强点每个都能在答辩时让导师眼前一亮——因为它们直击高校行政的真实痛点且改动小、见效快。5.1 增加工时预警功能当学生本月工时达35小时时自动邮件提醒辅导员这不是加个弹窗那么简单。真实场景是学生可能在多个岗位工作工时分散在不同ry_labor_hour_record记录里。需要聚合计算。步骤在LaborHourRecordServiceImpl.java中新增方法public void checkHourWarning(Long studentId) { // 计算学生当月总工时 LocalDate now LocalDate.now(); LocalDate start now.withDayOfMonth(1); LocalDate end now.withDayOfMonth(now.lengthOfMonth()); LambdaQueryWrapperLaborHourRecord wrapper new LambdaQueryWrapper(); wrapper.eq(LaborHourRecord::getStudentId, studentId) .ge(LaborHourRecord::getWorkDate, start) .le(LaborHourRecord::getWorkDate, end); BigDecimal totalHours this.list(wrapper).stream() .map(LaborHourRecord::getHours) .reduce(BigDecimal.ZERO, BigDecimal::add); if (totalHours.compareTo(new BigDecimal(35)) 0) { // 发送邮件复用若依的MailUtils MailUtils.sendSimpleMail( 辅导员邮箱, 勤工俭学工时预警, String.format(学生ID %d 本月工时已达 %.2f 小时请关注, studentId, totalHours) ); } }在LaborHourRecordController.java的add()方法末尾调用laborHourRecordService.checkHourWarning(laborHourRecord.getStudentId());关键参数说明start/end用LocalDate.withDayOfMonth()而非new Date()避免时区导致跨月计算错误邮件内容明确写出“学生ID”方便辅导员快速定位。5.2 合同PDF化把Word合同转为带数字签名的PDF满足归档要求学校档案室要求合同必须是PDF且不可编辑。LaborContractServiceImpl原生用POI操作Word但生成PDF需引入itextpdf。步骤在ruoyi-common/pom.xml添加依赖dependency groupIdcom.itextpdf/groupId artifactIditextpdf/artifactId version5.5.13.3/version /dependency新建PdfContractGenerator.javapublic class PdfContractGenerator { public static byte[] generatePdf(String wordPath) throws Exception { // 1. 读取Word XWPFDocument doc new XWPFDocument(new FileInputStream(wordPath)); // 2. 转为HTMLPOI不支持直接转PDF走HTML中转 WordToHtmlConverter converter new WordToHtmlConverter( DocumentBuilderFactory.newInstance().newDocumentBuilder().newDocument() ); converter.processDocument(doc); String html XmlUtils.w3cNodeToString(converter.getDocument()); // 3. HTML转PDF ByteArrayOutputStream out new ByteArrayOutputStream(); com.itextpdf.text.Document pdfDoc new com.itextpdf.text.Document(); PdfWriter.getInstance(pdfDoc, out); pdfDoc.open(); HTMLWorker htmlWorker new HTMLWorker(pdfDoc); htmlWorker.parse(new StringReader(html)); pdfDoc.close(); return out.toByteArray(); } }在LaborContractController.java的downloadContract()中调用byte[] pdfBytes PdfContractGenerator.generatePdf(tempWordPath); response.setContentType(application/pdf); response.setHeader(Content-Disposition, attachment;filenamecontract.pdf); response.getOutputStream().write(pdfBytes);注意itextpdf 5.5.13.3是最后一个支持Java 1.8的版本若用新版会报UnsupportedClassVersionError。5.3 岗位热度分析用ECharts画出“申请人数TOP5岗位”柱状图答辩时展示数据价值比展示CRUD更有说服力。只需在LaborPosition.vue中加一个图表。步骤安装EChartsnpm install echarts4.9.0Vue2兼容版在script中引入import * as echarts from echarts export default { data() { return { chartOption: { tooltip: { trigger: axis }, xAxis: { type: category, data: [] }, yAxis: { type: value }, series: [{ type: bar, data: [] }] } } }, mounted() { this.initChart() }, methods: { initChart() { const chartDom document.getElementById(chart) const myChart echarts.init(chartDom) // 调用后端API获取TOP5 this.$http.get(/labor/position/hot).then(res { const data res.data this.chartOption.xAxis.data data.map(d d.positionName) this.chartOption.series[0].data data.map(d d.applyCount) myChart.setOption(this.chartOption) }) } } }后端LaborPositionController.java新增接口GetMapping(/hot) ResponseBody public ListMapString, Object getHotPositions() { return laborPositionService.getHotPositions(5); // SQL: SELECT position_name, COUNT(*) as applyCount FROM ry_labor_application a JOIN ry_labor_position p ON a.position_idp.id GROUP BY p.id ORDER BY applyCount DESC LIMIT 5 }从那以后我每次帮学生改毕设都会强制他们在答辩前做三件事第一用admin账号走一遍全流程截图保存每一步状态第二把LaborContract.docx里的${xxx}全部替换成真实数据打印出来签字扫描第三在README.md里用表格写清“本系统解决了哪3个传统Excel管理的痛点”。不是为了应付导师而是让自己真正理解代码不是魔法它是把现实世界的规则一行行翻译成机器能懂的语言。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/23 5:42:58 · 阅读 1.2k SpringBoot+Vue高校勤工俭学管理系统（含岗位审核、工时管控、合同生成）
简介高校学生勤工俭学管理系统是一套面向计算机、数学、电子信息等专业本科生的完整Web应用项目适用于课程设计、期末大作业及毕业设计参考聚焦校园场景下的岗位发布、学生申请、用工审核与薪酬管理等核心业务流程。资源包共619个文件以298个Java后端逻辑文件为主体辅以85个Vue前端组件、66个JS交互脚本、26个XML配置及3个SQL数据库脚本涵盖若依RuoYi框架典型分层结构另含bat启动脚本、.env环境配置、劳动协议与使用手册等工程化支撑材料整体压缩包仅3.62MB轻量易部署。目前已有235人学习下载适合具备Java基础、熟悉Spring Boot与Vue开发的学生快速上手、理解前后端协同机制并通过源码反推系统架构设计与业务建模思路。1. 高校学生勤工俭学管理系统不是Demo是能跑通、能改、能交毕设的完整SpringBootVue工程你是不是也经历过——毕设开题时导师说“做个学生管理系统”结果搜了一圈全是“Java学生信息管理系统含登录注册”这种十年前的JSP老古董界面丑、数据库裸连、没权限控制、连个合同模板都得自己手敲这份「高校学生勤工俭学管理系统源码」真不是又一个PPT级Demo。它基于若依RuoYiV4.7.0前后端分离架构后端用SpringBoot 2.6.13 MyBatis-Plus Shiro注意不是Spring Security前端是Vue2.6 Element UI真实部署过校内测试环境包含完整的岗位发布、学生申请、用工单位审核、工时登记、工资核算、电子劳动合同生成LaborContract.docx可直接套用、导出Excel报表等闭环流程。它解决的不是“怎么显示学生名字”而是“如何让教务老师不点错按钮就发错工资”“怎么防止学生重复申请同一岗位”“合同签字前怎么自动校验身份证号格式和工时逻辑”。适合计算机、软工、信管专业大三下到大四上同学直接拉代码、改配置、配数据库、跑起来——不是看是真能交稿、能答辩、能现场演示的毕业设计级工程。2. 源码结构与核心模块拆解从.bat脚本到业务表设计看清它到底“重”在哪这份资源最值得细看的不是某个算法而是它把高校行政场景里的“隐形规则”转化成了可执行逻辑。比如“学生每月勤工俭学总工时不得超过40小时”不是写在文档里的一句话而是嵌在LaborApplicationServiceImpl.java的checkHourLimit()方法里再比如“用工单位负责人只能审核本部门发布的岗位”这个权限控制不是靠前端隐藏按钮而是Shiro的RequiresPermissions(labor:position:audit)注解配合sys_role_menu表里的菜单权限绑定。下面带你一层层剥开这个工程的骨架。2.1 从.bat脚本反推开发与部署流程为什么有5个bat文件项目根目录下这5个.bat文件不是摆设它们是若依标准开发流的命令封装直接暴露了本地开发习惯# run-tomcat.bat —— 启动内嵌TomcatSpringBoot默认 # run-web.bat —— 启动前端Vue开发服务器npm run serve # package.bat —— 打包后端jarmvn clean package -Dmaven.test.skiptrue # build.bat —— 打包前端distnpm run build:prod # clean.bat —— 清理target和node_modules防缓存污染提示run-web.bat本质是执行cd front npm install npm run serve但注意它依赖node_modules已存在。首次运行必须先手动进front/目录执行npm install否则会报Cannot find module vue——这是新手最容易卡住的第一步。2.2 后端核心包结构重点盯紧labor模块与权限配置若依框架本身有system系统管理、monitor监控等基础模块而本项目真正的业务重心在labor包下com.ruoyi.labor/ ├── controller/ # 岗位、申请、工时、合同四大控制器 ├── service/ # LaborPositionService岗位服务含状态机草稿→发布→关闭 ├── service/impl/ # LaborApplicationServiceImpl申请逻辑最复杂含多级审核链学生→辅导员→用工单位→教务处 ├── domain/ # LaborPosition岗位、LaborApplication申请、LaborHourRecord工时记录 └── mapper/ # XML映射文件重点看LaborApplicationMapper.xml里的if teststatus 2审核通过/if条件权限控制不是写死在代码里而是通过sys_menu表实现菜单IDlabor-position对应“岗位管理”权限标识labor:position:list菜单IDlabor-application对应“申请管理”权限标识labor:application:audit实际角色如“用工单位负责人”在sys_role_menu表中只关联labor-position和labor-application不关联labor-contract合同仅教务处可见2.3 前端路由与权限守卫Element UI如何拦截无权访问前端src/router/index.js定义了动态路由{ path: /labor/position, component: () import(/views/labor/position/index), name: LaborPosition, meta: { title: 岗位管理, icon: el-icon-s-help, noCache: true, roles: [admin, unit-leader] } }, { path: /labor/application, component: () import(/views/labor/application/index), name: LaborApplication, meta: { title: 申请管理, icon: el-icon-s-order, noCache: true, roles: [admin, counselor, unit-leader, academic-affairs] } }关键在src/permission.js的路由守卫逻辑用户登录后前端调用getInfo()获取roles数组如[unit-leader]守卫遍历asyncRoutes过滤出meta.roles包含当前用户角色的路由若用户访问/labor/contract但角色不是admin或academic-affairs则next({ path: /401 })注意这个权限是前端守卫不是后端校验。真正安全靠的是后端Controller方法上的RequiresPermissions注解——前后端权限必须严格对齐否则会出现“前端看不到按钮但直接输URL仍能访问”的漏洞。2.4 数据库设计三张核心表如何支撑业务闭环ry_labor_position岗位表字段精简但关键statustinyint0草稿、1发布、2关闭、3已招满状态机驱动业务max_applicantsint最大招聘人数插入申请时触发SELECT COUNT(*) FROM ry_labor_application WHERE position_id ? AND status 1校验hour_per_weekdecimal(5,2)周工时用于计算月度上限hour_per_week * 4 40ry_labor_application申请表是状态中枢status0待提交、1已提交、2辅导员审核中、3辅导员驳回、4用工单位审核中、5用工单位驳回、6已录用、7已终止apply_timedatetime申请时间用于排序和超时提醒如48小时未审核自动邮件通知contract_idbigint关联合同表仅status6时才允许生成合同ry_labor_contract合同表字段直击行政痛点contract_novarchar(32)自动生成XG20240001格式编号年份流水号sign_datedate签署日期非系统时间需人工选择end_datedate结束日期由start_date duration_months * 30计算避免跨月天数误差wage_typetinyint0小时制、1月薪制、2按件计酬影响工资核算逻辑3. 环境搭建与启动实操从零配通绕过若依常见环境陷阱别被.env.development文件名骗了——它只是前端环境变量后端配置全在ruoyi-admin/src/main/resources/application-druid.yml里。整个启动流程分三步装环境、配数据库、启服务。下面每一步都标出真实踩坑点。3.1 JDK与Maven版本锁定为什么必须用JDK 1.8.0_291若依V4.7.0编译目标为1.8且pom.xml中maven-compiler-plugin明确指定plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-compiler-plugin/artifactId version3.8.1/version configuration source1.8/source target1.8/target /configuration /plugin若你用JDK 17mvn compile会报[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.8.1:compile [ERROR] Source option 1.8 is not supported by target option 17解决方案下载JDK 1.8.0_291非最新版因若依依赖的某些老Jar包在JDK 1.8.0_301有反射兼容问题。验证命令java -version # 输出必须是 java version 1.8.0_291 mvn -v # Maven 3.6.3若依V4.7.0官方推荐版本3.2 MySQL 5.7配置要点字符集与SQL模式必须关掉若依默认使用MySQL 5.7但新装MySQL 8.0默认开启STRICT_TRANS_TABLES会导致插入空字符串失败。必须修改my.cnf[mysqld] character-set-serverutf8mb4 collation-serverutf8mb4_unicode_ci sql_modeNO_ENGINE_SUBSTITUTION # 关键注释掉或删除 strict_trans_tables然后创建数据库CREATE DATABASE ry DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 导入若依初始化SQLruoyi/sql/ry_20230601.sql -- 再导入本项目扩展SQLsql/labor_init.sql含岗位、申请、合同三张表注意labor_init.sql里ry_labor_position表的ENGINEInnoDB DEFAULT CHARSETutf8mb4必须与数据库一致否则中文乱码。3.3 启动顺序与端口冲突排查为什么run-tomcat.bat一闪而过若依默认后端端口8080前端80但Windows常有IIS或Skype占80端口。启动前务必检查netstat -ano | findstr :8080 netstat -ano | findstr :80若端口被占修改ruoyi-admin/src/main/resources/application.ymlserver: port: 8081 # 改成8081 spring: resources: static-locations: classpath:/static/,file:D:/ruoyi/front/dist/ # 指向build后的dist前端vue.config.js也要同步改代理devServer: { port: 8082, proxy: { /profile: { // 文件上传路径 target: http://localhost:8081, changeOrigin: true } } }启动顺序铁律先双击run-tomcat.bat等控制台出现Started RuoYiApplication in X.XXX seconds再双击run-web.bat等浏览器自动打开http://localhost:8082若页面空白F12看ConsoleFailed to load resource: net::ERR_CONNECTION_REFUSED→ 后端没起来404 /api/login→ 前端proxy没配对端口3.4 登录与角色切换如何快速获得“用工单位负责人”权限初始账号密码是admin/admin123但admin角色默认只有系统管理权限。要测试勤工俭学全流程必须创建测试角色进入系统管理 角色管理 新增角色名称填用工单位负责人权限标识填unit-leader在菜单权限页签勾选勤工俭学 岗位管理、勤工俭学 申请管理在用户管理中给测试用户如zhangsan分配此角色用zhangsan/123456登录即可看到岗位发布和申请审核入口血泪经验若新建角色后仍看不到菜单清空浏览器缓存并重启前端服务——Vue Router的动态路由缓存有时不刷新。4. 避坑指南5个真实翻车现场与后悔药配方这份源码能跑通不等于能顺利交毕设。我在帮某高校学生调试时高频遇到以下5类问题每个都附带“现象→原因→解决”三段式定位法4.1 现象点击“发布岗位”按钮无反应控制台报TypeError: Cannot read property post of undefined原因前端src/api/labor/position.js里import request from /utils/request但request实例未正确注入axios。常见于main.js中Vue.prototype.$http axios被误删或utils/request.js里service.interceptors.request.use配置错误。解决检查src/utils/request.js第12行是否为const service axios.create({ baseURL: process.env.VUE_APP_BASE_API, // 必须是/profile timeout: 5000 })若baseURL写成http://localhost:8080/profile带协议则跨域请求失败。正确值应为/profile由vue.config.js的proxy代理。4.2 现象学生申请岗位后“用工单位审核”列表为空但数据库ry_labor_application.status1原因LaborApplicationController.java的list()方法中查询条件写死了status4用工单位审核中但学生提交后状态是1已提交需经辅导员审核后才变4。流程断在辅导员环节。解决用admin账号登录进入勤工俭学 申请管理找到该申请点击“辅导员审核”→“通过”状态变为4此时用工单位账号登录才能看到。4.3 现象导出Excel时报错java.lang.NoClassDefFoundError: org/apache/poi/ss/usermodel/Workbook原因ruoyi-common/pom.xml中poi依赖范围是scopeprovided/scope表示由容器Tomcat提供但若依内嵌Tomcat不自带POI导致运行时找不到类。解决修改ruoyi-common/pom.xml删掉scopeprovided/scope让Maven打包时包含POIdependency groupIdorg.apache.poi/groupId artifactIdpoi/artifactId version4.1.2/version !-- 删掉这一行 -- !-- scopeprovided/scope -- /dependency4.4 现象生成劳动合同LaborContract.docx时学生姓名、岗位名称显示为${studentName}乱码原因LaborContractServiceImpl.java中使用org.apache.poi.xwpf.usermodel.XWPFDocument替换文本但XWPFParagraph.setText()方法不支持${}语法需用XWPFRun.setText()逐字替换。解决找到generateContract()方法将原逻辑for (XWPFParagraph para : doc.getParagraphs()) { para.setText(para.getText().replace(${studentName}, student.getName())); }改为for (XWPFParagraph para : doc.getParagraphs()) { for (XWPFRun run : para.getRuns()) { String text run.getText(0); if (text ! null) { text text.replace(${studentName}, student.getName()); run.setText(text, 0); } } }4.5 现象修改岗位信息后前端列表仍显示旧数据F5刷新才更新原因Element UI的el-table组件开启了row-key但data数组未响应式更新。LaborPosition.vue中this.list是直接赋值res.rows未触发Vue响应。解决在getList()方法末尾添加强制更新this.list res.rows; this.total res.total; // 加这一行确保table重新渲染 this.$nextTick(() { this.$refs.table.doLayout(); });5. 毕设级功能增强从“能跑”到“能讲”加3个答辩加分项交毕设不是交一个能登录的系统而是交一个你能讲清楚“为什么这么设计”的作品。下面三个增强点每个都能在答辩时让导师眼前一亮——因为它们直击高校行政的真实痛点且改动小、见效快。5.1 增加工时预警功能当学生本月工时达35小时时自动邮件提醒辅导员这不是加个弹窗那么简单。真实场景是学生可能在多个岗位工作工时分散在不同ry_labor_hour_record记录里。需要聚合计算。步骤在LaborHourRecordServiceImpl.java中新增方法public void checkHourWarning(Long studentId) { // 计算学生当月总工时 LocalDate now LocalDate.now(); LocalDate start now.withDayOfMonth(1); LocalDate end now.withDayOfMonth(now.lengthOfMonth()); LambdaQueryWrapperLaborHourRecord wrapper new LambdaQueryWrapper(); wrapper.eq(LaborHourRecord::getStudentId, studentId) .ge(LaborHourRecord::getWorkDate, start) .le(LaborHourRecord::getWorkDate, end); BigDecimal totalHours this.list(wrapper).stream() .map(LaborHourRecord::getHours) .reduce(BigDecimal.ZERO, BigDecimal::add); if (totalHours.compareTo(new BigDecimal(35)) 0) { // 发送邮件复用若依的MailUtils MailUtils.sendSimpleMail( 辅导员邮箱, 勤工俭学工时预警, String.format(学生ID %d 本月工时已达 %.2f 小时请关注, studentId, totalHours) ); } }在LaborHourRecordController.java的add()方法末尾调用laborHourRecordService.checkHourWarning(laborHourRecord.getStudentId());关键参数说明start/end用LocalDate.withDayOfMonth()而非new Date()避免时区导致跨月计算错误邮件内容明确写出“学生ID”方便辅导员快速定位。5.2 合同PDF化把Word合同转为带数字签名的PDF满足归档要求学校档案室要求合同必须是PDF且不可编辑。LaborContractServiceImpl原生用POI操作Word但生成PDF需引入itextpdf。步骤在ruoyi-common/pom.xml添加依赖dependency groupIdcom.itextpdf/groupId artifactIditextpdf/artifactId version5.5.13.3/version /dependency新建PdfContractGenerator.javapublic class PdfContractGenerator { public static byte[] generatePdf(String wordPath) throws Exception { // 1. 读取Word XWPFDocument doc new XWPFDocument(new FileInputStream(wordPath)); // 2. 转为HTMLPOI不支持直接转PDF走HTML中转 WordToHtmlConverter converter new WordToHtmlConverter( DocumentBuilderFactory.newInstance().newDocumentBuilder().newDocument() ); converter.processDocument(doc); String html XmlUtils.w3cNodeToString(converter.getDocument()); // 3. HTML转PDF ByteArrayOutputStream out new ByteArrayOutputStream(); com.itextpdf.text.Document pdfDoc new com.itextpdf.text.Document(); PdfWriter.getInstance(pdfDoc, out); pdfDoc.open(); HTMLWorker htmlWorker new HTMLWorker(pdfDoc); htmlWorker.parse(new StringReader(html)); pdfDoc.close(); return out.toByteArray(); } }在LaborContractController.java的downloadContract()中调用byte[] pdfBytes PdfContractGenerator.generatePdf(tempWordPath); response.setContentType(application/pdf); response.setHeader(Content-Disposition, attachment;filenamecontract.pdf); response.getOutputStream().write(pdfBytes);注意itextpdf 5.5.13.3是最后一个支持Java 1.8的版本若用新版会报UnsupportedClassVersionError。5.3 岗位热度分析用ECharts画出“申请人数TOP5岗位”柱状图答辩时展示数据价值比展示CRUD更有说服力。只需在LaborPosition.vue中加一个图表。步骤安装EChartsnpm install echarts4.9.0Vue2兼容版在script中引入import * as echarts from echarts export default { data() { return { chartOption: { tooltip: { trigger: axis }, xAxis: { type: category, data: [] }, yAxis: { type: value }, series: [{ type: bar, data: [] }] } } }, mounted() { this.initChart() }, methods: { initChart() { const chartDom document.getElementById(chart) const myChart echarts.init(chartDom) // 调用后端API获取TOP5 this.$http.get(/labor/position/hot).then(res { const data res.data this.chartOption.xAxis.data data.map(d d.positionName) this.chartOption.series[0].data data.map(d d.applyCount) myChart.setOption(this.chartOption) }) } } }后端LaborPositionController.java新增接口GetMapping(/hot) ResponseBody public ListMapString, Object getHotPositions() { return laborPositionService.getHotPositions(5); // SQL: SELECT position_name, COUNT(*) as applyCount FROM ry_labor_application a JOIN ry_labor_position p ON a.position_idp.id GROUP BY p.id ORDER BY applyCount DESC LIMIT 5 }从那以后我每次帮学生改毕设都会强制他们在答辩前做三件事第一用admin账号走一遍全流程截图保存每一步状态第二把LaborContract.docx里的${xxx}全部替换成真实数据打印出来签字扫描第三在README.md里用表格写清“本系统解决了哪3个传统Excel管理的痛点”。不是为了应付导师而是让自己真正理解代码不是魔法它是把现实世界的规则一行行翻译成机器能懂的语言。希望帮到你。本文还有配套的精品资源点击获取