简介这是一套基于 Spring Boot 框架的人事管理系统的毕业设计完整交付包源码、论文、答辩 PPT 一并提供适合计算机、通信、人工智能、自动化等专业学生用于课程设计、大作业或毕业设计也可作为 Java 入门到进阶的项目参考。系统覆盖人事管理常见业务模块代码经调试可运行配合论文与 PPT 能帮助理解从设计到落地的完整路径。压缩包共 300 个文件约 90.73MB其中 126 个 Java 源文件构成后端核心逻辑js/css 与 png 为前端页面和界面素材xml/properties 为配置信息sql 为数据库脚本doc/docx 与 pptx 提供论文和答辩材料另有 jar、Dockerfile 便于部署研究。目前已有 157 人学习下载。对于需要快速搭建人事管理类项目、梳理毕设写作结构或准备答辩演示的读者这套资料具有直接参考价值也可在此基础上扩展新功能。1. 毕设季最常见的翻车现场不是业务代码没写完答辩前夜还在改 bug 的同学一定懂这个场景数据库连上了接口能调通网页却白屏F12 里全是chunk-vendors.5ce9f8b8.css这样的文件加载失败。其实这类文件名已经暴露了项目的真实技术形态——Spring Boot 只负责后端前端是 Vue 打包后的静态资源两者通过 Maven 构建融合进一个 jar。这套人事管理系统的价值也正在于此它不是教科书里那种前后端写在一起的 JSP 老项目而是一个能跑通全流程的现代 Web 工程。论文、源码、答辩 PPT 齐全适合拿来当毕业设计也适合做 Spring Boot 四层架构的入门样板。下面从架构、代码到部署拆一遍这个项目真正值得抄的部分。2. 为什么这套系统选 Spring Boot 四层架构从依赖到分层逻辑人事管理系统的核心业务无非是员工信息维护、部门管理、考勤与薪资记录这类 CRUD 密集型应用对框架的要求是「上手快、约束清晰、能快速出成果」。Spring Boot 恰好在这三点上都占优自动配置省掉大量 XMLstarter 机制让依赖管理变得线性内嵌 Tomcat 让部署从「装环境」变成「跑一个 jar」。用 Maven 做构建工具的理由更直接——毕设环境里老师的电脑不一定装了 Gradle但 Maven 在 Win 和 Mac 上行为一致而且mvnw.cmd能保证没装 Maven 的机器也能构建这一步给答辩演示省了很多麻烦。2.1 项目骨架与核心依赖清单拆开这个项目目录结构是标准的 Spring Boot 单模块应用。先看pom.xml里值得抄的依赖组合parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version /parent dependencies !-- Web 层Controller 注解、内嵌 Tomcat、参数校验 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- 持久层MyBatis-Plus 比 MyBatis 少写大量 XML -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency !-- 数据库驱动 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency !-- 认证JWT 无状态登录 -- dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-api/artifactId version0.11.5/version /dependency !-- 物理删除改为逻辑删除 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies依赖选型上有两个点值得说明。第一MyBatis-Plus 而不是原生 MyBatis是因为BaseMapper已经把单表 CRUD 封装好了写一个EmployeeMapper extends BaseMapperEmployee增删改查方法直接就位论文里的「数据访问层设计」章节也能多写一段 LambdaQueryWrapper 的查询构造。第二JWT 依赖选 jjwt-api 而不是手写加密工具类是为了避免在答辩时被评委追问「你的 Token 是怎么做到防篡改的」这种问题——用成熟库意味着签名和验签逻辑有据可查。2.2 实体、Mapper、Service、Controller 每一层具体写什么四层架构的关键不是包名分层而是职责边界。以员工模块为例entity/Employee.java只做字段映射Data TableName(employee) // 对应数据库表名 public class Employee { TableId(type IdType.AUTO) private Integer id; private String empNo; // 工号业务上唯一 private String name; private String deptId; private String position; private String phone; private Integer status; // 0在职 1离职 2休假 TableLogic private Integer deleted; // 逻辑删除标记 }Service 层在这里有讲究。常见做法是让EmployeeService extends ServiceImplEmployeeMapper, Employee这样既拿到了 MyBatis-Plus 提供的save、updateById、page方法又能在addEmployee这类自定义业务里加上工号唯一性校验。Controller 层只做两件事接收参数、返回统一结果。被很多人忽略的是参数校验一定要放在 Controller 层入口做否则脏数据会直接穿透到数据库。RestController RequestMapping(/api/employee) public class EmployeeController { private final EmployeeService employeeService; PostMapping(/add) public Result add(RequestBody Valid Employee employee) { employeeService.addEmployee(employee); return Result.success(添加成功); } }这段代码的逻辑说明RequestBody把前端 JSON 反序列化为 Employee 对象Valid触发字段校验注解Service 层只处理业务。需要强调的参数是三处第一是RequestMapping(/api/employee)统一了模块前缀第二是PostMapping(/add)明确这是 POST 请求第三是Result是自定义的响应包装类里面必须包含code、message、data三个字段——论文里的「接口统一返回格式设计」小节可以直接用这个类。如果答辩时演示接口测试Postman 里能看到所有接口都是{ code: 200, message: 成功, data: {} }的结构这就是规范性的直观证据。2.3 application.yml 里那些容易被扣分的配置项配置文件的完整程度直接影响项目能不能在另一台电脑上直接跑起来。核心配置如下server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/hr_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: configuration: map-underscore-to-camel-case: true global-config: db-config: logic-delete-field: deleted配置说明serverTimezoneAsia/Shanghai是必填的否则 MySQL 8.x 驱动会报时区错误map-underscore-to-camel-case让数据库的emp_no自动映射为empNologic-delete-field声明逻辑删除字段后MyBatis-Plus 会在所有查询里自动追加deleted 0。这里要特别提醒一个坑如果直接手写 SQL 关联查询逻辑删除条件是不生效的必须自己在 XML 里写deleted 0很多人的债就是这么欠下的——答辩时老师操作离职员工查找发现列表里还能查到这种 bug 一旦暴露评审分直接受影响。3. 前端产物与 jar 包融合为什么资源文件里全是 chunk 开头的文件名项目压缩包里chunk-vendors.5ce9f8b8.css、chunk-vendors.5ce9f8b8.css、app.35a1c3ae.css这些文件初看像乱码实际是 Vue CLI 构建产物。chunk-vendors是第三方依赖Vue、Element Plus、axios 等统一打包后的文件名app是业务代码后面的哈希值5ce9f8b8是内容指纹——文件内容变了哈希就变用来解决浏览器缓存问题。这一整层前端代码开发时是独立的 Vue 工程npm run build之后才输出这些文件。3.1 前端静态资源放进 Spring Boot 的两种可行方式项目交付时没有前端源码目录只有构建产物说明作者在开发时做了前后端分离交付时把产物合进了 Spring Boot。常见做法是直接把整个dist目录复制到src/main/resources/static/下Spring Boot 会把这里的文件映射为根路径资源。另一种更工程化的方式是使用frontend-maven-plugin在 Maven 打包时自动构建前端但这个项目既然已经给出构建后的文件采用第一种即可。部署后的访问路径有个容易踩的误区。因为前端有index.html而它内部通过相对路径引用了js和css所以如果给 Controller 加一个RequestMapping(/view)来跳转页面反而会导致资源加载路径错乱。正确的做法是配置一个 WebMvc 的视图映射或者干脆什么也不配——Spring Boot 会自动把localhost:8080/映射到static/index.html。3.2 联调阶段的后端配置CORS 与接口前缀开发阶段前后端分离跑在两个端口上Vue 默认 8080后端 8080必然遇到跨域问题。项目里的后端配置了全局 CORS 策略相当于告诉浏览器「我允许前端页面跨端口访问我的接口」。实际代码是在config/CorsConfig.java里重写WebMvcConfigurer.addCorsMappings允许的路径是/**允许的请求头需要包含Authorization——因为 JWT 就放在这个头里。欠考虑的是allowCredentials(true)必须与具体的allowedOrigins配合使用如果写成*浏览器会直接拒绝携带凭证的请求。这个细节经常被人忽略等项目部署到服务器上才发现登录后所有请求都报错。如果不需要浏览器直接访问后端接口还有一个更省事的方案生产环境把前端产物放进 jar后端不再单独开端口自然不存在跨域。这个项目最终交付形态就是这样。开发阶段跨域配置继续保留因为论文里「系统测试」章节通常要展示前端开发服务器的联调截图这个配置能保证截图环境一致。4. 认证授权与员工业绩查询JWT 拦截器、管理员权限和数据权限实现人事管理系统比一般 CRUD 项目多出来的复杂度集中在「谁能访问这个接口」和「谁能看这些数据」两个问题上。如果把这个模块做扎实论文的「系统设计」部分会立刻有层次。项目采用的是 JWT 无状态认证不依赖 Session后端只负责签发 Token 和验签登录状态保存在客户端。相比 Spring Security 那套完整的过滤器链JWT 拦截器在答辩时更容易讲清楚因为每行代码都是可见的。4.1 JWT 生成与拦截器校验的实现细节先看登录接口里生成 Token 的核心代码public String generateToken(Integer userId, String username, Integer role) { return Jwts.builder() .setSubject(username) .claim(userId, userId) .claim(role, role) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() 1000 * 60 * 60 * 8)) .signWith(secretKey, SignatureAlgorithm.HS256) .compact(); }这段代码的逻辑说明setSubject放用户名claim放自定义载荷用户 ID 和角色setExpiration设置 8 小时有效期signWith用密钥做 HS256 签名。这里唯一需要保管好的是secretKey项目里通常写在配置文件的jwt.secret下。答辩时要能回答「Token 如果被盗用怎么办」——常见做法是把过期时间设短比如 2 小时同时提供刷新接口。拦截器的工作方式是继承HandlerInterceptorAdapter或者实现HandlerInterceptor在preHandle里取请求头的Authorization字段去掉 Bearer 前缀后调用Jwts.parser()验签。验签失败返回 401成功就把userId塞进request.setAttribute(userId, ...)。需要特别注意的是/api/login和/api/register这两个路径必须在注册拦截器时排除掉否则登录请求都会被拦下来造成「系统无法登入」的假象。Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(jwtInterceptor) .addPathPatterns(/api/**) .excludePathPatterns(/api/login, /api/register); }这段配置的含义是拦截所有/api/开头的接口放行登录和注册。如果项目里还有静态资源路径比如/doc.html、/swagger-ui/**也要加入白名单。这里的边界是拦截器管的是「你是谁」RequiresPermissions这类注解管的才是「你能干什么」两者叠加才是完整的权限模型。4.2 MySQL 中权限与数据的查询设计管理员怎么看到全部、员工只能看自己后台管理端有管理员与普通员工两种角色权限控制直接落到查询维度。餐厅老板通过部门过滤查看薪酬报表部门主管看本部门普通员工查自己的工资料这就是典型的数据权限问题。避免为「谁能看什么数据」写多套 Controller 的常用方案是引入 MyBatis-Plus 的InterceptorIgnore配合LambdaQueryWrapper动态拼接条件public PageEmployee queryEmployeePage(int page, int size, String deptId, Integer role, Integer currentUserId) { LambdaQueryWrapperEmployee wrapper new LambdaQueryWrapper(); wrapper.eq(StringUtils.isNotBlank(deptId), Employee::getDeptId, deptId); // 普通成员只能看到自己的数据 if (role 2) { wrapper.eq(Employee::getId, currentUserId); } return employeeService.page(new Page(page, size), wrapper); }这段代码的逻辑说明eq(StringUtils.isNotBlank(deptId), ...)这种写法第一个参数是布尔条件条件成立才拼进 SQL这样无论deptId是否为空查询都不会报错。role 2时强制追加id currentUserId把查询范围锁死在当前用户。参数表需要记清三件套page是页码从 1 开始size是每页条数wrapper是 MyBatis-Plus 的条件构造器。如果直接拼 SQL比如select * from employee where dept_id deptId 一旦deptId传的是1 OR 11整张员工表全部泄露答辩现场演示这个漏洞会产生很好的安全加分反面的例子也值得写进论文。4.3 Actuator 暴露面人事系统也有不该开门的服务Spring Boot 自带 Actuator 监控组件它默认暴露/actuator/health等端点而/actuator/env或/actuator/heapdump如果被外部访问会泄露数据库密码、JVM 内存快照等敏感信息。这个项目的 production 环境配置中把management.endpoints.web.exposure.include限定为health,info两个最小端点并给/actuator/**加了 IP 白名单从源头上减少被扫描工具列目录的风险。这个内容在答辩中可以对应「系统安全性设计」一节但建议不要在论文里展开过多以免评委顺着话题追问具体绕过方式超出范围和准备深度反而被动。5. 答辩演示前用 mvnw.cmd 打包、Windows 下部署与 PPT 讲解顺序项目带的mvnw.cmd是 Maven Wrapper 的 Windows 脚本它保证电脑上没有安装 Maven 也能拉取指定版本并用它执行构建。打开终端进入项目目录执行mvnw.cmd clean package首次运行会先下载 Maven 和依赖耐心等几分钟。输出里出现BUILD SUCCESS后target目录下会生成一个可执行 jar名字类似hr-system-0.0.1-SNAPSHOT.jar。整个打包流程不依赖 IDE这一点在答辩现场特别好用——即使用老师的电脑只要能联网就能构建。命令执行的具体步骤如下第一步mvnw.cmd -v验证 wrapper 是否正常第二步mvnw.cmd clean package -DskipTests跳过测试打包第三步看target目录。与mvn原生命令的区别在于mvnw.cmd用的是项目锁定的 Maven 版本避免出现老师电脑上 Maven 3.9 与项目依赖不兼容的怪问题。Windows 上部署这个系统只需要三步本地 MySQL 里执行sql目录下的建库脚本确认application.yml的数据库账号密码匹配然后java -jar target/hr-system-0.0.1-SNAPSHOT.jar浏览器访问localhost:8080。端口被占用时改用--server.port8081即可。答辩 PPT 的讲解顺序我建议完全反着来先放系统运行截图和演示视频让评委 30 秒内建立「它真的能跑」的认知再讲核心表和接口设计最后才提技术选型理由。因为评委最烦的是从头讲 Spring Boot 是什么那是对 PDF 复读不是答辩。高频追问里的「MyBatis-Plus 和 MyBatis 区别」「JWT 能防止 CSRF 吗」「数据量到百万级怎么优化」分别需要在 PPT 里预埋一张对比表、一行防 CSRF 说明、一条索引优化说明——employee表的emp_no字段建唯一索引这是最简单的优化证据讲清楚「为什么唯一索引能加速查询」比背十页概念管用得多。最后一个实用技巧演示时把 MySQL 命令行窗口开着随机执行一条SELECT * FROM employee向评委展示数据实时变化。这比任何架构图都有说服力。这套项目里该复用的复用、该避开的坑避开从答辩到实际部署就不会有出其不意的翻车点。本文还有配套的精品资源点击获取
基于Spring Boot+Vue的人事管理系统设计与实现（毕业设计案例）
简介这是一套基于 Spring Boot 框架的人事管理系统的毕业设计完整交付包源码、论文、答辩 PPT 一并提供适合计算机、通信、人工智能、自动化等专业学生用于课程设计、大作业或毕业设计也可作为 Java 入门到进阶的项目参考。系统覆盖人事管理常见业务模块代码经调试可运行配合论文与 PPT 能帮助理解从设计到落地的完整路径。压缩包共 300 个文件约 90.73MB其中 126 个 Java 源文件构成后端核心逻辑js/css 与 png 为前端页面和界面素材xml/properties 为配置信息sql 为数据库脚本doc/docx 与 pptx 提供论文和答辩材料另有 jar、Dockerfile 便于部署研究。目前已有 157 人学习下载。对于需要快速搭建人事管理类项目、梳理毕设写作结构或准备答辩演示的读者这套资料具有直接参考价值也可在此基础上扩展新功能。1. 毕设季最常见的翻车现场不是业务代码没写完答辩前夜还在改 bug 的同学一定懂这个场景数据库连上了接口能调通网页却白屏F12 里全是chunk-vendors.5ce9f8b8.css这样的文件加载失败。其实这类文件名已经暴露了项目的真实技术形态——Spring Boot 只负责后端前端是 Vue 打包后的静态资源两者通过 Maven 构建融合进一个 jar。这套人事管理系统的价值也正在于此它不是教科书里那种前后端写在一起的 JSP 老项目而是一个能跑通全流程的现代 Web 工程。论文、源码、答辩 PPT 齐全适合拿来当毕业设计也适合做 Spring Boot 四层架构的入门样板。下面从架构、代码到部署拆一遍这个项目真正值得抄的部分。2. 为什么这套系统选 Spring Boot 四层架构从依赖到分层逻辑人事管理系统的核心业务无非是员工信息维护、部门管理、考勤与薪资记录这类 CRUD 密集型应用对框架的要求是「上手快、约束清晰、能快速出成果」。Spring Boot 恰好在这三点上都占优自动配置省掉大量 XMLstarter 机制让依赖管理变得线性内嵌 Tomcat 让部署从「装环境」变成「跑一个 jar」。用 Maven 做构建工具的理由更直接——毕设环境里老师的电脑不一定装了 Gradle但 Maven 在 Win 和 Mac 上行为一致而且mvnw.cmd能保证没装 Maven 的机器也能构建这一步给答辩演示省了很多麻烦。2.1 项目骨架与核心依赖清单拆开这个项目目录结构是标准的 Spring Boot 单模块应用。先看pom.xml里值得抄的依赖组合parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version /parent dependencies !-- Web 层Controller 注解、内嵌 Tomcat、参数校验 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- 持久层MyBatis-Plus 比 MyBatis 少写大量 XML -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency !-- 数据库驱动 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency !-- 认证JWT 无状态登录 -- dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-api/artifactId version0.11.5/version /dependency !-- 物理删除改为逻辑删除 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies依赖选型上有两个点值得说明。第一MyBatis-Plus 而不是原生 MyBatis是因为BaseMapper已经把单表 CRUD 封装好了写一个EmployeeMapper extends BaseMapperEmployee增删改查方法直接就位论文里的「数据访问层设计」章节也能多写一段 LambdaQueryWrapper 的查询构造。第二JWT 依赖选 jjwt-api 而不是手写加密工具类是为了避免在答辩时被评委追问「你的 Token 是怎么做到防篡改的」这种问题——用成熟库意味着签名和验签逻辑有据可查。2.2 实体、Mapper、Service、Controller 每一层具体写什么四层架构的关键不是包名分层而是职责边界。以员工模块为例entity/Employee.java只做字段映射Data TableName(employee) // 对应数据库表名 public class Employee { TableId(type IdType.AUTO) private Integer id; private String empNo; // 工号业务上唯一 private String name; private String deptId; private String position; private String phone; private Integer status; // 0在职 1离职 2休假 TableLogic private Integer deleted; // 逻辑删除标记 }Service 层在这里有讲究。常见做法是让EmployeeService extends ServiceImplEmployeeMapper, Employee这样既拿到了 MyBatis-Plus 提供的save、updateById、page方法又能在addEmployee这类自定义业务里加上工号唯一性校验。Controller 层只做两件事接收参数、返回统一结果。被很多人忽略的是参数校验一定要放在 Controller 层入口做否则脏数据会直接穿透到数据库。RestController RequestMapping(/api/employee) public class EmployeeController { private final EmployeeService employeeService; PostMapping(/add) public Result add(RequestBody Valid Employee employee) { employeeService.addEmployee(employee); return Result.success(添加成功); } }这段代码的逻辑说明RequestBody把前端 JSON 反序列化为 Employee 对象Valid触发字段校验注解Service 层只处理业务。需要强调的参数是三处第一是RequestMapping(/api/employee)统一了模块前缀第二是PostMapping(/add)明确这是 POST 请求第三是Result是自定义的响应包装类里面必须包含code、message、data三个字段——论文里的「接口统一返回格式设计」小节可以直接用这个类。如果答辩时演示接口测试Postman 里能看到所有接口都是{ code: 200, message: 成功, data: {} }的结构这就是规范性的直观证据。2.3 application.yml 里那些容易被扣分的配置项配置文件的完整程度直接影响项目能不能在另一台电脑上直接跑起来。核心配置如下server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/hr_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: configuration: map-underscore-to-camel-case: true global-config: db-config: logic-delete-field: deleted配置说明serverTimezoneAsia/Shanghai是必填的否则 MySQL 8.x 驱动会报时区错误map-underscore-to-camel-case让数据库的emp_no自动映射为empNologic-delete-field声明逻辑删除字段后MyBatis-Plus 会在所有查询里自动追加deleted 0。这里要特别提醒一个坑如果直接手写 SQL 关联查询逻辑删除条件是不生效的必须自己在 XML 里写deleted 0很多人的债就是这么欠下的——答辩时老师操作离职员工查找发现列表里还能查到这种 bug 一旦暴露评审分直接受影响。3. 前端产物与 jar 包融合为什么资源文件里全是 chunk 开头的文件名项目压缩包里chunk-vendors.5ce9f8b8.css、chunk-vendors.5ce9f8b8.css、app.35a1c3ae.css这些文件初看像乱码实际是 Vue CLI 构建产物。chunk-vendors是第三方依赖Vue、Element Plus、axios 等统一打包后的文件名app是业务代码后面的哈希值5ce9f8b8是内容指纹——文件内容变了哈希就变用来解决浏览器缓存问题。这一整层前端代码开发时是独立的 Vue 工程npm run build之后才输出这些文件。3.1 前端静态资源放进 Spring Boot 的两种可行方式项目交付时没有前端源码目录只有构建产物说明作者在开发时做了前后端分离交付时把产物合进了 Spring Boot。常见做法是直接把整个dist目录复制到src/main/resources/static/下Spring Boot 会把这里的文件映射为根路径资源。另一种更工程化的方式是使用frontend-maven-plugin在 Maven 打包时自动构建前端但这个项目既然已经给出构建后的文件采用第一种即可。部署后的访问路径有个容易踩的误区。因为前端有index.html而它内部通过相对路径引用了js和css所以如果给 Controller 加一个RequestMapping(/view)来跳转页面反而会导致资源加载路径错乱。正确的做法是配置一个 WebMvc 的视图映射或者干脆什么也不配——Spring Boot 会自动把localhost:8080/映射到static/index.html。3.2 联调阶段的后端配置CORS 与接口前缀开发阶段前后端分离跑在两个端口上Vue 默认 8080后端 8080必然遇到跨域问题。项目里的后端配置了全局 CORS 策略相当于告诉浏览器「我允许前端页面跨端口访问我的接口」。实际代码是在config/CorsConfig.java里重写WebMvcConfigurer.addCorsMappings允许的路径是/**允许的请求头需要包含Authorization——因为 JWT 就放在这个头里。欠考虑的是allowCredentials(true)必须与具体的allowedOrigins配合使用如果写成*浏览器会直接拒绝携带凭证的请求。这个细节经常被人忽略等项目部署到服务器上才发现登录后所有请求都报错。如果不需要浏览器直接访问后端接口还有一个更省事的方案生产环境把前端产物放进 jar后端不再单独开端口自然不存在跨域。这个项目最终交付形态就是这样。开发阶段跨域配置继续保留因为论文里「系统测试」章节通常要展示前端开发服务器的联调截图这个配置能保证截图环境一致。4. 认证授权与员工业绩查询JWT 拦截器、管理员权限和数据权限实现人事管理系统比一般 CRUD 项目多出来的复杂度集中在「谁能访问这个接口」和「谁能看这些数据」两个问题上。如果把这个模块做扎实论文的「系统设计」部分会立刻有层次。项目采用的是 JWT 无状态认证不依赖 Session后端只负责签发 Token 和验签登录状态保存在客户端。相比 Spring Security 那套完整的过滤器链JWT 拦截器在答辩时更容易讲清楚因为每行代码都是可见的。4.1 JWT 生成与拦截器校验的实现细节先看登录接口里生成 Token 的核心代码public String generateToken(Integer userId, String username, Integer role) { return Jwts.builder() .setSubject(username) .claim(userId, userId) .claim(role, role) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() 1000 * 60 * 60 * 8)) .signWith(secretKey, SignatureAlgorithm.HS256) .compact(); }这段代码的逻辑说明setSubject放用户名claim放自定义载荷用户 ID 和角色setExpiration设置 8 小时有效期signWith用密钥做 HS256 签名。这里唯一需要保管好的是secretKey项目里通常写在配置文件的jwt.secret下。答辩时要能回答「Token 如果被盗用怎么办」——常见做法是把过期时间设短比如 2 小时同时提供刷新接口。拦截器的工作方式是继承HandlerInterceptorAdapter或者实现HandlerInterceptor在preHandle里取请求头的Authorization字段去掉 Bearer 前缀后调用Jwts.parser()验签。验签失败返回 401成功就把userId塞进request.setAttribute(userId, ...)。需要特别注意的是/api/login和/api/register这两个路径必须在注册拦截器时排除掉否则登录请求都会被拦下来造成「系统无法登入」的假象。Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(jwtInterceptor) .addPathPatterns(/api/**) .excludePathPatterns(/api/login, /api/register); }这段配置的含义是拦截所有/api/开头的接口放行登录和注册。如果项目里还有静态资源路径比如/doc.html、/swagger-ui/**也要加入白名单。这里的边界是拦截器管的是「你是谁」RequiresPermissions这类注解管的才是「你能干什么」两者叠加才是完整的权限模型。4.2 MySQL 中权限与数据的查询设计管理员怎么看到全部、员工只能看自己后台管理端有管理员与普通员工两种角色权限控制直接落到查询维度。餐厅老板通过部门过滤查看薪酬报表部门主管看本部门普通员工查自己的工资料这就是典型的数据权限问题。避免为「谁能看什么数据」写多套 Controller 的常用方案是引入 MyBatis-Plus 的InterceptorIgnore配合LambdaQueryWrapper动态拼接条件public PageEmployee queryEmployeePage(int page, int size, String deptId, Integer role, Integer currentUserId) { LambdaQueryWrapperEmployee wrapper new LambdaQueryWrapper(); wrapper.eq(StringUtils.isNotBlank(deptId), Employee::getDeptId, deptId); // 普通成员只能看到自己的数据 if (role 2) { wrapper.eq(Employee::getId, currentUserId); } return employeeService.page(new Page(page, size), wrapper); }这段代码的逻辑说明eq(StringUtils.isNotBlank(deptId), ...)这种写法第一个参数是布尔条件条件成立才拼进 SQL这样无论deptId是否为空查询都不会报错。role 2时强制追加id currentUserId把查询范围锁死在当前用户。参数表需要记清三件套page是页码从 1 开始size是每页条数wrapper是 MyBatis-Plus 的条件构造器。如果直接拼 SQL比如select * from employee where dept_id deptId 一旦deptId传的是1 OR 11整张员工表全部泄露答辩现场演示这个漏洞会产生很好的安全加分反面的例子也值得写进论文。4.3 Actuator 暴露面人事系统也有不该开门的服务Spring Boot 自带 Actuator 监控组件它默认暴露/actuator/health等端点而/actuator/env或/actuator/heapdump如果被外部访问会泄露数据库密码、JVM 内存快照等敏感信息。这个项目的 production 环境配置中把management.endpoints.web.exposure.include限定为health,info两个最小端点并给/actuator/**加了 IP 白名单从源头上减少被扫描工具列目录的风险。这个内容在答辩中可以对应「系统安全性设计」一节但建议不要在论文里展开过多以免评委顺着话题追问具体绕过方式超出范围和准备深度反而被动。5. 答辩演示前用 mvnw.cmd 打包、Windows 下部署与 PPT 讲解顺序项目带的mvnw.cmd是 Maven Wrapper 的 Windows 脚本它保证电脑上没有安装 Maven 也能拉取指定版本并用它执行构建。打开终端进入项目目录执行mvnw.cmd clean package首次运行会先下载 Maven 和依赖耐心等几分钟。输出里出现BUILD SUCCESS后target目录下会生成一个可执行 jar名字类似hr-system-0.0.1-SNAPSHOT.jar。整个打包流程不依赖 IDE这一点在答辩现场特别好用——即使用老师的电脑只要能联网就能构建。命令执行的具体步骤如下第一步mvnw.cmd -v验证 wrapper 是否正常第二步mvnw.cmd clean package -DskipTests跳过测试打包第三步看target目录。与mvn原生命令的区别在于mvnw.cmd用的是项目锁定的 Maven 版本避免出现老师电脑上 Maven 3.9 与项目依赖不兼容的怪问题。Windows 上部署这个系统只需要三步本地 MySQL 里执行sql目录下的建库脚本确认application.yml的数据库账号密码匹配然后java -jar target/hr-system-0.0.1-SNAPSHOT.jar浏览器访问localhost:8080。端口被占用时改用--server.port8081即可。答辩 PPT 的讲解顺序我建议完全反着来先放系统运行截图和演示视频让评委 30 秒内建立「它真的能跑」的认知再讲核心表和接口设计最后才提技术选型理由。因为评委最烦的是从头讲 Spring Boot 是什么那是对 PDF 复读不是答辩。高频追问里的「MyBatis-Plus 和 MyBatis 区别」「JWT 能防止 CSRF 吗」「数据量到百万级怎么优化」分别需要在 PPT 里预埋一张对比表、一行防 CSRF 说明、一条索引优化说明——employee表的emp_no字段建唯一索引这是最简单的优化证据讲清楚「为什么唯一索引能加速查询」比背十页概念管用得多。最后一个实用技巧演示时把 MySQL 命令行窗口开着随机执行一条SELECT * FROM employee向评委展示数据实时变化。这比任何架构图都有说服力。这套项目里该复用的复用、该避开的坑避开从答辩到实际部署就不会有出其不意的翻车点。本文还有配套的精品资源点击获取
