Spring Boot+Vue实现教师科研管理系统：申报审批与作业任务一体化

简介：教师科研管理系统完整源码与设计资料，面向需要完成课程作业或进行系统开发练习的计算机专业学生。系统涵盖科研项目申报、立项、成果录入与统计、资源共享等功能，并配有量化评估模块，能帮助教师从繁琐事务中解脱，同时也为管理者提供科研绩效数据支持。压缩包共九十一个文件，大小约一点三八兆字节，以C#源代码、界面资源及配置文件为主，另含SQL数据库脚本、项目解决方案与两个Word说明文档，分别介绍系统源码与数据库设计，便于对照理解整体架构与业务流程。源代码工程已覆盖项目申报、成果录入、资源共享及量化评估等核心模块。已有1582人学习下载，适合作为课程设计或毕业设计的参考基础，也可为快速搭建同类管理系统提供可复用的模块化思路。

1. 教师科研管理系统：把申报、审批、成果和科研作业归档串成一条线

在高校里，科研秘书是被报销单、申报书、结题材料和工作量统计反复捶打的人。一个项目从通知申报、教师填表、院系审核到学校审批，再到立项后的中期检查、结题和成果登记，每一步都靠微信群催、Excel 来回传，漏发一个通知就可能让整个申报窗口错过。这套教师科研管理系统，把项目申报、审批流转、成果录入、经费归集，甚至连教师给学生布置的科研作业/任务都收进同一个平台：教师一个入口提交材料，科研处一个后台跟踪进度，工作量数据自动汇总，谁在哪个环节卡壳一眼可见。它适合高校科研处、二级学院科研秘书使用，也适合每天要填八个表的教师快速完成填报。

2. 技术架构与目录结构：Spring Boot 做底、Vue 做面，角色和流程分层

2.1 技术栈选型：前后端分离，数据落库，缓存热数据

这个项目采用了很常见的前后端分离方案。后端用 Spring Boot 2.7 作为基础框架，MyBatis-Plus 操作 MySQL 8.0，Redis 缓存登录态和热点字典数据，文件上传先存本地磁盘，生产环境再换成 MinIO 或云存储。前端是 Vue 2 + Element UI，用 Vuex 管理全局状态，axios 统一发起请求。为什么这么选？因为高校科研处通常不追求极致的并发性能，但要求代码易维护、生态成熟、招人容易；这套技术栈在 CRUD 密集型管理系统里几乎是最稳的组合，网上资料多，二次开发时踩坑成本低。

登录认证没有用分布式框架，直接在网关或拦截器里解析 JWT token。原因是用例简单：校内使用，用户量几千，不需要引入 Spring Security OAuth2 这种重武器。JWT 无状态，后端不存 Session，配合 Redis 存 token 黑名单，既能控制过期又能支持强制下线。

2.2 工程目录：前端后端分开，结构清晰

拿到源码首先看目录结构，能快速判断项目入口和模块边界。最终目录如下：

research-system/ ├── backend/ │ ├── src/main/java/com/wm/research/ │ │ ├── common/ # 统一返回结果、异常处理、常量 │ │ ├── config/ # MyBatis-Plus、CORS、拦截器配置 │ │ ├── controller/ # 对外 REST 接口 │ │ ├── service/ # 业务逻辑层 │ │ ├── mapper/ # MyBatis-Plus 数据访问接口 │ │ ├── entity/ # 数据库表实体 │ │ ├── dto/ # 请求响应封装 │ │ └── utils/ # JWT、文件工具类 │ └── src/main/resources/ │ ├── mapper/ # 手写 XML SQL │ ├── application.yml # 数据源、Redis、文件路径配置 │ └── sql/init.sql # 建库建表脚本 ├── frontend/ │ ├── src/ │ │ ├── api/ # 接口请求封装 │ │ ├── assets/ # 静态资源 │ │ ├── components/ # 通用组件 │ │ ├── router/ # 路由 │ │ ├── store/ # Vuex 模块 │ │ └── views/ # 页面 │ └── package.json └── README.md

backend 和 frontend 完全独立，后端只提供 JSON API，前端通过代理转发到后端端口。common 包下的 Result 类统一包装返回结构，前端 axios 拦截器统一处理 code 和 message，这样新增接口时不用反复写 try/catch。

2.3 数据库表设计：项目、成果、用户和科研作业任务四类模型

系统有四个核心业务域：用户权限、科研项目、科研成果、科研作业任务。建表脚本里表名基本都是小写下划线命名。核心表如下：

project_info 里 status 字段存的是状态机枚举值：0 草稿、1 待院系审核、2 待科研处审核、3 已立项、4 被驳回。project_approval 负责把审批链路完整记录下来，方便追溯是谁在什么时候批的。task_info 和 task_submit 就是关键词“作业”对应的模块：教师发布科研任务或作业，学生在线上传文献综述、实验数据等文件，系统自动记录提交时间，过期后状态变为“已逾期”。

2.4 权限模型：四种角色对应三条入口

系统内置四种角色。管理员拥有全部菜单和接口权限；科研处人员能查看全校项目、成果和科研任务；学院科研秘书能审核本学院项目，可以导出统计表；普通教师能申报项目、录入成果、布置作业给名下学生。学生只出现在学科研任务体系里，配合教师布置的作业模块。权限控制分成两层：前端的菜单渲染按 role 字段动态过滤，后端在 Controller 上用自定义 @RequetRole 注解拦截非法访问。这种双层控制虽然简单，但对内部管理系统完全够用。

如果项目要加学院层次，只需在 sys_user 里增加 dept_id 字段，查询时用 dept_id 过滤即可，不需要改太多代码。

3. 本地运行：从拉代码到浏览器看到登录页

3.1 环境准备：别用太新的 JDK

这个项目依赖较老的 Spring Boot 2.x，我用的是 JDK 8 + Maven 3.6.3，前端用 Node 14.21 和 npm 6.14。如果你本地是 JDK 17，启动时大概率会遇到反射访问警告，虽然不一定报错，但为了减少玄学问题，建议装 JDK 8。MySQL 用 8.0 和 5.7 都行，Redis 用 6.x 以上版本即可，项目没有用到 Redis 的特殊数据结构。

具体环境清单：

• JDK 8（必须）
• Maven 3.6+
• Node 14 / npm 6
• MySQL 8.0
• Redis 6.x

启动前确认 MySQL 和 Redis 已经能在本机访问，否则项目虽能启动但登录接口会报缓存连接失败。

3.2 初始化数据库：直接导入 init.sql

backend/src/main/resources/sql/init.sql 里建好了库和表，并内置了测试账号。先创建数据库：

mysql -uroot -p -e "create database research_system default charset utf8mb4;" mysql -uroot -p research_system < backend/src/main/resources/sql/init.sql

然后打开 backend/src/main/resources/application.yml，修改数据源配置。关键部分如下：

spring: datasource: url: jdbc:mysql://localhost:3306/research_system?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 123456 redis: host: localhost port: 6379 servlet: multipart: max-file-size: 20MB max-request-size: 100MB custom: upload-path: /data/research-upload jwt-secret: your-secret-key

url 里必须带 serverTimezone，不然 MySQL 8 会报时区错误。upload-path 是上传文件保存的绝对路径，Windows 上改成D:/research-upload，注意目录要存在，否则上传接口直接报“系统找不到指定路径”。

3.3 启动后端：先 mvn 再确认端口

后端是标准 Maven 项目，启动方式有两种：

cd backend mvn spring-boot:run

或者先打 jar 再运行：

mvn clean package -DskipTests java -jar target/research-system-1.0.0.jar --server.port=8080

我第一次跑的时候直接用mvn spring-boot:run，日志停在“Started Application in 12.3 seconds”，说明启动成功。后端默认端口 8080，如果被占用就去 application.yml 改 server.port。

3.4 启动前端：npm install 才是第一道坎

前端在 frontend 目录下，启动命令很常规：

cd frontend npm install npm run dev

npm install 在这类项目里经常卡住，如果下载慢就换成淘宝镜像源先拉依赖。启动成功后控制台会提示http://localhost:8081。前端 Dev 服务的端口是 8081，接口请求通过 vue.config.js 里的 proxy 转发到 8080，跨域问题已经被代理解决。

3.5 验证核心链路：登录后走一遍申报和作业流程

浏览器打开http://localhost:8081，用 init.sql 里预设的管理员账号登录。登录后左侧菜单能看到项目管理、成果管理、任务管理、系统管理。可以先用管理员创建一个院系科研秘书账号，再去“项目申报”里发起一条新申请，上传一份 PDF 附件，然后退出用科研秘书账号登录审核，走一遍“提交—审核—通过”的流程。紧接着去“科研作业”模块发布一个“提交文献综述”的任务，用学生账号登录提交附件。如果这一步通了，说明前后端、数据库、文件存储四个环节全部正常。

4. 核心模块拆解：一个项目申报从进入到返回的完整链路

4.1 JWT 登录认证：拦截器里做的事

后端没有用 Spring Security，而是自己写了一个登录过滤器。每次请求都会经过JwtInterceptor，它从请求头取 token，解析后把用户信息放进 ThreadLocal。核心代码如下：

public class JwtInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (request.getMethod().equals("OPTIONS")) { return true; } String token = request.getHeader("Authorization"); if (StringUtils.isBlank(token)) { throw new BizException(401, "未登录"); } // 解析 JWT，先从 Redis 黑名单判断 token 是否被强制失效 if (redisUtil.hasKey("black:" + token)) { throw new BizException(401, "登录已过期，请重新登录"); } JwtUtil.checkToken(token); Long userId = JwtUtil.getUserId(token); // 存入 ThreadLocal，后续 Controller 直接用 UserContext.set(userId); return true; } }

这段代码最容易被忽略的是 OPTIONS 放行。前端跨域请求时会先发一个预检请求，如果拦截器在这里不放行，ajax 就会报 401。token 解析用 JwtUtil，里面包含签名算法和过期时间，我一般把 token 有效期设成 2 小时，用户活跃时通过接口续期，避免太久不操作被踢下线。

4.2 项目申报提交：Controller 收参数，Service 里做校验和落库

教师在“项目申报”页面上填完表单后，前端调POST /api/project/apply。后端 Controller 只做参数接收，业务处理都在 Service：

@PostMapping("/apply") public Result<?> apply(@Valid @RequestBody ProjectApplyRequest req) { // 校验同一教师不能同时申报两个同类型项目 long count = projectService.lambdaQuery() .eq(ProjectInfo::getLeaderId, UserContext.getUserId()) .eq(ProjectInfo::getType, req.getType()) .in(ProjectInfo::getStatus, 0, 1, 2, 3) .count(); if (count > 0) { return Result.fail("已有相同类型的在途项目，不能重复申报"); } ProjectInfo info = new ProjectInfo(); BeanUtils.copyProperties(req, info); info.setStatus(ProjectStatus.DRAFT.getValue()); info.setApplyTime(LocalDateTime.now()); projectService.save(info); return Result.ok(info.getId()); }

这里有一个很实际的设计：状态为草稿的项目保存后不直接进入审核流，要等教师点“提交”按钮才会把 status 从 0 改成 1。因为教师填申报书往往不是一口气完成的，中途保存一次退出再回来很常见。ProjectApplyRequest里包含 projectName、projectType、funds、summary、attachmentUrls 等字段，前端传入的文件是先用另一个上传接口拿到的 URL，这里只存路径字符串。注意校验逻辑是查“在途项目”，已驳回的可以重新编辑提交，不算在途。

4.3 审批流程状态机：每个操作都写一张流水表

审批是项目管理系统里最容易踩坑的地方。这个实现没有引入 Activiti 工作流，而是用一个状态字段叠加审批记录表。审批接口接收 action 参数，0 表示驳回，1 表示通过：

@Transactional public void approve(Long projectId, Integer action, String comment) { ProjectInfo info = projectService.getById(projectId); Integer curStatus = info.getStatus(); int nextStatus; if (action == 0) { nextStatus = ProjectStatus.REJECTED.getValue(); } else if (curStatus == ProjectStatus.DEPT_CHECK.getValue()) { nextStatus = ProjectStatus.SCHOOL_CHECK.getValue(); } else if (curStatus == ProjectStatus.SCHOOL_CHECK.getValue()) { nextStatus = ProjectStatus.APPROVED.getValue(); } else { throw new BizException("当前状态不可审批"); } // 更新项目状态 projectService.lambdaUpdate() .eq(ProjectInfo::getId, projectId) .set(ProjectInfo::getStatus, nextStatus) .set(ProjectInfo::getUpdateTime, LocalDateTime.now()) .update(); // 写入审批流水 ProjectApproval approval = new ProjectApproval(); approval.setProjectId(projectId); approval.setApproverId(UserContext.getUserId()); approval.setAction(action); approval.setComment(comment); approval.setCreateTime(LocalDateTime.now()); approvalService.save(approval); }

这里的关键点是@Transactional：状态更新和审批流水必须成对成功或成对失败，否则会出现项目状态已经变成已立项但审批记录缺失的脏数据。我踩过这坑，后来统一在审批 Service 方法上加了事务，涉及状态变化的操作全部走一个入口，不允许 Controller 里直接改状态。

4.4 科研作业任务提交：教师发布、学生上传、逾期自动标记

关键词“作业”在这个系统体现为 task_info 和 task_submit 两张表联动的功能。教师端发布任务：

@PostMapping("/api/task/publish") public Result<?> publish(@RequestBody TaskPublishRequest req) { TaskInfo task = new TaskInfo(); task.setTitle(req.getTitle()); task.setContent(req.getContent()); task.setTeacherId(UserContext.getUserId()); task.setDeadline(req.getDeadline()); task.setStatus(1); taskService.save(task); return Result.ok(); }

学生端通过任务 ID 提交作业，提交接口接收文件路径和任务 ID，如果提交时间超过 deadline，系统仍然接受文件，但 status 会自动标记为 2（逾期）：

@PostMapping("/api/task/submit") public Result<?> submit(@RequestParam Long taskId, @RequestParam String fileUrl, @RequestParam(required = false) String remark) { TaskInfo task = taskService.getById(taskId); TaskSubmit submit = new TaskSubmit(); submit.setTaskId(taskId); submit.setStudentId(UserContext.getUserId()); submit.setSubmitFile(fileUrl); submit.setRemark(remark); submit.setSubmitTime(LocalDateTime.now()); if (task.getDeadline().isBefore(LocalDateTime.now())) { submit.setStatus(2); } else { submit.setStatus(1); } taskSubmitService.save(submit); return Result.ok(); }

这里的参数 fileUrl 是之前上传接口返回的路径，比如/upload/2025/xx.pdf。前端预览时直接拼接文件访问前缀，后端拦截/upload/**路径映射到本地磁盘目录。如果想让任务支持多次提交，可以在 submit 表加 version 字段，不过当前版本是“一任务一人一条”的简单约束。

4.5 成果统计报表：一条连表查询汇总工作量

科研处最关心的汇总统计是用教师成果数量计算科研工作量。这条统计 SQL 写在 XML 里，根据成果类型和年份分组，输出每位老师的论文、项目、专利数量以及折算分值：

<select id="countWorkload" resultType="java.util.Map"> SELECT u.real_name AS teacherName, YEAAR(a.publish_date) AS year, a.type AS achievementType, COUNT(*) AS cnt, SUM(case a.type WHEN 'paper' THEN 10 WHEN 'patent' THEN 15 ELSE 5 END) AS totalScore FROM achievement_info a INNER JOIN sys_user u ON a.teacher_id = u.id WHERE YEAR(a.publish_date) = #{year} GROUP BY u.real_name, YEAR(a.publish_date), a.type ORDER BY totalScore DESC </select>

这段统计 SQL 没有把计算逻辑写死在 Java 里，而是用数据库的 CASE WHEN 完成分值折算。如果你的学校分值规则复杂，比如一区论文和二区论文分别 20 分和 10 分，可以增加一个 achievement_score_type 字段，折算系数的变化就不需要改 SQL 了。

5. 常见问题与避坑：启动失败、跨域、上传文件和缓存黑盒

5.1 MySQL 连接报时区错误：启动直接失败

现象：后端启动时提示The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized。原因：MySQL 8.0 默认时区设置不受 MyBatis 控制，连接字符串没设置 serverTimezone。解决：在 application.yml 的 jdbc url 末尾加上serverTimezone=Asia/Shanghai，同时建数据库时用 utf8mb4，否则中文注释和名称会变乱码。

5.2 前端登录接口 401：跨域预检请求被拦截器挡住了

现象：前端登录接口一直报 401，浏览器控制台出现OPTIONS http://localhost:8080/api/user/login。原因：axios 请求带Content-Type: application/json，会先发 OPTIONS 预检；而 JwtInterceptor 里对所有非 OPTIONS 请求强制要 token，预检请求直接失败。解决：在拦截器最前面加一行if (request.getMethod().equals("OPTIONS")) return true;，同时在 WebMvcConfig 里配置允许所有源和所有请求头。这个坑很隐蔽，因为有时本地用 vue.config.js 代理不会复现，直接地址跨域请求时才出现。

5.3 上传文件访问 404：路径映射没配置静态资源处理器

现象：上传接口返回了/upload/2025/xxx.pdf，但前端 img 标签访问时 404。原因：upload-path 指向磁盘/data/research-upload，后端只保存了文件，没有把/upload/**映射到磁盘目录。解决：在 WebMvcConfigurer 里配置addResourceHandlers("/upload/**").addResourceLocations("file:" + customUploadPath + "/")。注意 Windows 路径末尾要带/，否则拼接后少一层目录。这个问题在 Linux 服务器上最容易翻车，因为路径大小写也有影响。

5.4 用户权限改了但界面没变：Redis 缓存了角色菜单

现象：管理员把普通教师的角色改成科研秘书后，该用户还是看不到新增菜单。原因：登录时把菜单列表和角色信息放进了 Redis，key 是 userId，角色变更后没有同步清理。解决：角色变更时主动删除该用户的 Redis 缓存，或者在读取菜单时不缓存，每次都从数据库查。这个坑属于典型的缓存一致性，我建议在用户管理 Service 的 updateRole 方法里调用redisUtil.delete("menu:" + userId)，避免统计时发现权限还是旧的。

5.5 审批重复提交导致状态翻转：前端防重没做好

现象：教师提交项目申报后，快速点击两次“提交”按钮，后台收到两个请求，状态被连续变更，一条项目直接跳到科研处审核。原因：前端没有防重复提交，后端状态机里每一次动作都无条件推进。解决：在审批方法里先判断当前状态是否符合预期，再用条件更新setStatus(nextStatus).eq(ProjectInfo::getStatus, curStatus)，如果更新行数为 0 就说明被别人抢先处理，返回“请勿重复操作”。另一种做法是在 apply 接口生成唯一业务流水号，靠数据库唯一索引挡重复，但不如状态条件更新直观。

6. 二次开发：从改状态机到接企业微信通知，我常用的改造路径

这项目留给开发者的修改空间很大，我一般从三个方向切：审批流程调整、数据导出、消息提醒。

首先要改的是审批层级。很多学校要求学院科研秘书之外还得有主管院长审批。改法很简单：在 status 枚举里多加一个DEPT_LEADER_CHECK状态，然后在 approve 方法的状态机分支里插入一步，把DEPT_CHECK的下一个状态指向DEPT_LEADER_CHECK，再把DEPT_LEADER_CHECK的下一个状态指向SCHOOL_CHECK。审批流水表不用改，因为 project_approval 已经能记录多轮审批记录。前端审批页面只根据当前 status 显示按钮，不需要大改。

第二件常做的事是导出 Excel。科研处几乎每个月底都要统计项目汇总表，我直接在现有代码里引入 EasyExcel，写一个导出接口：

@GetMapping("/api/project/export") public void export(HttpServletResponse response) throws IOException { List<ProjectInfo> list = projectService.list(); response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); response.setHeader("Content-Disposition", "attachment; filename=project.xlsx"); EasyExcel.write(response.getOutputStream(), ProjectInfo.class).sheet("项目列表").doWrite(list); }

导出接口和列表查询共用数据源，但要注意把select *改成只查需要的列，否则大表导出时内存占用非常难看。

第三件是接入企业微信通知。高校科研处喜欢在项目状态变化时给教师推一条消息。实现上不必引入消息中间件，直接在审批成功后调企业微信 webhook 接口：

restTemplate.postForObject(webhookUrl, Map.of("msgtype", "text", "text", Map.of("content", "您的项目已通过审核")), String.class);

webhook 配置放到 application.yml，前端不用动。消息推送失败不能影响主流程，用 try/catch 包住即可。如果要做得更稳，把通知记录丢进 task_queue 表，后台定时任务重新投递，但这对于内部系统属于过度设计了。

改完代码后，我最推荐做的是回归“项目申报—审批—作业提交”三条核心链路。用 Postman 直接调接口，重点看状态机是否按照新流程走，上传文件是否还能正常预览。这个项目最让我放心的一点是状态字段和审批流水分离，改流程只要动状态机分支，不容易把历史数据搞乱。从那以后我每次改完审批逻辑都强制走一遍两轮审批回归，养成习惯了。希望这些实践能帮你少走几步弯路。

本文还有配套的精品资源，点击获取