尧图网站建设 
简介这是一份基于Java语言开发的企业级PMS项目管理系统设计源码面向需要研读大型Spring Boot项目结构、学习权限流程与模块化开发的Java工程师。压缩包共1725个文件大小15.41MB其中包含1297个Java源文件以及XML配置、VM模板、PNG图片、SQL脚本、HTTP请求文件、JSON数据、YAML与Shell脚本等辅助文件覆盖系统配置、页面渲染、前端展示、数据持久化、接口调用和自动化运维等环节。项目目录按yudao-framework、yudao-module-bpm、yudao-module-ai等模块拆分并配有lombok.config、pom.xml、Dockerfile、Jenkinsfile等工程化文件体现出清晰的框架分层、依赖管理和持续集成思路内容中还能看到验证码服务、学生管理、分类管理等典型企业功能实现。目前已有301人学习下载适合作为企业级Java项目源码研读范本可从中掌握大项目的包结构设计、数据库脚本组织、REST接口实现、通用表单处理以及容器化部署方法。1. Java 写的 PMS 项目管理系统源码为什么值得动手跑一遍把一套基于 Java 的 PMS 项目管理系统源码从压缩包里解压出来第一反应往往是慌几十个 Java 文件、几份 SQL 脚本、一两个 Shell 启动脚本不知道从哪个文件看起。这套源码的价值不在某个类写得有多花哨而在于它把项目管理里最常被问到的几条主链路完整串了起来登录认证、项目立项、任务拆解、工时填报、进度跟踪。做 Java 课程设计案例、毕业设计选题或者刚从培训班出来想看看真实工程长什么样拿它当底子都合适。它面对的问题非常具体项目怎么建、任务怎么分、工时怎么记、报表怎么出。所以别把它当源码赏析认真跑一遍再改一版比看十篇 Spring Boot 入门文章都顶用。这篇笔记按“是什么 → 怎么跑 → 坑在哪 → 怎么改”的顺序讲把能直接抄作业的配置、命令和排查步骤摆出来新手能一步步走到页面打开熟手也能直接跳到踩坑清单看边界。2. 拆一拆 PMS 的业务模块权限、项目、任务、工时是怎么串起来的PMS 这类管理系统代码量不在单个类而在业务状态流转和权限隔离。这套源码把典型 Java Web 工程按 controller / service / mapper 三层切开业务上大概覆盖系统管理、项目管理、任务管理、工时管理、报表统计五块。先把模块对应的表关系看清再往下读会顺手很多。模块典型数据表对外能力系统管理user / role / menu / user_role / role_menu登录、权限分配、菜单配置项目管理project / project_member / milestone立项、成员维护、里程碑任务管理task / task_log任务拆解、指派、状态流转工时管理work_hour按任务填报工时、按人汇总报表模块基于以上表做多表聚合工时统计、项目进度汇总2.1 登录态与权限模型用户-角色-菜单三层要怎么看先找到 LoginController 或者 AuthController看清登录成功后返回什么。常见做法是生成一个 UUID 或者 JWT 作为 token写进 Redis 并设置过期时间再返回给前端。后面每个受保护接口都从请求头里取同一个字段如果前端传的 key 和后端取的不一致就会一直 401。这是很多新手第一次跑 PMS 源码就遇到的玄学问题看起来像是登录没生效实际只是头名字对不上。我一般会写一个拦截器把所有 /api/** 请求拦一道逻辑很直白只有查到 Redis 里存在这个 token 才放行。源码里大概率也是这么做的你可以顺着登录代码找到对应的 key 前缀和过期策略。Component public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token request.getHeader(Authorization); if (token null || !redisTemplate.hasKey(login: token)) { response.setStatus(401); response.setContentType(application/json); response.getWriter().write({\code\:401,\msg\:\未登录\}); return false; } return true; } }这段代码里最关键的是redisTemplate.hasKey(login: token)它要求登录时存储 key 时必须带login:前缀否则校验永远失败。Authorization这个头名称也是约定好的前端 axios 拦截器里必须用同名设置改了后端这里就要同步改。权限菜单再往下走一层就是用 userId 去查角色再用角色查菜单表过滤出当前用户能看到的按钮和数据范围。2.2 从立项到任务分配项目状态是理解全系统的钥匙项目表里几乎都有一个 status 字段状态流转是面试和答辩时最常被问的设计点。看懂这张表的状态设计后面改需求才有底气。常见的状态枚举大概是下面这个节奏。阶段status 值触发动作数据表现草稿0新建立项单project_member 还没写入进行中1任务表插入第一条记录task、work_hour 开始持续写入已归档2用户点击归档项目列表默认过滤工时只读从立项到任务分配的数据流其实是一条很清晰的写入链先插 project 获得项目 ID再插 project_member 把成员挂到项目下接着按项目 ID 往 task 表批量插入任务指定负责人、优先级、预计工时最后成员在 work_hour 表按天回填实际工时。Service 层调用 Mapper 的顺序基本就是上面这个顺序。2.3 报表与导出最容易抄走的一段逻辑工时统计在后端往往只需要一条聚合 SQL。很多课程设计里把“报表模块”写得很玄乎实际上就是 GROUP BY 两三个字段。真正要抄作业的时候先看 work_hour 这张表它就是一张事实表按时长累加就行。SELECT p.project_name, t.owner_id AS user_id, SUM(w.work_hours) AS total_hours FROM project p JOIN task t ON t.project_id p.id JOIN work_hour w ON w.task_id t.id WHERE p.create_time 2025-01-01 GROUP BY p.project_name, t.owner_id ORDER BY total_hours DESC;这条 SQL 最值得抄的是 JOIN 顺序project → task → work_hour三张表的主外键关系是这种统计查询能跑通的前提。GROUP BY用了两个维度项目名加负责人出来的结果就是“谁在哪个项目上花了多少小时”。做 Excel 导出时通常就是先把这条 SQL 的查询结果放到 List 里再用 Apache POI 按行填充到 Workbook最后写到response.getOutputStream()里。工作中经常有人问 Java POI 能不能生成图表实际上数据层只要能把 List 查出来剩下的就是 Workbook 的 API 调用问题。3. 跑起来之前JDK、MySQL、Redis 与建库脚本一次配齐环境问题是最容易劝退新手的一关。这套源码是按常规 Java Web 工程组织的先把环境收敛到“能跑”的集合再谈改代码。我接手的绝大多数 PMS 类源码技术栈都逃不开 MySQL 加 Redis 加 Spring Boot 的组合所以下面这套参数基本能直接套用。3.1 环境参数对照JDK 8/11、MySQL 5.7/8.0、Maven 一个都不能少组件常见版本作用注意点JDK1.8 或 11编译运行后端版本要与 pom.xml 里的 maven.compiler 一致MySQL5.7 或 8.0存储业务数据驱动类名随版本变化Redis3.x 及以上存登录 token、验证码启动顺序要放在应用之前Maven3.6 以上打包依赖镜像源要配好否则下载慢IDEIDEA 或 Eclipse看代码、调试导入时选 Maven 工程别选普通文件夹这里最容易翻车的组合是 JDK 11 配一个用 JDK 8 编译的旧工程编译时一堆cannot find symbol。拿到源码先看 pom.xml 里的java.version和maven.compiler.source本地 JDK 必须不低于这个版本最好完全一致。 Redis 是很多人忽略的一环PMS 的验证码和登录态多半都挂在 Redis 上只要它没起来页面就会出现“登录成功又跳回登录页”这种鬼打墙现象。3.2 执行建库脚本三条命令把数据库从 0 拉到能连SQL 脚本一般在源码根目录的 sql 或者 doc 文件夹下文件名叫 pms.sql 之类的。先建空库再导入最后自检表数量这三步动作在 Linux 和 Windows 上通用。mysql -u root -p -e CREATE DATABASE IF NOT EXISTS pms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p --default-character-setutf8mb4 pms /你的解压目录/sql/pms.sql mysql -u root -p -e USE pms; SHOW TABLES;第一条命令用-e直接执行建库语句IF NOT EXISTS防止重复执行报错utf8mb4是中文场景下的标准字符集。第二条命令把 SQL 文件导入到刚才建好的 pms 库里--default-character-setutf8mb4必须带着否则备注和中文数据容易乱码。第三条SHOW TABLES用来核对表是否齐全一个正常 PMS 源码至少要有十几张业务表只有三五张的话说明 SQL 文件没找对或者导入的不是最新版本。导入完成后我习惯再补一句SELECT COUNT(*) FROM information_schema.tables WHERE table_schemapms;直接数表数量防止个别表导入失败。顺便说一下SQL 文件里初始管理员的密码通常是 MD5 或者 BCrypt 加密后的串不要手改成明文再去登录登录逻辑不会认这种篡改。4. 源码结构与 Shell 启动脚本把后端工程真正拎起来源码包里最容易被忽略的是 deploy 目录下的 .sh 文件。很多人只会在 IDEA 里点 Run到了 Linux 服务器上就傻眼。这一章把 Spring Boot 工程从源码变成可访问 Web 服务的完整路径走一遍重点放在 configuration 和 Shell 启动脚本上。4.1 工程目录先看这几个文件别在 src 里翻太久一个标准 PMS 后端工程的目录结构大概长这样拿到手先对照一下不要一进来就钻进 controller 包。pms-backend/ ├── pom.xml ├── src/main/java/com/xxx/pms/ │ ├── controller/ │ ├── service/ │ ├── mapper/ │ ├── entity/ │ └── config/ ├── src/main/resources/ │ ├── application.yml │ └── mapper/ ├── sql/pms.sql └── deploy/ ├── start.sh └── stop.shpom.xml 是第一优先级它决定了这个工程能不能编译。第二优先级是 application.yml数据源和端口全在里头。第三优先级是 sql 目录表结构全在这里。deploy 目录里的 start.sh 和 stop.sh 是上服务器之后的后悔药没有的话手写启动命令很容易忘参数。至于 controller、service、mapper 这些 Java 包的阅读顺序按第 2 章的业务链路来看就够了别按字母序读会越读越晕。4.2 application.yml端口、数据源、Redis、Mapper 都在这里把默认配置改成自己的环境是运行前必做的一步。下面是一份最常见的 Spring Boot 配置骨架很多源码只是字段名略有差异。server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/pms?useUnicodetruecharacterEncodingutf8mb4useSSLfalseserverTimezoneAsia/Shanghai username: root password: ${DB_PASSWORD:root} driver-class-name: com.mysql.cj.jdbc.Driver redis: host: localhost port: 6379 jackson: date-format: yyyy-MM-dd HH:mm:ss mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.xxx.pms.entitycharacterEncodingutf8mb4和serverTimezoneAsia/Shanghai这两个参数几乎是所有中文 Java 工程的标配前者解决中文乱码后者解决时区导致的时间差八小时问题。driver-class-name要跟 MySQL 版本对齐MySQL 8 用com.mysql.cj.jdbc.DriverMySQL 5.7 用com.mysql.jdbc.Driver写反了启动直接报加载类失败。密码写成${DB_PASSWORD:root}的意思是环境变量里有 DB_PASSWORD 就用环境变量的值没有就用默认的 root这是把密码从代码里剥离出去的常见写法。4.3 start.sh 与 stop.shShell 脚本到底在干什么源码包里如果带 Shell 脚本基本都是围绕“检测是否已在运行 → 后台启动 → 写日志”三件事设计的。下面是一份常见的 start.sh 逻辑和大多数 PMS 源码里给的几乎一致。#!/bin/bash APP_NAMEpms-system.jar JAVA_HOME/usr/local/java/jdk1.8 LOG_FILElogs/pms.out if [ ! -d logs ]; then mkdir -p logs fi PID$(ps -ef | grep $APP_NAME | grep -v grep | awk {print $2}) if [ -n $PID ]; then echo $APP_NAME is already running (PID: $PID) exit 1 fi nohup $JAVA_HOME/bin/java -Xms512m -Xmx1024m -jar $APP_NAME \ --spring.profiles.activeprod \ --server.port8080 $LOG_FILE 21 echo started, log at $LOG_FILE第一段ps -ef | grep $APP_NAME | grep -v grep | awk {print $2}是拿进程 IDgrep -v grep用来过滤掉 grep 命令本身不然会误判成已经有进程在跑。nohup和末尾的配合让 Java 进程脱离终端后台运行 $LOG_FILE 21把标准输出和错误输出都写进同一个日志文件。-Xms512m -Xmx1024m是堆内存参数小机器建议把 Xmx 降到 512m不然内存不够启动就会失败。--spring.profiles.activeprod是激活生产环境配置前提是 application-prod.yml 存在不存在就去掉这个参数。stop.sh 的逻辑更简单还是ps -ef找到 PID然后kill $PID再循环等待进程退出。这里的重点提醒是脚本中JAVA_HOME路径一定要改成自己机器上的实际路径否则整段脚本白搭。4.4 从 mvn package 到 tail -f一条命令一条命令走在 IDEA 里能 Run 起来只是第一步真正交付到服务器上靠的是 Maven 打包加一行启动命令。mvn clean package -DskipTests -Pprod cd target cp pms-system.jar ../deploy/ cd ../deploy ./start.sh tail -f logs/pms.out-DskipTests跳过测试用例避免打包过程因为测试环境差异中断注意它和-Dmaven.test.skiptrue的区别后者连测试代码都不编译前者只是不执行。-Pprod激活 pom.xml 里定义的 prod profile如果你配置文件里没有这个 profile就删掉这个参数。打包出来的 jar 名一定要和 start.sh 里的APP_NAME一致这是新手最容易踩的坑。启动后用tail -f实时看日志看到Started Application in x.xxx seconds才说明真的起来了。5. 常见问题排查数据库连不上、端口被占、脚本没执行权限怎么办这些坑不是理论总结是真正跑这套源码时最容易翻车的地方。每一条我都按“现象 → 原因 → 解决 → 怎么提前避免”这个顺序拆开讲排查的时候照着顺序来能省掉大量试探时间。5.1 登录提示“用户名或密码错误”但表里明明有管理员数据现象用 SQL 文件里预设的 admin 账号登录页面提示用户名或密码错误去 user 表里 SELECT 又能看到这条记录。原因登录时后端对密码做了加密比对而表里的初始密码是用某种算法生成的脱敏串不是明文。最常见的两种算法是 MD5 加盐和 BCrypt两者结果完全不兼容。如果你后来手动把密码字段改成明文登录逻辑更不会认账。解决先看注册或者初始化数据那段代码确认用的是哪种加密器然后用同一种方式把密码重新生成一遍更新到 user 表里。Spring Security 场景下可以直接写一个 CommandLineRunner 临时生成密码用完再删掉。提前避免拿到源码先搜Bean里有没有 PasswordEncoder有就判断是 BCrypt 还是 Md5PasswordEncoder再去倒推初始数据是怎么造出来的。5.2 项目列表接口返回 500日志里报 Unknown column status现象功能菜单能打开但一旦访问项目列表后端日志直接抛Unknown column status in field list。原因代码里查了 status 字段但数据库表里没有这一列。大概率是 SQL 脚本和代码不是同一版本代码是从 Git 仓库拉的最新代码数据库却还是老版本的建表脚本。解决不要试图去改代码迁就旧表直接把最新版 SQL 脚本重新导入一次。如果表里已有数据先备份旧库再执行ALTER TABLE project ADD COLUMN status TINYINT DEFAULT 0这类增量变更比全量导入风险小。提前避免导入 SQL 之前先DESC project;看字段列表和 entity 实体类里的字段对一遍对不上就先升级 SQL 再启动应用。5.3 执行 ./start.sh 报 Permission denied现象在 Linux 上执行启动脚本直接提示Permission denied文件明明就在当前目录。原因两种情况。一是文件没有执行权限二是脚本是 Windows 下编辑的换行符是 CRLFLinux 加载时第一个字符解析异常。解决先执行chmod x start.sh给执行权限再执行dos2unix start.sh把换行符转成 LF。如果没有 dos2unix 命令用sed -i s/\r$// start.sh也能达到同样效果。提前避免把脚本放进 Git 仓库时在 .gitattributes 里声明*.sh text eollf这样团队里不管谁在 Windows 上拉下来换行符也会被强制保持 LF。5.4 8080 端口起不来日志里提示 BindException现象启动日志中段出现BindException: Address already in use应用直接退出。原因8080 端口被另一个 Java 进程或者其他服务占用。常见情况是上次关闭应用时 kill 不干净或者本机跑了别的 Web 服务。解决Linux 下执行lsof -i:8080找到占用进程的 PID确认是残留进程后kill -9 PID。如果这个端口是刻意留给别的服务的就改 application.yml 里的server.port改成 8090 再启动。提前避免启动脚本里加入旧进程检测逻辑发现端口被占直接提示而不是等到 Java 启动失败。5.5 验证码不显示登录成功后跳回登录页现象登录页验证码图片加载不出来或者输入正确账号密码后页面瞬间跳回登录页后端日志里能看到 Redis 连接异常。原因登录态和验证码都依赖 RedisRedis 服务没启动token 就写不进去自然也校验不了。这是 PMS 类源码最常见的外部依赖遗漏。解决先把 Redis 拉起来本机调试直接redis-server /etc/redis/redis.conf或者systemctl start redis。起来之后确认 application.yml 里的spring.redis.host和port配置能和 Redis 对上然后重启后端应用。提前避免把 MySQL、Redis、后端应用三个服务的启动顺序固定下来Redis 永远在应用启动之前。日志里看到Unable to connect to Redis这类关键词就不要再去查前端代码了。快速自检项检查命令期望结果MySQL 可连mysql -u root -p -e show databases;能看到 pms 库Redis 可连redis-cli ping返回 PONG端口监听中lsof -i:8080有 java 进程监听表结构完整SELECT COUNT(*) FROM information_schema.tables WHERE table_schemapms;与实体类数量匹配6. 进阶验证跑通登录到项目列表的最小链路再谈加功能拿到任何一套管理类源码我最先做的事情不是看代码而是先跑通一条最小链路登录接口拿到凭证再带着凭证访问一个受保护的业务接口。这条链路通了才证明数据源、Redis、拦截器、Mapper 全部正常。curl -c cookie.txt -X POST http://localhost:8080/api/login \ -H Content-Type: application/json \ -d {username:admin,password:123456} curl -b cookie.txt http://localhost:8080/api/project/list-c cookie.txt把登录后返回的 Cookie 写入本地文件-b cookie.txt在请求业务接口时把 Cookie 带上去。如果登录返回的是 JSON 里的 token 而不是 Cookie就把 token 手动贴到-H Authorization: token值里。项目列表接口返回 200 并且带出 JSON 数据整套源码的后端链路就算验证通过了。这个习惯在二次开发时特别值钱它把“代码能不能跑”和“业务对不对”拆成两件事改完代码先用 curl 冒烟不要每次都开浏览器点半天。验证通过之后再谈加功能。比如要给 PMS 加一个“项目归档”操作动手之前先确认三件事第一project 表里有没有 status 字段归档就是把这个字段从 1 改成 2第二项目列表查询接口的 SQL 里是否已经对 status 做了默认过滤不然归档后的项目还会出现在列表里等于白做第三归档操作的接口有没有权限校验归档是不可逆动作按住 Ctrl 就想加接口的做法容易留下权限漏洞。我见过太多人拿到源码第一件事就是改登录页样式结果折腾一上午发现后端还没跑起来。从那以后我每次拿到管理类源码都强制自己先走一遍“环境自检 → 建库 → 打包 → curl 最小链路”这个流程确认地基是好的再往上面加业务。这套流程花不了半小时但能帮你把数据库、缓存、端口这些最容易翻车的问题一次性排干净。希望帮到你也祝你跑得顺利。本文还有配套的精品资源点击获取 Java PMS项目管理系统源码实战：环境配置、部署运行与二次开发指南
简介这是一份基于Java语言开发的企业级PMS项目管理系统设计源码面向需要研读大型Spring Boot项目结构、学习权限流程与模块化开发的Java工程师。压缩包共1725个文件大小15.41MB其中包含1297个Java源文件以及XML配置、VM模板、PNG图片、SQL脚本、HTTP请求文件、JSON数据、YAML与Shell脚本等辅助文件覆盖系统配置、页面渲染、前端展示、数据持久化、接口调用和自动化运维等环节。项目目录按yudao-framework、yudao-module-bpm、yudao-module-ai等模块拆分并配有lombok.config、pom.xml、Dockerfile、Jenkinsfile等工程化文件体现出清晰的框架分层、依赖管理和持续集成思路内容中还能看到验证码服务、学生管理、分类管理等典型企业功能实现。目前已有301人学习下载适合作为企业级Java项目源码研读范本可从中掌握大项目的包结构设计、数据库脚本组织、REST接口实现、通用表单处理以及容器化部署方法。1. Java 写的 PMS 项目管理系统源码为什么值得动手跑一遍把一套基于 Java 的 PMS 项目管理系统源码从压缩包里解压出来第一反应往往是慌几十个 Java 文件、几份 SQL 脚本、一两个 Shell 启动脚本不知道从哪个文件看起。这套源码的价值不在某个类写得有多花哨而在于它把项目管理里最常被问到的几条主链路完整串了起来登录认证、项目立项、任务拆解、工时填报、进度跟踪。做 Java 课程设计案例、毕业设计选题或者刚从培训班出来想看看真实工程长什么样拿它当底子都合适。它面对的问题非常具体项目怎么建、任务怎么分、工时怎么记、报表怎么出。所以别把它当源码赏析认真跑一遍再改一版比看十篇 Spring Boot 入门文章都顶用。这篇笔记按“是什么 → 怎么跑 → 坑在哪 → 怎么改”的顺序讲把能直接抄作业的配置、命令和排查步骤摆出来新手能一步步走到页面打开熟手也能直接跳到踩坑清单看边界。2. 拆一拆 PMS 的业务模块权限、项目、任务、工时是怎么串起来的PMS 这类管理系统代码量不在单个类而在业务状态流转和权限隔离。这套源码把典型 Java Web 工程按 controller / service / mapper 三层切开业务上大概覆盖系统管理、项目管理、任务管理、工时管理、报表统计五块。先把模块对应的表关系看清再往下读会顺手很多。模块典型数据表对外能力系统管理user / role / menu / user_role / role_menu登录、权限分配、菜单配置项目管理project / project_member / milestone立项、成员维护、里程碑任务管理task / task_log任务拆解、指派、状态流转工时管理work_hour按任务填报工时、按人汇总报表模块基于以上表做多表聚合工时统计、项目进度汇总2.1 登录态与权限模型用户-角色-菜单三层要怎么看先找到 LoginController 或者 AuthController看清登录成功后返回什么。常见做法是生成一个 UUID 或者 JWT 作为 token写进 Redis 并设置过期时间再返回给前端。后面每个受保护接口都从请求头里取同一个字段如果前端传的 key 和后端取的不一致就会一直 401。这是很多新手第一次跑 PMS 源码就遇到的玄学问题看起来像是登录没生效实际只是头名字对不上。我一般会写一个拦截器把所有 /api/** 请求拦一道逻辑很直白只有查到 Redis 里存在这个 token 才放行。源码里大概率也是这么做的你可以顺着登录代码找到对应的 key 前缀和过期策略。Component public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token request.getHeader(Authorization); if (token null || !redisTemplate.hasKey(login: token)) { response.setStatus(401); response.setContentType(application/json); response.getWriter().write({\code\:401,\msg\:\未登录\}); return false; } return true; } }这段代码里最关键的是redisTemplate.hasKey(login: token)它要求登录时存储 key 时必须带login:前缀否则校验永远失败。Authorization这个头名称也是约定好的前端 axios 拦截器里必须用同名设置改了后端这里就要同步改。权限菜单再往下走一层就是用 userId 去查角色再用角色查菜单表过滤出当前用户能看到的按钮和数据范围。2.2 从立项到任务分配项目状态是理解全系统的钥匙项目表里几乎都有一个 status 字段状态流转是面试和答辩时最常被问的设计点。看懂这张表的状态设计后面改需求才有底气。常见的状态枚举大概是下面这个节奏。阶段status 值触发动作数据表现草稿0新建立项单project_member 还没写入进行中1任务表插入第一条记录task、work_hour 开始持续写入已归档2用户点击归档项目列表默认过滤工时只读从立项到任务分配的数据流其实是一条很清晰的写入链先插 project 获得项目 ID再插 project_member 把成员挂到项目下接着按项目 ID 往 task 表批量插入任务指定负责人、优先级、预计工时最后成员在 work_hour 表按天回填实际工时。Service 层调用 Mapper 的顺序基本就是上面这个顺序。2.3 报表与导出最容易抄走的一段逻辑工时统计在后端往往只需要一条聚合 SQL。很多课程设计里把“报表模块”写得很玄乎实际上就是 GROUP BY 两三个字段。真正要抄作业的时候先看 work_hour 这张表它就是一张事实表按时长累加就行。SELECT p.project_name, t.owner_id AS user_id, SUM(w.work_hours) AS total_hours FROM project p JOIN task t ON t.project_id p.id JOIN work_hour w ON w.task_id t.id WHERE p.create_time 2025-01-01 GROUP BY p.project_name, t.owner_id ORDER BY total_hours DESC;这条 SQL 最值得抄的是 JOIN 顺序project → task → work_hour三张表的主外键关系是这种统计查询能跑通的前提。GROUP BY用了两个维度项目名加负责人出来的结果就是“谁在哪个项目上花了多少小时”。做 Excel 导出时通常就是先把这条 SQL 的查询结果放到 List 里再用 Apache POI 按行填充到 Workbook最后写到response.getOutputStream()里。工作中经常有人问 Java POI 能不能生成图表实际上数据层只要能把 List 查出来剩下的就是 Workbook 的 API 调用问题。3. 跑起来之前JDK、MySQL、Redis 与建库脚本一次配齐环境问题是最容易劝退新手的一关。这套源码是按常规 Java Web 工程组织的先把环境收敛到“能跑”的集合再谈改代码。我接手的绝大多数 PMS 类源码技术栈都逃不开 MySQL 加 Redis 加 Spring Boot 的组合所以下面这套参数基本能直接套用。3.1 环境参数对照JDK 8/11、MySQL 5.7/8.0、Maven 一个都不能少组件常见版本作用注意点JDK1.8 或 11编译运行后端版本要与 pom.xml 里的 maven.compiler 一致MySQL5.7 或 8.0存储业务数据驱动类名随版本变化Redis3.x 及以上存登录 token、验证码启动顺序要放在应用之前Maven3.6 以上打包依赖镜像源要配好否则下载慢IDEIDEA 或 Eclipse看代码、调试导入时选 Maven 工程别选普通文件夹这里最容易翻车的组合是 JDK 11 配一个用 JDK 8 编译的旧工程编译时一堆cannot find symbol。拿到源码先看 pom.xml 里的java.version和maven.compiler.source本地 JDK 必须不低于这个版本最好完全一致。 Redis 是很多人忽略的一环PMS 的验证码和登录态多半都挂在 Redis 上只要它没起来页面就会出现“登录成功又跳回登录页”这种鬼打墙现象。3.2 执行建库脚本三条命令把数据库从 0 拉到能连SQL 脚本一般在源码根目录的 sql 或者 doc 文件夹下文件名叫 pms.sql 之类的。先建空库再导入最后自检表数量这三步动作在 Linux 和 Windows 上通用。mysql -u root -p -e CREATE DATABASE IF NOT EXISTS pms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p --default-character-setutf8mb4 pms /你的解压目录/sql/pms.sql mysql -u root -p -e USE pms; SHOW TABLES;第一条命令用-e直接执行建库语句IF NOT EXISTS防止重复执行报错utf8mb4是中文场景下的标准字符集。第二条命令把 SQL 文件导入到刚才建好的 pms 库里--default-character-setutf8mb4必须带着否则备注和中文数据容易乱码。第三条SHOW TABLES用来核对表是否齐全一个正常 PMS 源码至少要有十几张业务表只有三五张的话说明 SQL 文件没找对或者导入的不是最新版本。导入完成后我习惯再补一句SELECT COUNT(*) FROM information_schema.tables WHERE table_schemapms;直接数表数量防止个别表导入失败。顺便说一下SQL 文件里初始管理员的密码通常是 MD5 或者 BCrypt 加密后的串不要手改成明文再去登录登录逻辑不会认这种篡改。4. 源码结构与 Shell 启动脚本把后端工程真正拎起来源码包里最容易被忽略的是 deploy 目录下的 .sh 文件。很多人只会在 IDEA 里点 Run到了 Linux 服务器上就傻眼。这一章把 Spring Boot 工程从源码变成可访问 Web 服务的完整路径走一遍重点放在 configuration 和 Shell 启动脚本上。4.1 工程目录先看这几个文件别在 src 里翻太久一个标准 PMS 后端工程的目录结构大概长这样拿到手先对照一下不要一进来就钻进 controller 包。pms-backend/ ├── pom.xml ├── src/main/java/com/xxx/pms/ │ ├── controller/ │ ├── service/ │ ├── mapper/ │ ├── entity/ │ └── config/ ├── src/main/resources/ │ ├── application.yml │ └── mapper/ ├── sql/pms.sql └── deploy/ ├── start.sh └── stop.shpom.xml 是第一优先级它决定了这个工程能不能编译。第二优先级是 application.yml数据源和端口全在里头。第三优先级是 sql 目录表结构全在这里。deploy 目录里的 start.sh 和 stop.sh 是上服务器之后的后悔药没有的话手写启动命令很容易忘参数。至于 controller、service、mapper 这些 Java 包的阅读顺序按第 2 章的业务链路来看就够了别按字母序读会越读越晕。4.2 application.yml端口、数据源、Redis、Mapper 都在这里把默认配置改成自己的环境是运行前必做的一步。下面是一份最常见的 Spring Boot 配置骨架很多源码只是字段名略有差异。server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/pms?useUnicodetruecharacterEncodingutf8mb4useSSLfalseserverTimezoneAsia/Shanghai username: root password: ${DB_PASSWORD:root} driver-class-name: com.mysql.cj.jdbc.Driver redis: host: localhost port: 6379 jackson: date-format: yyyy-MM-dd HH:mm:ss mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.xxx.pms.entitycharacterEncodingutf8mb4和serverTimezoneAsia/Shanghai这两个参数几乎是所有中文 Java 工程的标配前者解决中文乱码后者解决时区导致的时间差八小时问题。driver-class-name要跟 MySQL 版本对齐MySQL 8 用com.mysql.cj.jdbc.DriverMySQL 5.7 用com.mysql.jdbc.Driver写反了启动直接报加载类失败。密码写成${DB_PASSWORD:root}的意思是环境变量里有 DB_PASSWORD 就用环境变量的值没有就用默认的 root这是把密码从代码里剥离出去的常见写法。4.3 start.sh 与 stop.shShell 脚本到底在干什么源码包里如果带 Shell 脚本基本都是围绕“检测是否已在运行 → 后台启动 → 写日志”三件事设计的。下面是一份常见的 start.sh 逻辑和大多数 PMS 源码里给的几乎一致。#!/bin/bash APP_NAMEpms-system.jar JAVA_HOME/usr/local/java/jdk1.8 LOG_FILElogs/pms.out if [ ! -d logs ]; then mkdir -p logs fi PID$(ps -ef | grep $APP_NAME | grep -v grep | awk {print $2}) if [ -n $PID ]; then echo $APP_NAME is already running (PID: $PID) exit 1 fi nohup $JAVA_HOME/bin/java -Xms512m -Xmx1024m -jar $APP_NAME \ --spring.profiles.activeprod \ --server.port8080 $LOG_FILE 21 echo started, log at $LOG_FILE第一段ps -ef | grep $APP_NAME | grep -v grep | awk {print $2}是拿进程 IDgrep -v grep用来过滤掉 grep 命令本身不然会误判成已经有进程在跑。nohup和末尾的配合让 Java 进程脱离终端后台运行 $LOG_FILE 21把标准输出和错误输出都写进同一个日志文件。-Xms512m -Xmx1024m是堆内存参数小机器建议把 Xmx 降到 512m不然内存不够启动就会失败。--spring.profiles.activeprod是激活生产环境配置前提是 application-prod.yml 存在不存在就去掉这个参数。stop.sh 的逻辑更简单还是ps -ef找到 PID然后kill $PID再循环等待进程退出。这里的重点提醒是脚本中JAVA_HOME路径一定要改成自己机器上的实际路径否则整段脚本白搭。4.4 从 mvn package 到 tail -f一条命令一条命令走在 IDEA 里能 Run 起来只是第一步真正交付到服务器上靠的是 Maven 打包加一行启动命令。mvn clean package -DskipTests -Pprod cd target cp pms-system.jar ../deploy/ cd ../deploy ./start.sh tail -f logs/pms.out-DskipTests跳过测试用例避免打包过程因为测试环境差异中断注意它和-Dmaven.test.skiptrue的区别后者连测试代码都不编译前者只是不执行。-Pprod激活 pom.xml 里定义的 prod profile如果你配置文件里没有这个 profile就删掉这个参数。打包出来的 jar 名一定要和 start.sh 里的APP_NAME一致这是新手最容易踩的坑。启动后用tail -f实时看日志看到Started Application in x.xxx seconds才说明真的起来了。5. 常见问题排查数据库连不上、端口被占、脚本没执行权限怎么办这些坑不是理论总结是真正跑这套源码时最容易翻车的地方。每一条我都按“现象 → 原因 → 解决 → 怎么提前避免”这个顺序拆开讲排查的时候照着顺序来能省掉大量试探时间。5.1 登录提示“用户名或密码错误”但表里明明有管理员数据现象用 SQL 文件里预设的 admin 账号登录页面提示用户名或密码错误去 user 表里 SELECT 又能看到这条记录。原因登录时后端对密码做了加密比对而表里的初始密码是用某种算法生成的脱敏串不是明文。最常见的两种算法是 MD5 加盐和 BCrypt两者结果完全不兼容。如果你后来手动把密码字段改成明文登录逻辑更不会认账。解决先看注册或者初始化数据那段代码确认用的是哪种加密器然后用同一种方式把密码重新生成一遍更新到 user 表里。Spring Security 场景下可以直接写一个 CommandLineRunner 临时生成密码用完再删掉。提前避免拿到源码先搜Bean里有没有 PasswordEncoder有就判断是 BCrypt 还是 Md5PasswordEncoder再去倒推初始数据是怎么造出来的。5.2 项目列表接口返回 500日志里报 Unknown column status现象功能菜单能打开但一旦访问项目列表后端日志直接抛Unknown column status in field list。原因代码里查了 status 字段但数据库表里没有这一列。大概率是 SQL 脚本和代码不是同一版本代码是从 Git 仓库拉的最新代码数据库却还是老版本的建表脚本。解决不要试图去改代码迁就旧表直接把最新版 SQL 脚本重新导入一次。如果表里已有数据先备份旧库再执行ALTER TABLE project ADD COLUMN status TINYINT DEFAULT 0这类增量变更比全量导入风险小。提前避免导入 SQL 之前先DESC project;看字段列表和 entity 实体类里的字段对一遍对不上就先升级 SQL 再启动应用。5.3 执行 ./start.sh 报 Permission denied现象在 Linux 上执行启动脚本直接提示Permission denied文件明明就在当前目录。原因两种情况。一是文件没有执行权限二是脚本是 Windows 下编辑的换行符是 CRLFLinux 加载时第一个字符解析异常。解决先执行chmod x start.sh给执行权限再执行dos2unix start.sh把换行符转成 LF。如果没有 dos2unix 命令用sed -i s/\r$// start.sh也能达到同样效果。提前避免把脚本放进 Git 仓库时在 .gitattributes 里声明*.sh text eollf这样团队里不管谁在 Windows 上拉下来换行符也会被强制保持 LF。5.4 8080 端口起不来日志里提示 BindException现象启动日志中段出现BindException: Address already in use应用直接退出。原因8080 端口被另一个 Java 进程或者其他服务占用。常见情况是上次关闭应用时 kill 不干净或者本机跑了别的 Web 服务。解决Linux 下执行lsof -i:8080找到占用进程的 PID确认是残留进程后kill -9 PID。如果这个端口是刻意留给别的服务的就改 application.yml 里的server.port改成 8090 再启动。提前避免启动脚本里加入旧进程检测逻辑发现端口被占直接提示而不是等到 Java 启动失败。5.5 验证码不显示登录成功后跳回登录页现象登录页验证码图片加载不出来或者输入正确账号密码后页面瞬间跳回登录页后端日志里能看到 Redis 连接异常。原因登录态和验证码都依赖 RedisRedis 服务没启动token 就写不进去自然也校验不了。这是 PMS 类源码最常见的外部依赖遗漏。解决先把 Redis 拉起来本机调试直接redis-server /etc/redis/redis.conf或者systemctl start redis。起来之后确认 application.yml 里的spring.redis.host和port配置能和 Redis 对上然后重启后端应用。提前避免把 MySQL、Redis、后端应用三个服务的启动顺序固定下来Redis 永远在应用启动之前。日志里看到Unable to connect to Redis这类关键词就不要再去查前端代码了。快速自检项检查命令期望结果MySQL 可连mysql -u root -p -e show databases;能看到 pms 库Redis 可连redis-cli ping返回 PONG端口监听中lsof -i:8080有 java 进程监听表结构完整SELECT COUNT(*) FROM information_schema.tables WHERE table_schemapms;与实体类数量匹配6. 进阶验证跑通登录到项目列表的最小链路再谈加功能拿到任何一套管理类源码我最先做的事情不是看代码而是先跑通一条最小链路登录接口拿到凭证再带着凭证访问一个受保护的业务接口。这条链路通了才证明数据源、Redis、拦截器、Mapper 全部正常。curl -c cookie.txt -X POST http://localhost:8080/api/login \ -H Content-Type: application/json \ -d {username:admin,password:123456} curl -b cookie.txt http://localhost:8080/api/project/list-c cookie.txt把登录后返回的 Cookie 写入本地文件-b cookie.txt在请求业务接口时把 Cookie 带上去。如果登录返回的是 JSON 里的 token 而不是 Cookie就把 token 手动贴到-H Authorization: token值里。项目列表接口返回 200 并且带出 JSON 数据整套源码的后端链路就算验证通过了。这个习惯在二次开发时特别值钱它把“代码能不能跑”和“业务对不对”拆成两件事改完代码先用 curl 冒烟不要每次都开浏览器点半天。验证通过之后再谈加功能。比如要给 PMS 加一个“项目归档”操作动手之前先确认三件事第一project 表里有没有 status 字段归档就是把这个字段从 1 改成 2第二项目列表查询接口的 SQL 里是否已经对 status 做了默认过滤不然归档后的项目还会出现在列表里等于白做第三归档操作的接口有没有权限校验归档是不可逆动作按住 Ctrl 就想加接口的做法容易留下权限漏洞。我见过太多人拿到源码第一件事就是改登录页样式结果折腾一上午发现后端还没跑起来。从那以后我每次拿到管理类源码都强制自己先走一遍“环境自检 → 建库 → 打包 → curl 最小链路”这个流程确认地基是好的再往上面加业务。这套流程花不了半小时但能帮你把数据库、缓存、端口这些最容易翻车的问题一次性排干净。希望帮到你也祝你跑得顺利。本文还有配套的精品资源点击获取