简介这是一套面向高校教师、科研管理人员及计算机专业学生的教师科研管理系统源码与配套文档基于C#与WinForms开发可用于课程设计、毕业设计或实际科研管理场景的二次开发。资源包共91个文件约1.38MB以34个cs源代码文件、14个resources与14个resx资源文件为核心辅以config配置、sql数据库脚本、docx设计文档及少量图片与可执行文件完整覆盖项目源码、界面资源与数据库设计说明。系统围绕科研项目管理、成果录入与分类统计、教学资料共享、科研绩效量化评估等模块展开并可与教务、人事系统对接具备操作简便、数据加密、个性化定制与数据分析等特点。目前已有1583人学习下载读者可从中获取完整的项目结构、数据库设计文档与源代码实现便于理解WinForms应用的分层组织、资源管理与数据交互方式适合作为学习参考或在此基础上进行功能扩展与优化。1. 教师科研管理系统从课题申报到成果归档一套能跑通的协作底座如果你带过课题组大概率经历过这种场面申报书在微信群里传了七八版最后谁手里的是终稿没人说得清中期检查要填经费使用表翻遍邮箱找三年前的报销单结题时成果附件散在三个网盘里学生毕业一走资料就断了线。这套教师科研管理系统就是冲着这些具体麻烦来的——它把课题申报、立项、中期、结题、经费、成果、成员协作这几件事收进一个后台让科研管理从“人肉对账”变成“流程驱动”。它适合高校教研室、课题组、科研秘书这类需要多人协同又缺乏定制系统的场景也适合想拿一个真实业务练手全栈开发的工程师。下面我按“能干什么、怎么跑、怎么改”的顺序把这份源码拆开讲。2. 技术选型与目录结构先看清骨架再动手2.1 前后端分离的典型分层这套系统采用前后端分离架构后端负责业务逻辑与数据持久化前端负责页面渲染与交互。后端常见做法是 Spring Boot MyBatis-Plus数据库用 MySQL 8.0缓存层用 Redis 存登录态和字典数据前端用 Vue 3 Element Plus构建工具 Vite请求库 Axios。选这套组合的原因很直接课题组里往往有 Java 基础的人多Spring 生态资料全出问题好查Vue 3 的组合式 API 对新手友好Element Plus 的表格和表单组件能省掉大量重复样式工作。权限模型采用 RBAC角色分三类管理员管用户、管字典、管全局配置、科研秘书管课题流程流转、管成果审核、教师申报课题、填中期、传成果。接口鉴权用 JWTtoken 放在请求头里后端拦截器统一校验。这种设计的好处是后续加角色不用改表结构只加角色和权限的关联记录即可。2.2 目录结构逐层说明拿到源码后先别急着跑花十分钟把目录过一遍后面改代码能少走弯路。下面是后端和前端的主要目录teacher-research-system/ ├── backend/ │ ├── src/main/java/com/research/ │ │ ├── controller/ # 接口层按模块分ProjectController、FundController 等 │ │ ├── service/ # 业务层接口与实现分离 │ │ ├── mapper/ # MyBatis-Plus 的 Mapper 接口 │ │ ├── entity/ # 数据库实体与表一一对应 │ │ ├── dto/ # 入参对象避免直接用 entity 接参 │ │ ├── vo/ # 出参对象控制返回字段 │ │ ├── config/ # 拦截器、跨域、Redis 序列化配置 │ │ └── common/ # 统一返回体、异常处理、常量 │ └── src/main/resources/ │ ├── application.yml # 数据源、Redis、JWT 密钥配置 │ └── mapper/ # 复杂 SQL 的 XML 文件 ├── frontend/ │ ├── src/ │ │ ├── api/ # 按模块封装的请求函数 │ │ ├── views/ # 页面project、fund、achievement、user │ │ ├── router/ # 路由与权限守卫 │ │ ├── store/ # Pinia 状态管理存用户信息和字典 │ │ └── utils/ # 请求拦截、日期格式化、权限判断 │ └── vite.config.js # 代理配置开发时指向后端端口 └── sql/ └── init.sql # 建表语句与初始字典数据controller层只做参数校验和调用 service不写业务逻辑service层才是核心事务注解加在这一层mapper层用 MyBatis-Plus 的BaseMapper提供基础增删改查复杂统计走 XML。前端api目录按模块拆文件一个模块一个 js 文件方便定位。store里存字典数据是为了避免每个页面都请求一次下拉选项登录后拉一次全局复用。2.3 数据库表设计的关键几张表设计直接决定后面改起来顺不顺。核心表有sys_user用户、sys_role角色、sys_user_role关联、research_project课题主表、project_member课题成员、project_fund经费记录、project_achievement成果、project_process流程节点记录。课题主表里用status字段标记当前阶段取值如DRAFT、SUBMITTED、APPROVED、MID_TERM、CLOSED流程流转就是改这个字段并往project_process插一条记录。提示project_process表建议加operator_id和operate_time后期查“谁在什么时候把状态改成了什么”全靠它这是流程类系统的后悔药。3. 本地跑起来从建库到登录的完整步骤3.1 环境准备与建库先把依赖装齐JDK 17、Maven 3.8、MySQL 8.0、Redis 6、Node 18。MySQL 建一个库字符集用utf8mb4然后执行sql/init.sql。这个脚本里除了建表还会插入一个默认管理员账号和基础字典课题类型、经费科目、成果类型。执行完检查一下sys_user表有没有数据没有的话说明脚本没跑完看报错行。# 建库并导入初始化脚本 mysql -u root -p -e CREATE DATABASE research_db DEFAULT CHARACTER SET utf8mb4; mysql -u root -p research_db sql/init.sql # 启动 Redis默认端口 6379 redis-server建库时容易翻车的地方是字符集如果库建成latin1后面存中文课题名会变问号。导入脚本前先确认SHOW VARIABLES LIKE character_set_database;返回utf8mb4。3.2 后端配置与启动打开backend/src/main/resources/application.yml改三处数据库连接、Redis 地址、JWT 密钥。JWT 密钥别用默认值随便换一串长字符串否则 token 能被伪造。spring: datasource: url: jdbc:mysql://localhost:3306/research_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 redis: host: localhost port: 6379 database: 0 jwt: secret: 换成一串足够长的随机字符串 expire: 7200 # token 有效期单位秒配置改完在backend目录执行mvn spring-boot:run。启动日志里看到Started ResearchApplication就说明后端起来了默认端口 8080。如果报Access denied for user检查数据库密码如果报 Redis 连接超时确认 Redis 是否真的在跑。3.3 前端启动与联调前端在frontend目录先npm install再npm run dev。Vite 默认起在 5173 端口vite.config.js里配了代理把/api开头的请求转发到http://localhost:8080所以开发时不存在跨域问题。// vite.config.js 代理配置片段 server: { port: 5173, proxy: { /api: { target: http://localhost:8080, // 后端地址 changeOrigin: true, rewrite: (path) path.replace(/^\/api/, ) // 去掉前缀再转发 } } }浏览器打开http://localhost:5173用初始化脚本里的管理员账号登录。登录成功后前端会把 token 存进 localStorage并在 Axios 请求拦截器里自动带上。如果登录后页面空白按 F12 看控制台有没有 401有的话说明 token 没存上或后端校验失败检查utils/request.js里的请求头字段名和后端拦截器读的字段名是否一致。3.4 跑通一条完整业务流登录后按这个顺序点一遍能验证系统是否正常新建课题填名称、类型、起止时间→ 添加成员 → 提交申报 → 用管理员账号审批通过 → 录入一笔经费 → 上传一个成果附件 → 走结题。每一步都对应后端一个接口走完一遍基本能确认数据库读写、文件上传、状态流转都没问题。文件上传默认存本地磁盘路径在application.yml里配生产环境建议换成对象存储这个后面改造章节会讲。4. 核心模块拆解课题状态流转与经费统计怎么实现的4.1 课题状态流转的代码链路课题状态流转是这套系统的骨架。前端点“提交申报”请求打到ProjectController的submit接口service 层先校验当前状态是不是DRAFT是才允许改成SUBMITTED同时往流程表插记录。核心代码如下// ProjectServiceImpl.java 状态流转核心逻辑 Transactional(rollbackFor Exception.class) public void changeStatus(Long projectId, String targetStatus, Long operatorId) { ResearchProject project projectMapper.selectById(projectId); if (project null) { throw new BizException(课题不存在); } // 校验状态流转是否合法避免跳步 if (!StatusFlow.canTransfer(project.getStatus(), targetStatus)) { throw new BizException(当前状态不允许此操作); } project.setStatus(targetStatus); project.setUpdateTime(LocalDateTime.now()); projectMapper.updateById(project); // 记录流转日志谁在什么时候改成了什么 ProjectProcess process new ProjectProcess(); process.setProjectId(projectId); process.setFromStatus(project.getStatus()); process.setToStatus(targetStatus); process.setOperatorId(operatorId); process.setOperateTime(LocalDateTime.now()); processMapper.insert(process); }StatusFlow.canTransfer是一个静态工具类内部用 Map 维护合法流转关系比如DRAFT只能到SUBMITTEDSUBMITTED只能到APPROVED或REJECTED。这样写的好处是流转规则集中在一处加新状态只改这个 Map。Transactional保证改状态和插日志要么都成功要么都回滚不会出现状态改了但日志没记的情况。参数operatorId从当前登录用户里取不要从前端传否则能被篡改。4.2 经费统计的 SQL 与缓存策略经费模块要按课题汇总已用金额、剩余额度还要按经费科目分类统计。这种统计用 MyBatis-Plus 的 wrapper 写起来别扭直接上 XML 更清晰!-- ProjectFundMapper.xml 按课题汇总经费 -- select idsumByProject resultTypecom.research.vo.FundSummaryVO SELECT f.project_id AS projectId, f.category AS category, SUM(f.amount) AS totalAmount, p.budget AS budget FROM project_fund f LEFT JOIN research_project p ON f.project_id p.id WHERE f.project_id #{projectId} AND f.deleted 0 GROUP BY f.project_id, f.category, p.budget /select这里用LEFT JOIN是为了即使某科目还没报销记录也能带出课题总预算。deleted 0是逻辑删除标记所有查询都要带上否则会把删掉的记录算进去。统计结果变化不频繁可以在 service 层加一层 Redis 缓存key 用fund:summary:{projectId}报销或删除时主动删 key。缓存过期时间设 10 分钟避免数据不一致太久。4.3 成果附件上传与校验成果模块涉及文件上传后端用MultipartFile接收存到本地磁盘后把相对路径写进数据库。关键点是校验文件类型和大小别让用户传个 exe 上来。// AchievementServiceImpl.java 文件上传片段 public String uploadFile(MultipartFile file, Long projectId) { // 限制大小 20MB if (file.getSize() 20 * 1024 * 1024) { throw new BizException(文件不能超过20MB); } String originalName file.getOriginalFilename(); String suffix originalName.substring(originalName.lastIndexOf(.) 1).toLowerCase(); // 白名单校验只允许常见文档和图片 ListString allow Arrays.asList(pdf, doc, docx, xls, xlsx, png, jpg); if (!allow.contains(suffix)) { throw new BizException(不支持的文件类型); } // 用 UUID 重命名避免同名覆盖和路径穿越 String storeName UUID.randomUUID() . suffix; Path target Paths.get(uploadDir, storeName); Files.createDirectories(target.getParent()); file.transferTo(target); return storeName; }用 UUID 重命名是为了防止两个老师传同名文件互相覆盖也避免原始文件名里带../造成路径穿越。uploadDir从配置读不要硬编码。返回的storeName存进数据库下载时再拼回完整路径。如果后期要换对象存储只需要改这个方法的存储部分数据库里存的字段不用动。5. 避坑与常见问题跑不起来时先查这几处5.1 登录后立刻掉线接口返回 401现象是刚登录成功点第一个菜单就跳回登录页。原因通常是 JWT 过期时间设得太短或者 Redis 里存的 token 被覆盖。检查application.yml里jwt.expire是不是小于 60 秒再确认 Redis 的database编号和后端配置一致。如果多个环境共用 Rediskey 前缀要区分开否则测试环境登录会把生产环境的 token 顶掉。5.2 中文课题名存进数据库变问号现象是新建课题时名称显示正常保存后列表里变成???。原因是数据库连接串没加characterEncodingutf8或者建库时字符集不是utf8mb4。解决方法是改连接串加上编码参数并执行ALTER DATABASE research_db CHARACTER SET utf8mb4;。已经存进去的乱码数据改不回来只能删掉重录。5.3 文件上传成功但下载 404现象是上传提示成功点下载报 404。原因是上传目录和下载读取目录不一致或者 Nginx 没配静态资源映射。检查application.yml里的upload-dir配置确认上传和下载用的是同一个值。如果用了 Nginx要在配置里加location /files/ { alias /实际路径/; }并确保路径末尾斜杠一致少一个斜杠就会 404。5.4 经费统计数字对不上现象是列表里显示的已用金额和明细加起来不一致。原因通常是查询没带deleted 0把逻辑删除的记录也算进去了或者缓存没及时清改了数据但页面还是旧值。排查时先直接查数据库核对再检查 service 层有没有在增删改后删缓存。我一般会在报销和删除方法末尾统一调一次redisTemplate.delete(key)宁可多删一次也别让用户看到脏数据。5.5 前端打包后刷新页面 404现象是npm run build后部署首页能打开刷新子路由就 404。原因是前端路由用了 history 模式服务器没配 fallback。解决方法是 Nginx 里加try_files $uri $uri/ /index.html;让所有找不到的路径都回退到首页由前端路由接管。这个坑几乎每个用 Vue Router history 模式的项目都会踩一次。6. 二次开发改造从单机文件到对象存储再到流程可配置这套系统跑通之后最值得动手改的有三个方向。第一个是文件存储本地磁盘只适合开发环境生产环境多实例部署时文件不共享用户上传后换个节点就下载不到。改造思路是把AchievementServiceImpl里的存储逻辑抽成接口定义FileStorage接口提供store和load两个方法本地实现和对象存储实现各写一个类用ConditionalOnProperty按配置切换。这样改完数据库里存的storeName不用动只换实现类。第二个方向是流程可配置。现在状态流转规则写死在StatusFlow的 Map 里加一个“延期申请”节点就得改代码重新发版。可以把流转规则挪到数据库建一张flow_config表字段包括from_status、to_status、role、need_approval启动时加载进内存canTransfer改成查这张表。这样科研秘书在后台就能配流程不用找开发。改造时注意加缓存和刷新接口配置改了要能热加载。第三个方向是统计报表导出。现在经费和成果统计只有页面展示结题时往往要导 Excel。可以用 EasyExcel 写一个导出接口把FundSummaryVO列表直接写进响应流。关键点是设置Content-Disposition响应头文件名用 URL 编码否则中文文件名在部分浏览器会乱码。// 导出经费统计的接口片段 GetMapping(/fund/export/{projectId}) public void exportFund(PathVariable Long projectId, HttpServletResponse response) throws IOException { ListFundSummaryVO list fundService.sumByProject(projectId); response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); // 文件名 URL 编码避免中文乱码 String fileName URLEncoder.encode(经费统计, UTF-8).replaceAll(\\, %20); response.setHeader(Content-Disposition, attachment;filename*utf-8 fileName .xlsx); EasyExcel.write(response.getOutputStream(), FundSummaryVO.class).sheet(经费).doWrite(list); }改造完记得回归测试换存储实现后老数据能不能下载流程配置改了非法流转能不能拦住导出文件在 Chrome 和 Edge 里文件名是否正常。我一般改完一个模块就跑一遍第 3.4 节那条完整业务流确认没把主链路弄断。从那以后我每次动核心模块都强制走一遍“新建课题到结题”的全流程宁可多花二十分钟也不想上线后被老师追着问为什么提交不了。希望这套拆解能帮你少走点弯路顺利把系统跑起来、改下去。本文还有配套的精品资源点击获取
简介这是一套面向高校教师、科研管理人员及计算机专业学生的教师科研管理系统源码与配套文档基于C#与WinForms开发可用于课程设计、毕业设计或实际科研管理场景的二次开发。资源包共91个文件约1.38MB以34个cs源代码文件、14个resources与14个resx资源文件为核心辅以config配置、sql数据库脚本、docx设计文档及少量图片与可执行文件完整覆盖项目源码、界面资源与数据库设计说明。系统围绕科研项目管理、成果录入与分类统计、教学资料共享、科研绩效量化评估等模块展开并可与教务、人事系统对接具备操作简便、数据加密、个性化定制与数据分析等特点。目前已有1583人学习下载读者可从中获取完整的项目结构、数据库设计文档与源代码实现便于理解WinForms应用的分层组织、资源管理与数据交互方式适合作为学习参考或在此基础上进行功能扩展与优化。1. 教师科研管理系统从课题申报到成果归档一套能跑通的协作底座如果你带过课题组大概率经历过这种场面申报书在微信群里传了七八版最后谁手里的是终稿没人说得清中期检查要填经费使用表翻遍邮箱找三年前的报销单结题时成果附件散在三个网盘里学生毕业一走资料就断了线。这套教师科研管理系统就是冲着这些具体麻烦来的——它把课题申报、立项、中期、结题、经费、成果、成员协作这几件事收进一个后台让科研管理从“人肉对账”变成“流程驱动”。它适合高校教研室、课题组、科研秘书这类需要多人协同又缺乏定制系统的场景也适合想拿一个真实业务练手全栈开发的工程师。下面我按“能干什么、怎么跑、怎么改”的顺序把这份源码拆开讲。2. 技术选型与目录结构先看清骨架再动手2.1 前后端分离的典型分层这套系统采用前后端分离架构后端负责业务逻辑与数据持久化前端负责页面渲染与交互。后端常见做法是 Spring Boot MyBatis-Plus数据库用 MySQL 8.0缓存层用 Redis 存登录态和字典数据前端用 Vue 3 Element Plus构建工具 Vite请求库 Axios。选这套组合的原因很直接课题组里往往有 Java 基础的人多Spring 生态资料全出问题好查Vue 3 的组合式 API 对新手友好Element Plus 的表格和表单组件能省掉大量重复样式工作。权限模型采用 RBAC角色分三类管理员管用户、管字典、管全局配置、科研秘书管课题流程流转、管成果审核、教师申报课题、填中期、传成果。接口鉴权用 JWTtoken 放在请求头里后端拦截器统一校验。这种设计的好处是后续加角色不用改表结构只加角色和权限的关联记录即可。2.2 目录结构逐层说明拿到源码后先别急着跑花十分钟把目录过一遍后面改代码能少走弯路。下面是后端和前端的主要目录teacher-research-system/ ├── backend/ │ ├── src/main/java/com/research/ │ │ ├── controller/ # 接口层按模块分ProjectController、FundController 等 │ │ ├── service/ # 业务层接口与实现分离 │ │ ├── mapper/ # MyBatis-Plus 的 Mapper 接口 │ │ ├── entity/ # 数据库实体与表一一对应 │ │ ├── dto/ # 入参对象避免直接用 entity 接参 │ │ ├── vo/ # 出参对象控制返回字段 │ │ ├── config/ # 拦截器、跨域、Redis 序列化配置 │ │ └── common/ # 统一返回体、异常处理、常量 │ └── src/main/resources/ │ ├── application.yml # 数据源、Redis、JWT 密钥配置 │ └── mapper/ # 复杂 SQL 的 XML 文件 ├── frontend/ │ ├── src/ │ │ ├── api/ # 按模块封装的请求函数 │ │ ├── views/ # 页面project、fund、achievement、user │ │ ├── router/ # 路由与权限守卫 │ │ ├── store/ # Pinia 状态管理存用户信息和字典 │ │ └── utils/ # 请求拦截、日期格式化、权限判断 │ └── vite.config.js # 代理配置开发时指向后端端口 └── sql/ └── init.sql # 建表语句与初始字典数据controller层只做参数校验和调用 service不写业务逻辑service层才是核心事务注解加在这一层mapper层用 MyBatis-Plus 的BaseMapper提供基础增删改查复杂统计走 XML。前端api目录按模块拆文件一个模块一个 js 文件方便定位。store里存字典数据是为了避免每个页面都请求一次下拉选项登录后拉一次全局复用。2.3 数据库表设计的关键几张表设计直接决定后面改起来顺不顺。核心表有sys_user用户、sys_role角色、sys_user_role关联、research_project课题主表、project_member课题成员、project_fund经费记录、project_achievement成果、project_process流程节点记录。课题主表里用status字段标记当前阶段取值如DRAFT、SUBMITTED、APPROVED、MID_TERM、CLOSED流程流转就是改这个字段并往project_process插一条记录。提示project_process表建议加operator_id和operate_time后期查“谁在什么时候把状态改成了什么”全靠它这是流程类系统的后悔药。3. 本地跑起来从建库到登录的完整步骤3.1 环境准备与建库先把依赖装齐JDK 17、Maven 3.8、MySQL 8.0、Redis 6、Node 18。MySQL 建一个库字符集用utf8mb4然后执行sql/init.sql。这个脚本里除了建表还会插入一个默认管理员账号和基础字典课题类型、经费科目、成果类型。执行完检查一下sys_user表有没有数据没有的话说明脚本没跑完看报错行。# 建库并导入初始化脚本 mysql -u root -p -e CREATE DATABASE research_db DEFAULT CHARACTER SET utf8mb4; mysql -u root -p research_db sql/init.sql # 启动 Redis默认端口 6379 redis-server建库时容易翻车的地方是字符集如果库建成latin1后面存中文课题名会变问号。导入脚本前先确认SHOW VARIABLES LIKE character_set_database;返回utf8mb4。3.2 后端配置与启动打开backend/src/main/resources/application.yml改三处数据库连接、Redis 地址、JWT 密钥。JWT 密钥别用默认值随便换一串长字符串否则 token 能被伪造。spring: datasource: url: jdbc:mysql://localhost:3306/research_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 redis: host: localhost port: 6379 database: 0 jwt: secret: 换成一串足够长的随机字符串 expire: 7200 # token 有效期单位秒配置改完在backend目录执行mvn spring-boot:run。启动日志里看到Started ResearchApplication就说明后端起来了默认端口 8080。如果报Access denied for user检查数据库密码如果报 Redis 连接超时确认 Redis 是否真的在跑。3.3 前端启动与联调前端在frontend目录先npm install再npm run dev。Vite 默认起在 5173 端口vite.config.js里配了代理把/api开头的请求转发到http://localhost:8080所以开发时不存在跨域问题。// vite.config.js 代理配置片段 server: { port: 5173, proxy: { /api: { target: http://localhost:8080, // 后端地址 changeOrigin: true, rewrite: (path) path.replace(/^\/api/, ) // 去掉前缀再转发 } } }浏览器打开http://localhost:5173用初始化脚本里的管理员账号登录。登录成功后前端会把 token 存进 localStorage并在 Axios 请求拦截器里自动带上。如果登录后页面空白按 F12 看控制台有没有 401有的话说明 token 没存上或后端校验失败检查utils/request.js里的请求头字段名和后端拦截器读的字段名是否一致。3.4 跑通一条完整业务流登录后按这个顺序点一遍能验证系统是否正常新建课题填名称、类型、起止时间→ 添加成员 → 提交申报 → 用管理员账号审批通过 → 录入一笔经费 → 上传一个成果附件 → 走结题。每一步都对应后端一个接口走完一遍基本能确认数据库读写、文件上传、状态流转都没问题。文件上传默认存本地磁盘路径在application.yml里配生产环境建议换成对象存储这个后面改造章节会讲。4. 核心模块拆解课题状态流转与经费统计怎么实现的4.1 课题状态流转的代码链路课题状态流转是这套系统的骨架。前端点“提交申报”请求打到ProjectController的submit接口service 层先校验当前状态是不是DRAFT是才允许改成SUBMITTED同时往流程表插记录。核心代码如下// ProjectServiceImpl.java 状态流转核心逻辑 Transactional(rollbackFor Exception.class) public void changeStatus(Long projectId, String targetStatus, Long operatorId) { ResearchProject project projectMapper.selectById(projectId); if (project null) { throw new BizException(课题不存在); } // 校验状态流转是否合法避免跳步 if (!StatusFlow.canTransfer(project.getStatus(), targetStatus)) { throw new BizException(当前状态不允许此操作); } project.setStatus(targetStatus); project.setUpdateTime(LocalDateTime.now()); projectMapper.updateById(project); // 记录流转日志谁在什么时候改成了什么 ProjectProcess process new ProjectProcess(); process.setProjectId(projectId); process.setFromStatus(project.getStatus()); process.setToStatus(targetStatus); process.setOperatorId(operatorId); process.setOperateTime(LocalDateTime.now()); processMapper.insert(process); }StatusFlow.canTransfer是一个静态工具类内部用 Map 维护合法流转关系比如DRAFT只能到SUBMITTEDSUBMITTED只能到APPROVED或REJECTED。这样写的好处是流转规则集中在一处加新状态只改这个 Map。Transactional保证改状态和插日志要么都成功要么都回滚不会出现状态改了但日志没记的情况。参数operatorId从当前登录用户里取不要从前端传否则能被篡改。4.2 经费统计的 SQL 与缓存策略经费模块要按课题汇总已用金额、剩余额度还要按经费科目分类统计。这种统计用 MyBatis-Plus 的 wrapper 写起来别扭直接上 XML 更清晰!-- ProjectFundMapper.xml 按课题汇总经费 -- select idsumByProject resultTypecom.research.vo.FundSummaryVO SELECT f.project_id AS projectId, f.category AS category, SUM(f.amount) AS totalAmount, p.budget AS budget FROM project_fund f LEFT JOIN research_project p ON f.project_id p.id WHERE f.project_id #{projectId} AND f.deleted 0 GROUP BY f.project_id, f.category, p.budget /select这里用LEFT JOIN是为了即使某科目还没报销记录也能带出课题总预算。deleted 0是逻辑删除标记所有查询都要带上否则会把删掉的记录算进去。统计结果变化不频繁可以在 service 层加一层 Redis 缓存key 用fund:summary:{projectId}报销或删除时主动删 key。缓存过期时间设 10 分钟避免数据不一致太久。4.3 成果附件上传与校验成果模块涉及文件上传后端用MultipartFile接收存到本地磁盘后把相对路径写进数据库。关键点是校验文件类型和大小别让用户传个 exe 上来。// AchievementServiceImpl.java 文件上传片段 public String uploadFile(MultipartFile file, Long projectId) { // 限制大小 20MB if (file.getSize() 20 * 1024 * 1024) { throw new BizException(文件不能超过20MB); } String originalName file.getOriginalFilename(); String suffix originalName.substring(originalName.lastIndexOf(.) 1).toLowerCase(); // 白名单校验只允许常见文档和图片 ListString allow Arrays.asList(pdf, doc, docx, xls, xlsx, png, jpg); if (!allow.contains(suffix)) { throw new BizException(不支持的文件类型); } // 用 UUID 重命名避免同名覆盖和路径穿越 String storeName UUID.randomUUID() . suffix; Path target Paths.get(uploadDir, storeName); Files.createDirectories(target.getParent()); file.transferTo(target); return storeName; }用 UUID 重命名是为了防止两个老师传同名文件互相覆盖也避免原始文件名里带../造成路径穿越。uploadDir从配置读不要硬编码。返回的storeName存进数据库下载时再拼回完整路径。如果后期要换对象存储只需要改这个方法的存储部分数据库里存的字段不用动。5. 避坑与常见问题跑不起来时先查这几处5.1 登录后立刻掉线接口返回 401现象是刚登录成功点第一个菜单就跳回登录页。原因通常是 JWT 过期时间设得太短或者 Redis 里存的 token 被覆盖。检查application.yml里jwt.expire是不是小于 60 秒再确认 Redis 的database编号和后端配置一致。如果多个环境共用 Rediskey 前缀要区分开否则测试环境登录会把生产环境的 token 顶掉。5.2 中文课题名存进数据库变问号现象是新建课题时名称显示正常保存后列表里变成???。原因是数据库连接串没加characterEncodingutf8或者建库时字符集不是utf8mb4。解决方法是改连接串加上编码参数并执行ALTER DATABASE research_db CHARACTER SET utf8mb4;。已经存进去的乱码数据改不回来只能删掉重录。5.3 文件上传成功但下载 404现象是上传提示成功点下载报 404。原因是上传目录和下载读取目录不一致或者 Nginx 没配静态资源映射。检查application.yml里的upload-dir配置确认上传和下载用的是同一个值。如果用了 Nginx要在配置里加location /files/ { alias /实际路径/; }并确保路径末尾斜杠一致少一个斜杠就会 404。5.4 经费统计数字对不上现象是列表里显示的已用金额和明细加起来不一致。原因通常是查询没带deleted 0把逻辑删除的记录也算进去了或者缓存没及时清改了数据但页面还是旧值。排查时先直接查数据库核对再检查 service 层有没有在增删改后删缓存。我一般会在报销和删除方法末尾统一调一次redisTemplate.delete(key)宁可多删一次也别让用户看到脏数据。5.5 前端打包后刷新页面 404现象是npm run build后部署首页能打开刷新子路由就 404。原因是前端路由用了 history 模式服务器没配 fallback。解决方法是 Nginx 里加try_files $uri $uri/ /index.html;让所有找不到的路径都回退到首页由前端路由接管。这个坑几乎每个用 Vue Router history 模式的项目都会踩一次。6. 二次开发改造从单机文件到对象存储再到流程可配置这套系统跑通之后最值得动手改的有三个方向。第一个是文件存储本地磁盘只适合开发环境生产环境多实例部署时文件不共享用户上传后换个节点就下载不到。改造思路是把AchievementServiceImpl里的存储逻辑抽成接口定义FileStorage接口提供store和load两个方法本地实现和对象存储实现各写一个类用ConditionalOnProperty按配置切换。这样改完数据库里存的storeName不用动只换实现类。第二个方向是流程可配置。现在状态流转规则写死在StatusFlow的 Map 里加一个“延期申请”节点就得改代码重新发版。可以把流转规则挪到数据库建一张flow_config表字段包括from_status、to_status、role、need_approval启动时加载进内存canTransfer改成查这张表。这样科研秘书在后台就能配流程不用找开发。改造时注意加缓存和刷新接口配置改了要能热加载。第三个方向是统计报表导出。现在经费和成果统计只有页面展示结题时往往要导 Excel。可以用 EasyExcel 写一个导出接口把FundSummaryVO列表直接写进响应流。关键点是设置Content-Disposition响应头文件名用 URL 编码否则中文文件名在部分浏览器会乱码。// 导出经费统计的接口片段 GetMapping(/fund/export/{projectId}) public void exportFund(PathVariable Long projectId, HttpServletResponse response) throws IOException { ListFundSummaryVO list fundService.sumByProject(projectId); response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); // 文件名 URL 编码避免中文乱码 String fileName URLEncoder.encode(经费统计, UTF-8).replaceAll(\\, %20); response.setHeader(Content-Disposition, attachment;filename*utf-8 fileName .xlsx); EasyExcel.write(response.getOutputStream(), FundSummaryVO.class).sheet(经费).doWrite(list); }改造完记得回归测试换存储实现后老数据能不能下载流程配置改了非法流转能不能拦住导出文件在 Chrome 和 Edge 里文件名是否正常。我一般改完一个模块就跑一遍第 3.4 节那条完整业务流确认没把主链路弄断。从那以后我每次动核心模块都强制走一遍“新建课题到结题”的全流程宁可多花二十分钟也不想上线后被老师追着问为什么提交不了。希望这套拆解能帮你少走点弯路顺利把系统跑起来、改下去。本文还有配套的精品资源点击获取
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
