尧图网页设计 
简介这是一套基于SpringBoot的办公用品管理系统完整源码面向计算机专业毕业设计、课程设计学生及Java初学者帮助解决办公用品入库、领用、库存跟踪与报损等管理场景的开发需求。压缩包共508个文件约13.15MB以123个Java后端源码、52个Vue前端组件、34个JS脚本及159个SVG图标资源为主另含SQL建表脚本、XML配置、CSS样式与说明文档前后端与数据库设计一应俱全。项目采用JDK1.8、SpringBoot框架与MySQL 5.7/8数据库兼容Eclipse和IDEA两种开发环境并附Navicat操作指导界面友好、易于上手。目前已有116人学习下载。读者可获得完整可运行的工程代码、数据库脚本与说明文档便于快速理解系统运行机制、进行二次开发与维护也能作为毕业设计或课程设计的参考模板降低学习与部署门槛。1. 拿到一份 SpringBoot 办公用品管理系统源码先别急着双击运行你从某个渠道拿到一个压缩包名字叫「基于springboot的办公用品管理系统源代码完整前后端mysql说明文档.zip」。解压之后里面大概率躺着两个文件夹一个后端 SpringBoot 工程一个前端 Vue 或 Thymeleaf 页面外加一份 SQL 文件和一份 Word 说明文档。很多人第一反应是找 main 方法直接跑结果启动报错、数据库连不上、前端 404折腾一下午连登录页都进不去。这个标题背后真正要解决的问题不是「怎么把项目跑起来」这么简单而是「怎么在最短时间内判断这套源码值不值得用、能不能改成自己的东西」。办公用品管理系统本身是一个典型的进销存轻量场景部门申领、库存扣减、审批流转、低库存预警。它麻雀虽小但把 SpringBoot 的 Controller-Service-Mapper 分层、MySQL 表设计、前后端联调、权限拦截这些环节全串了一遍。适合两类人一是想拿一个完整项目练手的学生或转行者二是公司内部想快速搭一套领用登记工具的后端开发。接下来我按实际拆包顺序把每一步该看什么、改什么、防什么坑讲清楚。2. 拆包先看三样东西pom.xml、SQL 表结构、前端请求基地址拿到源码别急着导入 IDE先做一次「静态体检」。这一步能帮你省掉后面 80% 的玄学报错。我一般会同时打开三个窗口后端的 pom.xml、数据库 SQL 文件、前端封装 axios 的那个 request.js 或 main.js。三者的版本和地址对不上后面必翻车。2.1 从 pom.xml 判断 SpringBoot 版本与依赖完整度打开后端根目录的 pom.xml重点看parent里的 spring-boot-starter-parent 版本号以及dependencies里有没有这几样spring-boot-starter-web、mybatis-plus 或 mybatis-spring-boot-starter、mysql-connector-java、lombok、以及一个 JWT 或 shiro/spring-security 相关的权限包。办公用品管理系统通常带登录和角色区分所以权限依赖基本跑不掉。!-- 典型依赖片段版本号以你实际包内为准 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.x/version !-- 若为 3.x注意 JDK 必须 17 -- /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.x/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency /dependencies逻辑说明SpringBoot 2.x 配 JDK 8/113.x 强制 JDK 17这是第一个分水岭。如果 pom 里是 3.x 而你本地 JDK 是 8IDEA 会直接标红不用怀疑代码问题。参数上mysql-connector-java 的版本要和你的 MySQL 服务端匹配MySQL 8 用 8.0.x 驱动MySQL 5.7 用 5.1.x 也能跑但建议升到 8.0.x。缺少 lombok 会导致实体类 get/set 全报错这不是代码坏了是插件没装。2.2 用 SQL 文件反推业务表与初始账号找到 .sql 文件不要直接全选执行。先扫一遍 CREATE TABLE 语句办公用品管理系统常见表不超过 10 张用户表、角色表、部门表、办公用品分类表、用品信息表、库存表、申领记录表、审批记录表。重点看两张表用户表里有没有预置 admin 账号申领记录表有没有外键关联。-- 建库时字符集必须显式指定否则中文用品名会变问号 CREATE DATABASE office_supplies DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 用户表典型结构 CREATE TABLE sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL, password VARCHAR(100) NOT NULL, -- 常见为 MD5 或 BCrypt dept_id BIGINT, role_id BIGINT );逻辑说明utf8mb4 是必须的办公用品名里出现「文件夹」「签字笔」没问题但一旦有特殊符号或 emoji 备注utf8 三字节就存不下。参数上password 字段长度 100 说明大概率用了 BCrypt长度 32 则是 MD5。如果你不知道初始密码看说明文档或者直接在 SQL 里找 INSERT INTO sys_user 那几行密码字段通常是加密后的串对应明文一般是 123456 或 admin。2.3 前端请求基地址与跨域配置的对应关系前端如果是 Vue 项目打开 src/utils/request.js 或 src/api 下的封装文件找 baseURL。常见写法是baseURL: http://localhost:8080或/api。如果是/api说明用了代理去看 vue.config.js 里的 proxy 配置。后端则要看 application.yml 里的server.servlet.context-path和任何 CORS 配置类。// 前端 request.js 典型片段 const service axios.create({ baseURL: process.env.VUE_APP_BASE_API || http://localhost:8080, timeout: 10000 })逻辑说明前端 baseURL 写死 8080后端 context-path 却是 /office那所有请求都会 404。参数上timeout 10000 是 10 秒办公用品系统的库存查询和导出可能超过这个时间如果导出 Excel 报超时先改这里。跨域问题在前后端分离项目里几乎必现后端要么加 CrossOrigin要么写一个 WebMvcConfigurer 的 addCorsMappings两者取其一即可重复配置反而会报「allowedOrigins cannot contain *」。3. 本地跑通的最小闭环MySQL 建库、改配置、双端启动静态检查没问题后进入实际启动环节。这一章的目标是让你看到登录页并能用 admin 登进去。顺序不能乱先数据库再后端最后前端。反过来做前端起来了后端没起页面一直转圈你会误判是前端 bug。3.1 MySQL 8 建库导入与连接串四个必改参数MySQL 安装配置教程网上很多这里只说和本项目相关的。用 Navicat 或命令行都行先建库再执行 SQL 文件。注意 SQL 文件开头如果有CREATE DATABASE和USE直接整体运行即可如果没有先手动建库再选中执行。# 命令行导入示例 mysql -u root -p -e CREATE DATABASE office_supplies DEFAULT CHARACTER SET utf8mb4; mysql -u root -p office_supplies office_supplies.sql然后改后端 application.yml 或 application-dev.yml 里的数据源spring: datasource: url: jdbc:mysql://localhost:3306/office_supplies?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver逻辑说明四个必改参数是 url 里的库名、username、password、以及 serverTimezone。MySQL 8 不写 serverTimezone 会报「The server time zone value is unrecognized」。useSSLfalse 是本地开发常用避免 mysql ssl 连接错误。driver-class-name 在 MySQL 8 下必须是 com.mysql.cj.jdbc.Driver写成 com.mysql.jdbc.Driver 会警告但通常还能跑建议改对。3.2 后端启动类扫描路径与端口冲突排查导入 IDEA 后等 Maven 依赖下载完。找到启动类通常是 XxxApplication.java上面有 SpringBootApplication 和 MapperScan。确认 MapperScan 的包路径和你的 mapper 接口实际路径一致不一致会导致注入失败。SpringBootApplication MapperScan(com.example.office.mapper) // 包名以实际为准 public class OfficeApplication { public static void main(String[] args) { SpringApplication.run(OfficeApplication.class, args); } }逻辑说明启动时如果报「Port 8080 was already in use」要么改server.port要么杀掉占用进程。Windows 用netstat -ano | findstr 8080找 PIDMac/Linux 用lsof -i:8080。另一个高频错误是「Consider defining a bean of type xxxMapper」九成是 MapperScan 路径写错或 mapper 接口没加 Mapper 注解。参数上如果项目用了 Druid 连接池还要看 druid 的 initialSize 和 maxActive本地开发 initialSize 设 1 就够设大了启动慢。3.3 前端 npm 安装与代理指向后端真实端口前端目录下先看有没有 package.json有就是标准 Node 项目。执行npm install或cnpm install然后npm run dev或npm run serve。如果启动报 node-sass 相关错误说明 Node 版本太高换到 14 或 16 再试。# 前端启动 npm install npm run serve如果前端请求走代理检查 vue.config.jsmodule.exports { devServer: { proxy: { /api: { target: http://localhost:8080, // 后端真实地址 changeOrigin: true, pathRewrite: { ^/api: } } } } }逻辑说明pathRewrite 的作用是去掉请求前缀。如果后端接口本身不带 /api而前端 baseURL 是 /api就必须重写否则 404。参数上changeOrigin 设为 true 是为了让后端看到的 Host 是目标地址某些鉴权逻辑会校验 Host。前端启动后浏览器打开控制台看 Network 里登录请求的完整 URL和后端 Controller 的 RequestMapping 拼起来能不能对上对不上就改代理或改 baseURL二选一。4. 源码改造前必须搞懂的三层结构与权限拦截能跑起来只是第一步。你大概率要改它——加个字段、换个审批流、接公司统一登录。改之前如果不清楚它的分层和权限拦截在哪很容易改出「登录能进但接口 401」这种前后端互相甩锅的问题。4.1 Controller-Service-Mapper 的职责边界与常见越界写法标准 SpringBoot 分层是 Controller 收参、Service 写业务、Mapper 碰数据库。但很多源码为了省事Controller 里直接调 Mapper或者 Service 里塞了一堆 HttpServletRequest 解析。你要改功能先定位改哪层。// 规范写法示例 RestController RequestMapping(/supply) public class SupplyController { Autowired private SupplyService supplyService; GetMapping(/list) public Result list(RequestParam(defaultValue 1) Integer page) { return Result.success(supplyService.pageList(page)); } }逻辑说明Controller 只做参数接收和结果包装业务逻辑在 Service。如果你要加「低库存自动提醒」应该写在 Service 的库存扣减方法里而不是 Controller。参数上分页参数 page 和 size 建议统一默认值很多源码只写 page 不写 size前端传多少就查多少容易一次拉全表。Result 是统一返回体改的时候注意别破坏 code/msg/data 三段结构前端拦截器依赖它判断成功失败。4.2 登录态与角色鉴权拦截器、过滤器还是 Spring Security办公用品管理系统常见三种鉴权实现一是自定义拦截器 HandlerInterceptor 校验 token二是 Filter 里解析 JWT三是直接上 Spring Security。看源码里有没有 WebMvcConfigurer 的 addInterceptors或者一个继承 OncePerRequestFilter 的类。// 自定义拦截器典型写法 public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { String token request.getHeader(Authorization); if (token null || !jwtUtil.verify(token)) { response.setStatus(401); return false; } return true; } }逻辑说明拦截器放行路径通常在 addInterceptors 里用 excludePathPatterns 配置登录接口和静态资源必须放行。参数上token 一般放 Header 的 Authorization 字段前缀 Bearer 可有可无看前端怎么传。如果你改了登录逻辑但没同步改拦截器的校验规则就会出现「登录成功但后续接口全 401」。排查时先看拦截器有没有放行登录路径再看 token 解析是否抛异常。4.3 前后端联调时判断 bug 归属的快速方法前后端分离项目实战里最耗时的不是写代码是判断问题出在哪一端。我的习惯是浏览器 F12 打开 Network看请求有没有发出去、状态码是多少、响应体是什么。请求没发出去前端问题状态码 404路径对不上401鉴权问题500后端异常去看后端控制台堆栈。现象大概率归属第一步排查请求 pending 后失败前端或网络看 baseURL 和代理404路径不匹配对比 Controller 映射401鉴权看 token 是否携带500后端看控制台异常栈返回数据但页面不渲染前端看字段名是否一致逻辑说明这张表能覆盖八成联调问题。参数上字段名不一致是隐形杀手后端返回userName前端取username页面就是空白Network 里数据明明有。遇到这种情况直接对比返回 JSON 的 key 和前端模板里绑定的变量名。5. 避坑与排查源码跑不起来时先看这五条这一章是我自己踩过的坑按「现象 → 原因 → 解决」写。你按顺序排查基本能覆盖 90% 的启动失败。5.1 现象启动报 Access denied for user rootlocalhost原因application.yml 里的密码和本地 MySQL 实际密码不一致或者 MySQL 8 的 root 用户默认插件是 caching_sha2_password旧驱动不认。解决先确认密码命令行mysql -u root -p能登进去说明密码对。如果密码对但 Java 连不上把 MySQL 用户插件改成 mysql_native_passwordALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码;然后刷新权限。5.2 现象前端页面能开但所有接口 404原因代理没生效或 baseURL 写错请求发到了前端自己的端口。解决F12 看请求 URL如果是http://localhost:8081/api/xxx而不是http://localhost:8080/xxx说明代理没起作用。检查 vue.config.js 是否被正确加载改完必须重启前端 dev server热更新不会重载代理配置。5.3 现象登录成功但跳转后立刻退回登录页原因token 存了但请求没带上或者拦截器校验的 Header 名和前端设置的不一致。解决看前端请求拦截器有没有config.headers[Authorization] token再看后端拦截器取的是不是同一个 key。常见错位是前端存 localStorage 的 key 叫 token后端取 Header 叫 token但前端发送时忘了拼 Bearer 前缀后端解析时按带前缀处理。5.4 现象中文用品名存入数据库变成问号原因数据库、表、连接串三处字符集不统一。解决库和表用 utf8mb4连接串加characterEncodingutf8MySQL 服务端 my.cnf 里 character-set-serverutf8mb4。三处缺一处都可能乱码。已经乱码的数据改不回来只能重新录入。5.5 现象Maven 依赖下载极慢或失败原因默认中央仓库网络问题。解决在 settings.xml 里配国内镜像。改完在 IDEA 里刷新 Maven 项目。如果某个依赖死活下不来去本地仓库目录删掉对应文件夹再刷新缓存损坏比网络问题更常见。6. 把这套源码改成自己项目的一个实用技巧先动 SQL 再动 Java很多人改源码的顺序是反的先改 Java 实体类再改 Mapper XML最后才想起数据库字段没加结果启动就报列不存在。我的习惯是反着来——先在数据库里把字段加好再改实体类最后改 XML 和前端。这样每一步都有据可依不会出现「代码改了但数据库不认」的黑匣子状态。具体操作假设你要给办公用品表加一个「品牌」字段。第一步执行ALTER TABLE office_supply ADD COLUMN brand VARCHAR(50) DEFAULT NULL COMMENT 品牌;。第二步在实体类 Supply.java 里加private String brand;lombok 会自动生成 get/set。第三步如果用了 MyBatis-Plus单表查询会自动映射不用改 XML如果手写 XML在 resultMap 和 insert/update 语句里补上 brand。第四步前端表单加输入框列表加一列。四步走完重启后端刷新前端功能就通了。这个顺序的好处是数据库是唯一真相源代码围着它转而不是反过来。我见过太多人先改代码再补 SQL结果字段类型对不上、默认值冲突排查半天。另外改之前先备份 SQL 文件改错了能回滚这就是后悔药。验证方法也简单改完后用 Postman 或浏览器直接调新增接口传 brand 值再去数据库SELECT brand FROM office_supply ORDER BY id DESC LIMIT 1;看存进去没有。存进去了前端再联调没存进去看后端日志的 SQL 语句把参数拼进去手动执行一遍问题立刻现形。最后说一个习惯每次改完一个功能把对应的 SQL 变更单独记在一个 changelog.sql 文件里别散落在聊天记录或脑子里。下次部署到测试环境直接按顺序执行不用猜哪些字段加过哪些没加。这套源码本身不难难的是改着改着就乱了有个变更记录能救命。希望帮到你。本文还有配套的精品资源点击获取 SpringBoot办公用品管理系统源码解析与二次开发实战指南
简介这是一套基于SpringBoot的办公用品管理系统完整源码面向计算机专业毕业设计、课程设计学生及Java初学者帮助解决办公用品入库、领用、库存跟踪与报损等管理场景的开发需求。压缩包共508个文件约13.15MB以123个Java后端源码、52个Vue前端组件、34个JS脚本及159个SVG图标资源为主另含SQL建表脚本、XML配置、CSS样式与说明文档前后端与数据库设计一应俱全。项目采用JDK1.8、SpringBoot框架与MySQL 5.7/8数据库兼容Eclipse和IDEA两种开发环境并附Navicat操作指导界面友好、易于上手。目前已有116人学习下载。读者可获得完整可运行的工程代码、数据库脚本与说明文档便于快速理解系统运行机制、进行二次开发与维护也能作为毕业设计或课程设计的参考模板降低学习与部署门槛。1. 拿到一份 SpringBoot 办公用品管理系统源码先别急着双击运行你从某个渠道拿到一个压缩包名字叫「基于springboot的办公用品管理系统源代码完整前后端mysql说明文档.zip」。解压之后里面大概率躺着两个文件夹一个后端 SpringBoot 工程一个前端 Vue 或 Thymeleaf 页面外加一份 SQL 文件和一份 Word 说明文档。很多人第一反应是找 main 方法直接跑结果启动报错、数据库连不上、前端 404折腾一下午连登录页都进不去。这个标题背后真正要解决的问题不是「怎么把项目跑起来」这么简单而是「怎么在最短时间内判断这套源码值不值得用、能不能改成自己的东西」。办公用品管理系统本身是一个典型的进销存轻量场景部门申领、库存扣减、审批流转、低库存预警。它麻雀虽小但把 SpringBoot 的 Controller-Service-Mapper 分层、MySQL 表设计、前后端联调、权限拦截这些环节全串了一遍。适合两类人一是想拿一个完整项目练手的学生或转行者二是公司内部想快速搭一套领用登记工具的后端开发。接下来我按实际拆包顺序把每一步该看什么、改什么、防什么坑讲清楚。2. 拆包先看三样东西pom.xml、SQL 表结构、前端请求基地址拿到源码别急着导入 IDE先做一次「静态体检」。这一步能帮你省掉后面 80% 的玄学报错。我一般会同时打开三个窗口后端的 pom.xml、数据库 SQL 文件、前端封装 axios 的那个 request.js 或 main.js。三者的版本和地址对不上后面必翻车。2.1 从 pom.xml 判断 SpringBoot 版本与依赖完整度打开后端根目录的 pom.xml重点看parent里的 spring-boot-starter-parent 版本号以及dependencies里有没有这几样spring-boot-starter-web、mybatis-plus 或 mybatis-spring-boot-starter、mysql-connector-java、lombok、以及一个 JWT 或 shiro/spring-security 相关的权限包。办公用品管理系统通常带登录和角色区分所以权限依赖基本跑不掉。!-- 典型依赖片段版本号以你实际包内为准 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.x/version !-- 若为 3.x注意 JDK 必须 17 -- /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.x/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency /dependencies逻辑说明SpringBoot 2.x 配 JDK 8/113.x 强制 JDK 17这是第一个分水岭。如果 pom 里是 3.x 而你本地 JDK 是 8IDEA 会直接标红不用怀疑代码问题。参数上mysql-connector-java 的版本要和你的 MySQL 服务端匹配MySQL 8 用 8.0.x 驱动MySQL 5.7 用 5.1.x 也能跑但建议升到 8.0.x。缺少 lombok 会导致实体类 get/set 全报错这不是代码坏了是插件没装。2.2 用 SQL 文件反推业务表与初始账号找到 .sql 文件不要直接全选执行。先扫一遍 CREATE TABLE 语句办公用品管理系统常见表不超过 10 张用户表、角色表、部门表、办公用品分类表、用品信息表、库存表、申领记录表、审批记录表。重点看两张表用户表里有没有预置 admin 账号申领记录表有没有外键关联。-- 建库时字符集必须显式指定否则中文用品名会变问号 CREATE DATABASE office_supplies DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 用户表典型结构 CREATE TABLE sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL, password VARCHAR(100) NOT NULL, -- 常见为 MD5 或 BCrypt dept_id BIGINT, role_id BIGINT );逻辑说明utf8mb4 是必须的办公用品名里出现「文件夹」「签字笔」没问题但一旦有特殊符号或 emoji 备注utf8 三字节就存不下。参数上password 字段长度 100 说明大概率用了 BCrypt长度 32 则是 MD5。如果你不知道初始密码看说明文档或者直接在 SQL 里找 INSERT INTO sys_user 那几行密码字段通常是加密后的串对应明文一般是 123456 或 admin。2.3 前端请求基地址与跨域配置的对应关系前端如果是 Vue 项目打开 src/utils/request.js 或 src/api 下的封装文件找 baseURL。常见写法是baseURL: http://localhost:8080或/api。如果是/api说明用了代理去看 vue.config.js 里的 proxy 配置。后端则要看 application.yml 里的server.servlet.context-path和任何 CORS 配置类。// 前端 request.js 典型片段 const service axios.create({ baseURL: process.env.VUE_APP_BASE_API || http://localhost:8080, timeout: 10000 })逻辑说明前端 baseURL 写死 8080后端 context-path 却是 /office那所有请求都会 404。参数上timeout 10000 是 10 秒办公用品系统的库存查询和导出可能超过这个时间如果导出 Excel 报超时先改这里。跨域问题在前后端分离项目里几乎必现后端要么加 CrossOrigin要么写一个 WebMvcConfigurer 的 addCorsMappings两者取其一即可重复配置反而会报「allowedOrigins cannot contain *」。3. 本地跑通的最小闭环MySQL 建库、改配置、双端启动静态检查没问题后进入实际启动环节。这一章的目标是让你看到登录页并能用 admin 登进去。顺序不能乱先数据库再后端最后前端。反过来做前端起来了后端没起页面一直转圈你会误判是前端 bug。3.1 MySQL 8 建库导入与连接串四个必改参数MySQL 安装配置教程网上很多这里只说和本项目相关的。用 Navicat 或命令行都行先建库再执行 SQL 文件。注意 SQL 文件开头如果有CREATE DATABASE和USE直接整体运行即可如果没有先手动建库再选中执行。# 命令行导入示例 mysql -u root -p -e CREATE DATABASE office_supplies DEFAULT CHARACTER SET utf8mb4; mysql -u root -p office_supplies office_supplies.sql然后改后端 application.yml 或 application-dev.yml 里的数据源spring: datasource: url: jdbc:mysql://localhost:3306/office_supplies?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver逻辑说明四个必改参数是 url 里的库名、username、password、以及 serverTimezone。MySQL 8 不写 serverTimezone 会报「The server time zone value is unrecognized」。useSSLfalse 是本地开发常用避免 mysql ssl 连接错误。driver-class-name 在 MySQL 8 下必须是 com.mysql.cj.jdbc.Driver写成 com.mysql.jdbc.Driver 会警告但通常还能跑建议改对。3.2 后端启动类扫描路径与端口冲突排查导入 IDEA 后等 Maven 依赖下载完。找到启动类通常是 XxxApplication.java上面有 SpringBootApplication 和 MapperScan。确认 MapperScan 的包路径和你的 mapper 接口实际路径一致不一致会导致注入失败。SpringBootApplication MapperScan(com.example.office.mapper) // 包名以实际为准 public class OfficeApplication { public static void main(String[] args) { SpringApplication.run(OfficeApplication.class, args); } }逻辑说明启动时如果报「Port 8080 was already in use」要么改server.port要么杀掉占用进程。Windows 用netstat -ano | findstr 8080找 PIDMac/Linux 用lsof -i:8080。另一个高频错误是「Consider defining a bean of type xxxMapper」九成是 MapperScan 路径写错或 mapper 接口没加 Mapper 注解。参数上如果项目用了 Druid 连接池还要看 druid 的 initialSize 和 maxActive本地开发 initialSize 设 1 就够设大了启动慢。3.3 前端 npm 安装与代理指向后端真实端口前端目录下先看有没有 package.json有就是标准 Node 项目。执行npm install或cnpm install然后npm run dev或npm run serve。如果启动报 node-sass 相关错误说明 Node 版本太高换到 14 或 16 再试。# 前端启动 npm install npm run serve如果前端请求走代理检查 vue.config.jsmodule.exports { devServer: { proxy: { /api: { target: http://localhost:8080, // 后端真实地址 changeOrigin: true, pathRewrite: { ^/api: } } } } }逻辑说明pathRewrite 的作用是去掉请求前缀。如果后端接口本身不带 /api而前端 baseURL 是 /api就必须重写否则 404。参数上changeOrigin 设为 true 是为了让后端看到的 Host 是目标地址某些鉴权逻辑会校验 Host。前端启动后浏览器打开控制台看 Network 里登录请求的完整 URL和后端 Controller 的 RequestMapping 拼起来能不能对上对不上就改代理或改 baseURL二选一。4. 源码改造前必须搞懂的三层结构与权限拦截能跑起来只是第一步。你大概率要改它——加个字段、换个审批流、接公司统一登录。改之前如果不清楚它的分层和权限拦截在哪很容易改出「登录能进但接口 401」这种前后端互相甩锅的问题。4.1 Controller-Service-Mapper 的职责边界与常见越界写法标准 SpringBoot 分层是 Controller 收参、Service 写业务、Mapper 碰数据库。但很多源码为了省事Controller 里直接调 Mapper或者 Service 里塞了一堆 HttpServletRequest 解析。你要改功能先定位改哪层。// 规范写法示例 RestController RequestMapping(/supply) public class SupplyController { Autowired private SupplyService supplyService; GetMapping(/list) public Result list(RequestParam(defaultValue 1) Integer page) { return Result.success(supplyService.pageList(page)); } }逻辑说明Controller 只做参数接收和结果包装业务逻辑在 Service。如果你要加「低库存自动提醒」应该写在 Service 的库存扣减方法里而不是 Controller。参数上分页参数 page 和 size 建议统一默认值很多源码只写 page 不写 size前端传多少就查多少容易一次拉全表。Result 是统一返回体改的时候注意别破坏 code/msg/data 三段结构前端拦截器依赖它判断成功失败。4.2 登录态与角色鉴权拦截器、过滤器还是 Spring Security办公用品管理系统常见三种鉴权实现一是自定义拦截器 HandlerInterceptor 校验 token二是 Filter 里解析 JWT三是直接上 Spring Security。看源码里有没有 WebMvcConfigurer 的 addInterceptors或者一个继承 OncePerRequestFilter 的类。// 自定义拦截器典型写法 public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { String token request.getHeader(Authorization); if (token null || !jwtUtil.verify(token)) { response.setStatus(401); return false; } return true; } }逻辑说明拦截器放行路径通常在 addInterceptors 里用 excludePathPatterns 配置登录接口和静态资源必须放行。参数上token 一般放 Header 的 Authorization 字段前缀 Bearer 可有可无看前端怎么传。如果你改了登录逻辑但没同步改拦截器的校验规则就会出现「登录成功但后续接口全 401」。排查时先看拦截器有没有放行登录路径再看 token 解析是否抛异常。4.3 前后端联调时判断 bug 归属的快速方法前后端分离项目实战里最耗时的不是写代码是判断问题出在哪一端。我的习惯是浏览器 F12 打开 Network看请求有没有发出去、状态码是多少、响应体是什么。请求没发出去前端问题状态码 404路径对不上401鉴权问题500后端异常去看后端控制台堆栈。现象大概率归属第一步排查请求 pending 后失败前端或网络看 baseURL 和代理404路径不匹配对比 Controller 映射401鉴权看 token 是否携带500后端看控制台异常栈返回数据但页面不渲染前端看字段名是否一致逻辑说明这张表能覆盖八成联调问题。参数上字段名不一致是隐形杀手后端返回userName前端取username页面就是空白Network 里数据明明有。遇到这种情况直接对比返回 JSON 的 key 和前端模板里绑定的变量名。5. 避坑与排查源码跑不起来时先看这五条这一章是我自己踩过的坑按「现象 → 原因 → 解决」写。你按顺序排查基本能覆盖 90% 的启动失败。5.1 现象启动报 Access denied for user rootlocalhost原因application.yml 里的密码和本地 MySQL 实际密码不一致或者 MySQL 8 的 root 用户默认插件是 caching_sha2_password旧驱动不认。解决先确认密码命令行mysql -u root -p能登进去说明密码对。如果密码对但 Java 连不上把 MySQL 用户插件改成 mysql_native_passwordALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码;然后刷新权限。5.2 现象前端页面能开但所有接口 404原因代理没生效或 baseURL 写错请求发到了前端自己的端口。解决F12 看请求 URL如果是http://localhost:8081/api/xxx而不是http://localhost:8080/xxx说明代理没起作用。检查 vue.config.js 是否被正确加载改完必须重启前端 dev server热更新不会重载代理配置。5.3 现象登录成功但跳转后立刻退回登录页原因token 存了但请求没带上或者拦截器校验的 Header 名和前端设置的不一致。解决看前端请求拦截器有没有config.headers[Authorization] token再看后端拦截器取的是不是同一个 key。常见错位是前端存 localStorage 的 key 叫 token后端取 Header 叫 token但前端发送时忘了拼 Bearer 前缀后端解析时按带前缀处理。5.4 现象中文用品名存入数据库变成问号原因数据库、表、连接串三处字符集不统一。解决库和表用 utf8mb4连接串加characterEncodingutf8MySQL 服务端 my.cnf 里 character-set-serverutf8mb4。三处缺一处都可能乱码。已经乱码的数据改不回来只能重新录入。5.5 现象Maven 依赖下载极慢或失败原因默认中央仓库网络问题。解决在 settings.xml 里配国内镜像。改完在 IDEA 里刷新 Maven 项目。如果某个依赖死活下不来去本地仓库目录删掉对应文件夹再刷新缓存损坏比网络问题更常见。6. 把这套源码改成自己项目的一个实用技巧先动 SQL 再动 Java很多人改源码的顺序是反的先改 Java 实体类再改 Mapper XML最后才想起数据库字段没加结果启动就报列不存在。我的习惯是反着来——先在数据库里把字段加好再改实体类最后改 XML 和前端。这样每一步都有据可依不会出现「代码改了但数据库不认」的黑匣子状态。具体操作假设你要给办公用品表加一个「品牌」字段。第一步执行ALTER TABLE office_supply ADD COLUMN brand VARCHAR(50) DEFAULT NULL COMMENT 品牌;。第二步在实体类 Supply.java 里加private String brand;lombok 会自动生成 get/set。第三步如果用了 MyBatis-Plus单表查询会自动映射不用改 XML如果手写 XML在 resultMap 和 insert/update 语句里补上 brand。第四步前端表单加输入框列表加一列。四步走完重启后端刷新前端功能就通了。这个顺序的好处是数据库是唯一真相源代码围着它转而不是反过来。我见过太多人先改代码再补 SQL结果字段类型对不上、默认值冲突排查半天。另外改之前先备份 SQL 文件改错了能回滚这就是后悔药。验证方法也简单改完后用 Postman 或浏览器直接调新增接口传 brand 值再去数据库SELECT brand FROM office_supply ORDER BY id DESC LIMIT 1;看存进去没有。存进去了前端再联调没存进去看后端日志的 SQL 语句把参数拼进去手动执行一遍问题立刻现形。最后说一个习惯每次改完一个功能把对应的 SQL 变更单独记在一个 changelog.sql 文件里别散落在聊天记录或脑子里。下次部署到测试环境直接按顺序执行不用猜哪些字段加过哪些没加。这套源码本身不难难的是改着改着就乱了有个变更记录能救命。希望帮到你。本文还有配套的精品资源点击获取