高校科研信息管理系统SpringBoot Vue MySQL 全栈项目实操解读每年毕业季、结课季总有同学为“做个什么系统”发愁。如果你也盯上了这类主打“高校科研信息管理系统”的项目源码说明你正在找一条稳的路。科研项目申报、论文登记、成果统计、用户权限控制这套需求在高校管理场景里非常典型既有业务复杂度又不至于难到无法驾驭是课设、毕设、甚至小范围真实落地的优质参考。再加上 SpringBoot Vue MySQL 这套组合前后端分离、技术栈主流、社区资料充足真正跑起来之后你学到的不仅是某段代码而是完整的全栈开发思维。写这篇文章的原因很直接我帮不少人看过类似的系统源码也亲自跑通过这类项目。大多数人拿到的压缩包解压出来能跑但遇到环境问题、数据库初始化失败、前端代理不通、权限校验绕不过去还是会卡住好几个晚上。这篇文章会从项目拆解、后端实现、前端页面、数据库设计、部署运行、问题排查几个维度把这类系统的结构和关键环节彻底讲透。无论你是即将答辩的学生还是想快速搭建内部管理工具的新人开发者目标都是同一件事花最少的时间跑通整套系统同时真正理解每一层在做什么。项目本身解决什么问题一句话就是用数字化方式管住科研活动从头到尾的信息。科研人员在线提交项目申请管理员审核立项中期检查时录入进度结题时上传成果论文发表后登记到系统年底统计各院系、各老师的项目数、论文数、经费总额。这一切过去靠 Excel 来回传现在变成一个角色分明、流程固定的在线系统。这类系统的核心价值不在界面多炫酷而在数据有结构、流程有状态、权限有边界。1. 选型逻辑与整体设计思路开篇先把技术选型讲透1.1 为什么是 SpringBoot、Vue、MySQL 这三件套先说后端框架。SpringBoot 在 Java 生态里的地位已经不需要多解释它把配置自动化做到了极致。以往用 Spring MVC 要写一堆 XML 配置文件现在一个spring-boot-starter-web依赖内嵌 Tomcatmain方法启动即用。对科研管理系统这种 CRUD 占据大头、同时带权限控制和状态流转的应用来说SpringBoot 的 REST 接口开发效率极高。更重要的是网上关于 SpringBoot 的踩坑资料浩如烟海遇到问题一搜就有答案这比选择一个冷门框架要省心太多。前端为什么是 Vue 而不是 React 或者 jQueryVue 的上手曲线更平缓模板语法直观组件化开发也够用。配合 Element UI 这类组件库表格、表单、弹窗、分页这些后台管理系统的“标配”可以一天之内搭完。再加上 Vue 的双向绑定特性构建查询条件和表单提交这类交互操作代码量比 jQuery 时代少一个量级。对高校科研管理这类业务相对固定的内部系统Vue 是最务实的选择。数据库用 MySQL 的理由就更直接了。开源免费、性能稳定、运维资料丰富高校环境里几乎处处可见。科研项目管理涉及经费金额、日期、状态等结构化数据MySQL 的关系型模型天然契合。别听人说“MongoDB 更好”对一个需要复杂查询、联表统计、事务操作的业务系统MySQL 这类关系型数据库在数据一致性上更可靠也更容易被答辩老师接受。1.2 系统分层架构与模块边界我习惯先画一张逻辑分层图再动手。这套科研管理系统的分层非常清晰控制层Controller接收前端请求校验参数调用业务层返回统一封装的 JSON。业务层Service处理具体业务逻辑比如项目申报时同一人不能重复提交相同名称的项目、结题时必须上传必要条件等。数据层Mapper/Repository通过 MyBatis 或 JPA 操作数据库表完成增删改查。表现层Vue 页面登录页、首页仪表盘、项目管理页、论文管理页、用户管理页等。选 MyBatis 还是 JPA这是第一个需要你拍板的问题。多数“可直接运行”的源码用 MyBatis或 MyBatis-Plus原因是 SQL 可控性强复杂统计查询写起来直接了当。MyBatis-Plus 还能省掉大量单表 CRUD 的 XML 编写工作BaseMapper里现成的方法够用遇到复杂查询就手写注解 SQL。我没有绝对立场但如果你刚接触这类系统从 MyBatis-Plus 入手是最不容易卡住的。模块边界更重要。科研管理系统一般分四块项目管理申报、审核、中期、结题、论文成果管理登记、认领、审核、系统管理用户、角色、菜单、字典、统计看板院系汇总、年度汇总、教师个人成果。每个模块之间不要互相乱调比如项目管理需要查用户信息走统一的 userService 接口而不是直接操作 user 表。这样后续扩展分组管理、经费管理时不会把代码改成一锅粥。1.3 这类系统的通用价值与扩展空间值得多说一句这种科研管理系统的设计思路不局限于高校。任何“资源申请—管理员审批—过程跟踪—结果汇总”的业务模型都可以套用这套骨架。企业内部的报修系统、实验室的设备借用系统、甚至社团的活动审批系统底层都是同一套用户角色权限加上状态机。你把这套源码跑通了以后换业务场景改的是表结构和业务流程架构不用重来。这也是为什么我推荐不要满足于“跑起来”要把代码里面的角色设计、权限拦截、状态流转逻辑读明白因为这些才是可迁移的硬技能。2. 后端核心模块与关键实现细节不要只停留在能跑要读懂每一层2.1 认证与权限控制方案选型科研管理系统必须有登录因为数据归属不同角色。项目申报人是教师审核者是科研处管理员系统维护者是超管这三种人看到的菜单和数据范围完全不一样。主流方案分两种Session 和 JWT。传统单体应用用 Session 没问题但前后端分离之后我强烈建议用 JWTJSON Web Token。理由很现实前端打包后可能部署在 8080 端口后端跑在 8081跨域情况下 Session 的 Cookie 处理相对麻烦而 JWT 把用户 ID、角色、过期时间加密放在 token 字符串里前端每次请求在请求头里带上Authorization: Bearer xxx后端拦截器验证签名即可无状态、可水平扩展、前后端联调省心。具体实现不复杂。用户登录成功后后端生成 token返回给前端。前端存在 localStorage 或 VuexPinia里。后端写一个拦截器拦截需要认证的路径解析 token 中的用户信息放入ThreadLocal或RequestContext业务层直接取用。粒度更细的权限控制可以在 token 里加roleId后端注解或代码判断角色是否能操作某个接口。比如删除项目只允许科研处管理员教师最多只能编辑未提交的项目。关键点是拦截器要放行登录接口和静态资源避免陷入“无法登录”的死循环。通常在WebMvcConfigurer里配置Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(jwtInterceptor) .addPathPatterns(/api/**) .excludePathPatterns(/api/auth/login, /api/auth/register); }2.2 统一返回结构与全局异常处理这一步是前后端联调顺畅的保障。如果每个接口返回的数据结构都不一样前端每一种请求都要单独处理解析逻辑代码会变得四分五裂。我在搭这套系统时定义的统一结果体很简单{ code: 200, message: 操作成功, data: { } }后端对应一个ResultT泛型类静态方法Result.success(data)、Result.error(msg)。不管查询成功、参数错误、权限不足、还是服务器内部异常都走这一套返回结构。前端 Axios 响应拦截器统一判断code是否为 200不是则弹出 message 提示是则直接返回data给页面。这样业务代码里几乎不用写重复的if (res.code 200)分支。全局异常处理用RestControllerAdvice加ExceptionHandler。我最常处理三类异常参数校验异常MethodArgumentNotValidException、业务异常自定义BusinessException、兜底异常Exception。把业务异常单独抽出来的好处是在 Service 层判断到“项目名称重复”“当前状态不允许操作”时直接throw new BusinessException(xxx)由全局处理器统一转换成友好的 JSON 返回不需要在 Controller 里到处 try-catch。2.3 科研项目管理模块的状态机设计项目管理是这类系统中业务逻辑最重的部分核心在于状态流转。我从头到尾梳理一遍教师提交申报书状态是“待审核”管理员审核通过状态变为“已立项”之后做中期检查状态变为“进行中”提交结题材料管理员终审后变为“已结题”。被驳回时回到“草稿”或“已驳回”。这个流程看起来直白但代码设计上有个坑不要在每个接口里用 if-else 判断状态是否合法。更好的做法是定义一个状态流转表在 Service 层写一个私有方法校验当前状态和目标状态是否匹配private static final MapInteger, SetInteger ALLOWED_TRANSITIONS new HashMap(); static { ALLOWED_TRANSITIONS.put(STATUS_DRAFT, Set.of(STATUS_PENDING_REVIEW)); ALLOWED_TRANSITIONS.put(STATUS_PENDING_REVIEW, Set.of(STATUS_APPROVED, STATUS_REJECTED)); ALLOWED_TRANSITIONS.put(STATUS_APPROVED, Set.of(STATUS_IN_PROGRESS)); ALLOWED_TRANSITIONS.put(STATUS_IN_PROGRESS, Set.of(STATUS_PENDING_FINAL)); ALLOWED_TRANSITIONS.put(STATUS_PENDING_FINAL, Set.of(STATUS_COMPLETED, STATUS_REJECTED)); }这样改写状态时先查当前状态再校验允许流转的方向不合法直接抛异常。既杜绝了“从草稿直接跳到已结题”这种逻辑漏洞也让代码可读性大幅提升。后续如果加入“退回修改”等操作只需要往集合里加状态不用改动调用方逻辑。这个模块的数据库表字段也值得细看。项目表一般包含项目名称、项目编号、负责人、所属院系、项目类型国家级/省级/校级、经费总额、开始时间、结束时间、当前状态、申报书附件路径、结题报告附件路径等。附件可以用本地路径保存也可以接对象存储但这套系统的源码一般用本地路径部署时记得配置好静态资源映射。2.4 论文成果与统计报表的 SQL 技巧论文管理跟项目管理不太一样它的重点是列表查询条件复杂。常见筛选条件有论文标题关键字、作者姓名、发表年份、期刊级别SCI/EI/核心/普刊、所属院系。全部条件拼到一个 SQL 里用 MyBatis 的动态where标签实现最方便select idselectPaperPage resultTypePaperVO SELECT p.*, u.name AS author_name FROM paper p LEFT JOIN user u ON p.author_id u.id where if testtitle ! null and title ! AND p.title LIKE CONCAT(%, #{title}, %) /if if testlevel ! null and level ! AND p.level #{level} /if if testyear ! null AND YEAR(p.publish_date) #{year} /if /where ORDER BY p.create_time DESC /select统计报表这类功能最好直接在数据库层面聚合不要在 Java 内存里循环累加。例如按院系统计论文数一条 SQL 就搞定SELECT d.name AS dept_name, COUNT(p.id) AS paper_count FROM paper p LEFT JOIN user u ON p.author_id u.id LEFT JOIN department d ON u.dept_id d.id GROUP BY d.id ORDER BY paper_count DESC;这个技能很加分。在很多半成品源码里统计是前端拿到列表后手动算的数据一多就卡。你把它改成 SQL 聚合效率提升是质的飞跃答辩时还能主动讲出“大数据量统计优先走数据库聚合”这一经验比背概念有说服力。3. 前端 Vue 架构与页面交互要点后端把 API 出好前端才能四两拨千斤3.1 目录结构与路由设计拿到这类系统的前端源码第一步不是急着npm install而是先看目录结构。规范的项目应该长这样src/ ├─ api/ // 每个模块的接口调用文件 ├─ assets/ // 静态资源 ├─ components/ // 公共组件上传组件、富文本等 ├─ layout/ // 整体布局侧边栏、顶栏 ├─ router/ // 路由配置 ├─ store/ // Vuex/Pinia 状态管理 ├─ views/ // 页面视图 │ ├─ login/ │ ├─ dashboard/ │ ├─ project/ │ ├─ paper/ │ └─ system/ └─ utils/ // 工具函数、axios 实例路由设计上后台管理系统大多是“整体布局 嵌套子路由”的结构。比如/project/list、/project/detail/:id都挂在 Layout 组件下面。路由守卫是重点beforeEach里判断本地 token 是否存在不存在就跳转登录页存在但是访问登录页则强制跳回首页。这个机制是整套系统能正常使用的“门禁”千万不要省略。菜单权限的动态渲染有能力的可以做深一点。后端登录接口返回当前用户的角色前端根据角色动态生成菜单数据而不是把所有菜单写死在路由表里。很多“可直接运行”的源码图省事用v-ifrole admin隐藏菜单项但那只管住了显示管不住直接访问 URL。真正的权限控制一定要后端接口层拦截前端只是规避操作入口。3.2 Axios 封装与 Token 携带前端最容易踩坑的地方就在这里。Axios 实例要单独封装出一个文件统一配置baseURL和请求超时时间。开发环境下baseURL指向http://localhost:8081/api生产环境打包后可以通过 Nginx 反向代理前端请求相对路径/api由 Nginx 转发到后端。这个策略的妙处在于前端代码不需要因为环境切换而改动。请求拦截器统一带上 tokenservice.interceptors.request.use(config { const token localStorage.getItem(token) if (token) { config.headers[Authorization] Bearer token } return config })响应拦截器统一处理三件事成功返回后剥离外层结构、业务状态码非 200 时弹出错误提示、HTTP 401 时清除 token 并跳回登录页。注意跳登录页要用window.location.href强跳因为此时路由守卫可能因为 token 失效不生效。3.3 核心业务页面的交互设计以项目申报为例项目申报页面是信息量最大的一个表单字段包括基本信息、成员信息、经费预算、研究内容概述还可能涉及附件上传。开发时要有意把长表单拆分成多个组件例如ProjectBaseForm.vue、ProjectMemberForm.vue、ProjectBudgetForm.vue每个组件负责一块通过v-model或事件总线跟父页面同步。不要一个页面塞几百行el-form-item后续维护会非常痛苦。交互上还有一个容易忽视的点不同状态下按钮的可见性。项目处于“草稿”时教师看到“编辑”和“提交审核”按钮处于“审核中”只看到“查看详情”处于“已驳回”看到“编辑”和“重新提交”。这些按钮判断写一个函数集中管理const getActionList (status) { const map { DRAFT: [edit, submit], PENDING_REVIEW: [], APPROVED: [start], REJECTED: [edit, resubmit] } return map[status] || [] }模板渲染时用v-foraction in getActionList(row.status)按钮的动态配置一目了然不需要在模板里写大段v-if。3.4 数据看板页面的图表渲染选型首页仪表盘一般放“项目总数”“年度论文数”“待审核事项”几个数字卡片底下再放“各院系科研统计”柱状图或者“近五年项目趋势”折线图。图表库用 ECharts 是事实标准它内置的init、setOption两个核心方法足够覆盖所有展示需求。需要注意的是图表必须在nextTick或setTimeout里初始化否则容器尺寸可能为 0页面切换时要用beforeDestroy里调用dispose实例防止内存泄漏。如果数据需要从后端拿我习惯将统计接口单独建一个 Controller比如/api/stats/dept-project-count。前端每个图表调一个接口而不是一个接口返回全部统计数据再拆分。这样做的好处是接口职责单一某个图表数据出错时只查一个问题点。4. 数据库设计与初始化脚本解读表结构里藏着系统的灵魂4.1 核心表结构设计思路打开 SQL 脚本第一件事是看表关系。科研管理系统的表数量一般在 10 到 15 张最重要的画个思维导图就能记住用户表sys_user存放登录账号、密码加密存储、姓名、院系、角色。角色表sys_role管理员、科研人员、超级管理员。用户角色关联表sys_user_role多对多关系。院系表sys_department计算机学院、经管学院等。项目表project科研项目申报信息。论文表paper论文登记信息。通知公告表notice管理员发布公告。操作日志表sys_log记录用户关键操作。密码存储一定要加密。最常用的是 BCryptbcrypt加密后的密码是不可逆的登录校验用matches方法比对。如果源码里密码是明文存储强烈建议改掉这既是安全底线也是答辩时可以重点展示的改进点。4.2 字段设计与索引取舍细节日期字段用datetime别用字符串。这样可以直接在 SQL 里用YEAR()、MONTH()函数做统计还能用BETWEEN查区间。金额字段用decimal(12, 2)不用float避免浮点精度问题。状态字段用tinyint加注释取值范围要在代码里定义为常量不要散落在各种魔法数字中。索引设计有几个实用经验外键关联字段user_id、dept_id建议建索引加速联表查询。列表页的排序字段和筛选字段比如create_time、status加索引对分页查询有明显提升。索引不是越多越好每个索引都会降低写入性能。总共十几张表的管理系统每张表 3 到 5 个索引就足够了。create_time和update_time这两个字段一定要有。MyBatis-Plus 有TableField(fill FieldFill.INSERT)自动化填充方案用来维护这两个字段非常省事业务代码里完全不用管他们。4.3 初始化数据脚本的坑运行被赋予脚本时报错最多的是 SQL 版本兼容问题。旧版本脚本里有ENGINEInnoDB DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_general_ci新版本 MySQL 还能跑但如果脚本里用了utf8mb4_0900_ai_ci而你的 MySQL 版本低于 8.0直接报错。遇到这种问题最简单的处理是把 COLLATE 统统改成utf8mb4_general_ci。外键约束也常触发创建失败。很多教学级源码喜欢给表加外键但实际开发更倾向于不加物理外键逻辑外键通过业务保证数据一致性在分库分表和迁移场景下更灵活。如果初始化脚本因为外键约束创建失败删掉FOREIGN KEY相关语句只保留索引即可。初始化数据里必须有一个管理员账号。如果脚本只有普通用户你登录进去没有管理权限很多管理端功能看都看不到。检查sys_user表里是否存在用户名为 admin或英文名的记录且密码加密串能用 BCrypt 验证。不确定密码的话直接运行一段代码修改指定用户的密码最干净// 启动时通过 CommandLineRunner 临时执行改完删掉即可 String encoded new BCryptPasswordEncoder().encode(123456); sysUserMapper.updatePasswordByUsername(admin, encoded);5. 本地运行部署全流程实操从零到跑通的高效路径每一步都有原因5.1 环境准备与版本兼容矩阵这类系统最常见的失败原因就是环境版本不匹配。我踩过的版本坑远超想象先给你一张当下最稳定的版本组合表组件推荐版本说明JDK1.8 或 11大多数源码基于 Java 8 编写JDK 17 虽然能跑但可能遇到兼容问题MySQL5.7 或 8.05.7 兼容性最稳8.0 需要留意连接驱动版本Maven3.6.3 以上配置阿里云镜像加速依赖下载Node.js14.x 或 16.xVue2 项目的常用版本过度高于这个版本可能导致 node-sass 安装失败npm6.x 或 8.x与 Node 对应数据库连接串有一处高频坑MySQL 8.0 的驱动类从com.mysql.jdbc.Driver变成了com.mysql.cj.jdbc.Driver并且需要显式配置时区参数spring: datasource: url: jdbc:mysql://localhost:3306/research_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver如果漏掉serverTimezone启动时大概率报“Server returns invalid timezone or zone info”错误属于必踩必解的经典问题。5.2 后端启动步骤与验证顺序启动后端不要盲目点运行按钮按固定顺序操作建库建用户用 Navicat 新建数据库research_system执行提供的init.sql或schema.sql脚本。改配置文件编辑application.yml确认数据库地址、账号、密码正确。确认 Redis 是否需要很多源码带了 Redis 做缓存或存储 token没有 Redis 环境时会启动失败。看pom.xml里有没有spring-boot-starter-data-redis。如果不需要注释掉相关依赖和配置需要用就直接本地安装一个。启动并看日志看到 “Started Application in 3.2 seconds” 这类日志说明启动成功。接着访问http://localhost:8081/api/auth/login用 POST 工具带账号密码请求一次能拿到 token 说明后端全通。后端启动失败时看控制台第一段错误信息。最常见的是数据库连接失败Access denied for user rootlocalhost、端口被占用Port 8081 was already in use、Mapper 扫描不到Invalid bound statement (not found)。逐条解决即可。Mapper 扫描问题检查启动类有没有加MapperScan注解或者每个 Mapper 接口有没有加Mapper。5.3 前端的完整启动流程前端没有后端那么多配置讲究但有两个点必须处理好一是 npm 源。国内直接 npm install 大概率慢到怀疑人生配置淘宝镜像npm config set registry https://registry.npm.taobao.org二是依赖版本冲突。Vue2 项目最常见的坑是 node-sass 编不过直接换成 sassdart-sass能解决大部分问题npm install sass1.32.13 --save-dev依赖安装完成后查看vue.config.js文件重点确认开发代理配置module.exports { devServer: { port: 8080, proxy: { /api: { target: http://localhost:8081, changeOrigin: true } } } }有了这个代理前端请求/api/auth/login会被自动转发到后端 8081 端口规避了跨域问题。启动命令npm run serve浏览器访问localhost:8080看到登录页输入初始化脚本里的默认账号能进到首页系统就算完全跑通了。5.4 生产环境部署与打包优化跑通开发环境之后很多同学还想打包部署。前端执行npm run build生成 dist 目录后端用mvn clean package -DskipTests生成 jar 包。部署时将前端 dist 文件放到 Nginx 的html目录Nginx 配置里做两件事静态资源路由指向 dist 目录/api开头的请求反向代理到后端地址server { listen 80; server_name localhost; location / { root /usr/share/nginx/html; index index.html; try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://localhost:8081; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }注意try_files这一行很关键否则刷新某个子路由比如/project/list时会报 404。后端启动用nohup java -jar research-system.jar app.log 21 挂后台跑。第一次生产部署时先在本地用命令行java -jar跑一跑确认没有依赖本地 IDE 的路径再往服务器上放能少很多返工。6. 常见问题排查与避坑实录本部分内容完全来自实操记录建议直接收藏6.1 数据库连接与初始化高频报错速查表整理成表格可以快速对照问题现象根本原因解决方案启动报Unknown database research_system没有先建库直接跑代码连接 MySQL 执行CREATE DATABASE research_system DEFAULT CHARACTER SET utf8mb4;报Access denied for user配置文件的数据库账号密码与本地不一致检查application.yml的username/password报Table doesnt exist没有执行初始化 SQL 或执行了但脚本不完整重新执行init.sql确认没有报错报Server returns invalid timezoneMySQL 8.0 时区问题数据库连接串加serverTimezoneAsia/Shanghai报Public Key Retrieval is not allowedMySQL 8.0 的 RSA 公钥获取限制连接串加allowPublicKeyRetrievaltrue6.2 前端登录后请求 401 或 403 的处理思路这个现象集中出现在 token 机制不完善的源码中。排查路径按照从前端到后端的顺序先看浏览器 DevTools 的 Network确认登录成功后的所有请求是否都带上了Authorization头。如果没有是请求拦截器没生效检查 Axios 编码里 token 的取用 key 是否跟前端存储时一致。常见坑是登录存的是userInfo拦截器取的是token。如果请求带上了 token 依然 401多半是后端拦截器校验失败。排查点有两个拦截器放行的路径是否正确、JWT 密钥是否太短导致加密异常。有些源码里 JWT 硬编码在配置文件中密钥长度不足 32 字节换一台机器解析就报签名不一致。把密钥改成固定长字符串再重启一次即可。403 比 401 好解决说明认证通过了是用户权限不够。检查当前登录用户是不是真的管理员。用 Navicat 直接看sys_user_role表里的关联数据再对照代码里PreAuthorize(hasRole(ADMIN))之类的注解角色名称是否一致。角色名字写错是最隐蔽的权限问题比如库里是admin代码里判断是ADMIN直接对不上。6.3 附件上传失败路径配置的经典绕弯科研项目申报通常要传 PDF 附件这一块实现有不少坑。后端保存本地的路径不能是绝对的C:/xxx部署换环境必炸。较强做法是配置一个可自定义的上传路径file: upload-dir: ./data/upload然后写一个WebMvcConfigurer把上传目录映射为静态资源使文件能通过 URL 访问Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/files/**) .addResourceHandler(file: uploadDir /); }前端上传组件提交到/api/file/upload之后后端返回可访问的 URL前端把 URL 存进表单的附件字段。需要注意上传接口同样要过 JWT 拦截器但部分组件库的action属性不会自动带上Authorization头此时需要给上传组件传入请求头否则报 401。6.4 时区、日期格式化与分页查询的一致性统计报表里日期差 8 小时是老问题。MySQL 的datetime不带时区信息Java 的LocalDateTime也不带。为了避免出现“今天 8 点前的数据算到前一天”要求所有层统一使用Asia/Shanghai时区。数据库连接串加了serverTimezoneAsia/Shanghai后端启动参数可以加-Duser.timezoneAsia/Shanghai前端传日期时用YYYY-MM-DD格式而不是 ISO 字符串。三处一致后跨时区问题基本绝迹。分页查询的坑相对少一些。确保前端每页大小传的是数字而不是字符串后端用PageHelper或 MyBatis-Plus 分页插件时分页参数命名统一否则很容易出现“明明每页 10 条却返回 20 条”的幻觉问题。排查时直接打印 SQL 日志看 LIMIT 条件对不对判断问题在哪一层。7. 系统扩展方向与个人实操心得跑通同类系统后建议不要急着删掉项目。我每次拿到新的源码都会往里面加两个小功能练手一个是“导出 Excel 报表”另一个是“消息待办提醒”。这两个功能覆盖了文件流处理、异步任务、WebSocket 或定时轮询等扩展技术点是跟评委或领导讲“我做了优化改进”时最自然的抓手。导出 Excel 用 EasyExcel 非常合适几行代码就能把查询结果写成.xlsx先定义导出实体字段注解再调用EasyExcel.write(outputStream).sheet(项目表).doWrite(list)。注意大数据量导出时要去掉 Excel 默认的 1000 行隐藏限制还要设置合理的请示方式避免内存溢出。消息提醒功能可以做一个简单的待办表教师提交申报后自动插入一条记录管理员登录首页时查询待办数。更进一步用 WebSocket 推送实时通知但需要评估项目体量。对课设毕设而言做成“右上角红点 列表”已经完全够用。最后说几句实在话。运行这类系统最重要的一件事是把它当成“阅读材料”而不是“最终成果”。看懂一张表为什么这么建一个接口为什么这么设计比测试通过所有功能有价值得多。很多同学拿到的源码里有几处隐蔽冗余买了前端依赖却不清理Controllers 里有从未被调用的方法数据库里个别字段要么没索引要么索引重复。这些不影响系统运行但如果你能在答辩时提一句“我做过代码清理删除了无用依赖和冗余接口”导师对你的印象会好很多。毕竟是技术能力的体现不是“能用”两个字能概括的。