做科研项目管理平台这类Spring Boot全栈项目，有个很实际的原因：业务边界清晰，技术点覆盖广，做完之后既能跑通全流程，又不会像纯电商那类系统一样复杂到让人失控。我说的不是只能点两下页面的Demo，而是带着申报、立项、中期、结题、经费统计一整套流程，有用户角色区分、能真正打包部署的Spring Boot科研项目管理平台。标题里“程序+源码+数据库+调试部署+开发环境”这几个关键词，其实就是大家在交付前后最关心的事：代码能不能跑、数据能不能灌、界面能不能看、配套论文文档能不能顺利写完交上去。
这篇文章我就按自己实际开发这类系统的一条线来讲：整体架构为什么这么搭，数据库表为什么这么拆，开发环境怎么初始化，核心模块怎么落地，包怎么打，部署环境怎么排错，最后聊一下配套的万字论文文档怎么组织。都是实操过程里踩过之后沉淀下来的东西，不是照着说明书念一遍。
1. 项目整体架构与设计思路
1.1 为什么选Spring Boot单体架构
不少刚接触这类系统的同学会纠结一个事：要不要拆前后端分离，要不要上微服务。我的建议很直接：科研项目管理平台这种“内部管理型系统”，单体架构就是最稳的选择。原因有三点：
第一，交付和部署成本低。Spring Boot自带内嵌Tomcat，打包成JAR就能直接跑，不需要额外维护Tomcat集群。论文文档和毕业答辩现场演示时，一台普通电脑就能把整个系统跑起来，这对以“功能完整、代码清晰、文档规范”为目标的工程来说非常重要。
第二，调试链路短。前后端分离需要在开发时启动前端开发服务器、后端服务、数据库三个东西，任意一个端口冲突都要花时间排查。单体项目里页面模板和后端在一个进程内，一次启动就能看到完整效果，对时间紧张的开发周期非常友好。
第三，和数据库配合的复杂度低。科研项目管理平台核心是业务数据和流程状态，不是高并发接口网关。单体服务可以直接连接库表，事务控制、关联查询都集中在服务层，出现数据不一致时定位问题比分布式场景简单得多。
这不是说前后端分离不好，而是在“交付一套完整可演示系统”这个目标面前，单体结构更能保证效率和稳定性。等你以后做大型商用系统，再去拆分服务也不迟。
1.2 技术栈选型与工程结构说明
做这类系统我习惯用一套非常经典但能保证效果的技术组合，这里直接列出来：
| 技术点 | 推荐选型 | 选择理由 |
|---|---|---|
| 开发框架 | Spring Boot 2.x | 起步依赖简洁，内置容器方便部署 |
| JDK版本 | JDK 1.8 | 兼容性最好，大部分服务器环境都支持 |
| 数据持久层 | MyBatis-Plus | CRUD代码量少，分页插件好用 |
| 数据库 | MySQL 5.7 | 稳定、资料多，课程设计和论文中的数据库设计好写 |
| 前端模板 | Thymeleaf + Bootstrap后台模板 | 服务端渲染，改完重启即可见效果 |
| 权限控制 | 拦截器+Session | 代码直观，便于讲解和答辩 |
| 图表展示 | ECharts或后台模板自带 | 统计结果直观展示在首页 |
除了技术栈，工程结构建议按模块分包，不要全堆在一个包下面。我的常用分包方式是这样的：
工程结构示例（Java包）：
com.research.project（主包）controller：接收前端请求，只做参数校验和结果返回service：业务逻辑层，事务方法都放在这里mapper：数据库访问接口，配合MyBatis-Plus使用entity：数据库表对应的实体类config：拦截器、默认配置common：通用返回结果、分页参数、工具类
这种“Controller-Service-Mapper”三层结构在论文里也很好画架构图：表现层负责页面和交互，业务层负责流程判断和数据处理，数据访问层负责和数据库打交道。答辩时评审老师最常问的也是这三层之间的调用关系。
1.3 数据库模型是怎么拆出来的
数据库设计是整个系统的地基。科研项目管理平台的核心实体并不多，但每一张表都要能回答一个业务问题，不能凭空乱建。
我按业务链路拆出这几张核心表：
sys_user用户表
存管理员、教师、学生，还有评审专家，字段包括用户名、密码、姓名、角色类型、所属部门等。角色类型我建议用字符串如ADMIN、TEACHER、STUDENT、EXPERT，比纯数字可读性强，前端页面做判断时也直观。project_info科研项目主表
这是整个系统最核心的表，存项目名称、项目编号、申报人、所属单位、项目类别、经费总额、当前状态、申报时间、立项时间、结题时间等字段。状态字段我用整型或字符串都行，建议字符串枚举，例如DRAFT（草稿）、SUBMITTED（已提交）、APPROVED（已立项）、IN_PROGRESS（进行中）、COMPLETED（已结题）、REJECTED（已驳回）。project_member项目成员表
一个科研项目通常有多个成员，成员和项目是多对多关系。成员表存项目ID、成员姓名、成员角色（负责人/参与人）、职称等。fund_info经费表
一个科研项目对应一条经费总账，记录总经费、已用经费、剩余经费。然后有一张fund_detail经费明细表记录每一笔支出和报销，字段包括项目ID、支出类型、金额、用途说明、支出时间。project_review评审记录表
专家评审立项或结题时填写的意见和结论，存项目ID、评审人ID、评审意见、是否通过、评审时间。这张表在论文的功能模块设计和数据库设计部分都很加分。notice_info公告通知表
后台管理员发布系统公告，存储标题、内容、发布时间。
导出的SQL脚本里除了表结构，记得把初始管理员账号一起写好，比如admin/admin123，同时插入几条项目演示数据。没有演示数据，页面图表和列表都是空的，答辩效果会差很多。
2. 开发环境准备与快速启动
2.1 本地开发环境怎么配
这类项目对环境要求其实不高，但你要是配错了版本，很容易出现启动报错然后怀疑人生。我推荐一套亲测没问题的配置：
- JDK 1.8，安装后命令行里执行
java -version能看到1.8.0_xxx即可 - Maven 3.6以上，配置好本地仓库，建议用阿里云镜像加速下载依赖
- IDEA，我用的是2020.3以后的版本，太老的版本对Spring Boot支持一般
- MySQL 5.7或8.0，5.7表现最稳，8.0需要额外注意时区设置
- Navicat或DataGrip，用来导SQL、看数据
不要一上来就装最新版本的JDK 17或MySQL 8.0以上，除非你很熟练能处理兼容问题。对多数同学来说，用现成的稳定组合，把精力放在功能实现和论文写作上，才是性价比最高的选择。
Maven仓库镜像配置（settings.xml中）：
<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>注意：依赖下载不下来的情况，绝大多数是Maven没有配置镜像，或者网络环境不稳定。优先检查这里。
2.2 数据库初始化和导入数据的正确步骤
拿到项目源码以后，第一步不是急着启动后端，而是先把数据库建好。我习惯在项目根目录建一个db/文件夹，里面放一个project_ms.sql脚本。脚本内容包含建库、建表、插入初始数据。
导入数据库时我一般这么操作：
- 打开Navicat，新建连接，主机是
localhost，端口3306，用户名root，密码是安装MySQL时自己设置的密码。 - 右键连接，选择“新建数据库”，库名要和代码里
application.yml配置的URL保持一致，比如research_project_db，字符集用utf8mb4。 - 选中这个库，右键选择“运行SQL文件”，选择项目里的
project_ms.sql，等待执行完成。 - 执行后刷新表列表，应该能看到
sys_user、project_info这些表。 - 做一次简单验证：
SELECT COUNT(*) FROM sys_user; SELECT COUNT(*) FROM project_info;正常情况下用户表和项目表里都有初始数据。如果项目表是空的，那后续页面展示的所有列表和统计图表都会是空白。
2.3 application.yml 配置里最容易改错的地方
Spring Boot项目启动的核心配置都在application.yml。这里贴一段我常用的核心配置，并说明每一项要注意什么：
server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/research_project_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: 你自己的数据库密码 servlet: multipart: max-file-size: 20MB max-request-size: 50MB mybatis-plus: configuration: map-underscore-to-camel-case: true global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0几个关键点：
第一，serverTimezone=Asia/Shanghai必须写。不写的话MySQL 8.0连接时会报时间区相关错误，MySQL 5.7也可能因为时区问题导致日期字段显示错乱。
第二，数据库账号密码必须改成本地的实际值。很多同学把代码里自带的密码当成自己的密码，结果启动时报Access denied for user。
第三，multipart配置是为了上传项目申报书和结题材料附件用的。默认上传文件大小只有1MB，不调大很容易遇到“文件大小超出限制”的报错。
第四，map-underscore-to-camel-case: true可以让数据库的user_name自动映射到实体的userName，写实体类时不用每个字段都加@TableField注解，省不少事。
2.4 第一次启动应该看哪些关键信息
数据库配好、配置改好以后，直接运行主启动类。启动成功后控制台会有明显标志，比如Spring Boot的ASCII横幅，以及一行Tomcat started on port(s): 8080。
第一次启动建议重点确认三件事：
- 控制台没有出现
Error级别日志。有红色报错就要停下来看，不要带着错误继续操作。 - 访问
http://localhost:8080能跳转到登录页面或系统首页。这里注意，如果不加端口直接访问，大概率打不开。 - 登录初始管理员账号后，能看到首页有统计数据，比如项目总数、在研项目数、经费总额之类的卡片或图表。
如果页面打不开，先检查是否真的启动成功，再检查浏览器地址。不要一上来就怀疑代码有问题，80%的情况是数据库连接或端口占用。
3. 核心业务模块的实现思路
3.1 科研项目的申报与立项状态流转
科研项目管理平台既然叫“平台”，核心就是围绕一个项目从想法到落地再到结题的全生命周期管理。我用一个状态字段贯穿始终，所有的列表查询、按钮显示、权限判断都跟着状态走。
具体状态流转可以这样设计：
草稿（DRAFT）-> 管理员或项目负责人创建项目，信息可以反复修改，导出申报书前不提交。
已提交（SUBMITTED）-> 负责人正式提交申报材料，进入专家评审阶段。提交后普通用户不能随意修改基础信息。
已立项（APPROVED）-> 专家评审通过，管理员批准立项。从这一步开始项目进入正式执行期，负责人可以填写中期进度和经费支出。
进行中（IN_PROGRESS）-> 项目执行期间一直保持这个状态。可以设置中期检查字段，比如实际开始时间、阶段性成果。
已结题（COMPLETED）-> 提交结题报告和成果材料，管理员审核通过后项目完成。
已驳回（REJECTED）-> 评审未通过或者管理员驳回，并写明驳回意见，负责人修改后可以再次提交。
在实际项目里，我当时把状态流转的判断写在Service层，Controller只接收请求和返回结果。比如“提交立项”这个操作：
public Result submitProject(Long projectId, Long userId) { ProjectInfo project = projectMapper.selectById(projectId); if (project == null) { return Result.error("项目不存在"); } if (!"DRAFT".equals(project.getStatus())) { return Result.error("当前状态不可提交"); } // 业务校验：必须填写完整申报内容 if (StringUtils.isBlank(project.getProjectName()) || project.getBudget() == null) { return Result.error("项目基本信息未填写完整"); } project.setStatus("SUBMITTED"); project.setSubmitTime(LocalDateTime.now()); projectMapper.updateById(project); return Result.success("提交成功"); }状态判断写在前端还是后端？答案很明确：以后端为准。前端隐藏按钮只是提升体验，后端Service再校验一次才是真正防止绕过逻辑的手段。我在项目里遇到过一个同学测试时说“我改一下参数就能直接调接口把状态变成已结题”，这就是后端没有做二次校验导致的。
3.2 角色权限：管理员、教师、专家和学生怎么区分
这类系统一般有四类角色，每一类关心的事情不一样：
- 管理员：全局管理，用户管理、项目审核、公告发布、经费统计
- 教师/项目负责人：申报项目、维护成员、填写中期进展、提交结题
- 评审专家：查看分配给自己的待评审项目，填写评审意见和结论
- 学生：查询项目列表、查看自己的参与项目，通常只有只读权限
权限设计我推荐从简方案：用拦截器（HandlerInterceptor）统一处理。Controller层每个接口的路径前缀或者方法上的自定义注解来表达权限，比如：
@PreAuthorize("hasRole('ADMIN')")如果你是使用Spring Security，可以用@PreAuthorize。我更多的是用拦截器做轻量级校验，因为更直观，答辩时也好解释。拦截器伪代码如下：
public class AuthInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session = request.getSession(); Object loginUser = session.getAttribute("loginUser"); if (loginUser == null) { response.sendRedirect("/login"); return false; } return true; } }然后在WebMvcConfigurer里注册拦截路径，例如：
registry.addInterceptor(authInterceptor) .addPathPatterns("/**") .excludePathPatterns("/login", "/doLogin", "/css/**", "/js/**", "/images/**");这里有一个很容易踩的坑：静态资源（CSS、JS、图片）如果也被拦截，登录页的样式就会全部丢失。所以excludePathPatterns里一定要把静态资源路径排除掉。
3.3 经费管理与进度填报的细节处理
科研项目和经费管理是强相关的功能。每个项目立项后会有一笔经费总额，负责人需要记录每一笔支出，管理员可以查看统计情况。
经费表设计我在前面已经提过，这里重点说业务逻辑上的细节：
- 经费支出时，需要计算“已用金额+本次支出金额”是否超过总额。超过就直接拒绝，给前端提示“经费不足”。
- 经费明细表支持按时间范围筛选、按支出类型统计。支出类型比如设备费、材料费、测试费等，前端用下拉框选择，不要用自由输入。
- 删除经费明细时要去更新经费总额。这个更新逻辑必须放在同一个事务里，不然会出现余额对不上的问题。
一处典型的服务层代码：
@Transactional(rollbackFor = Exception.class) public Result addFundDetail(FundDetail detail) { FundInfo fund = fundMapper.selectByProjectId(detail.getProjectId()); if (fund == null) { return Result.error("项目经费信息不存在"); } BigDecimal newUsed = fund.getUsedAmount().add(detail.getAmount()); if (newUsed.compareTo(fund.getTotalAmount()) > 0) { return Result.error("支出金额超出剩余经费"); } int inserted = fundDetailMapper.insert(detail); if (inserted > 0) { fund.setUsedAmount(newUsed); fundMapper.updateById(fund); } return Result.success("支出记录添加成功"); }注意@Transactional注解一定不要漏。fundDetailMapper.insert和fundMapper.updateById两步必须同时成功或同时失败，否则就会出现明细加上了但经费总额没更新，或者反过来。这种数据不一致问题在测试阶段很难发现，等答辩演示时被问到“为什么余额不对”才补就太晚了。
进度填报类似，项目立项后负责人可以按期填写“项目进度”，比如完成的研究内容、阶段性成果、下阶段计划。进度信息存到一张project_progress表里，和项目ID关联。首页或项目详情页按时间倒序展示历史进度。
3.4 首页统计与可视化怎么做才不显廉价
首页统计是很多系统很容易被忽略但非常重要的部分。评审老师打开系统第一眼看到的往往就是首页，如果首页只有一段欢迎文字和几个跳转链接，观感会比较弱。
我建议至少展示以下几块：
- 数字统计卡片：项目总数、在研项目数、已结题项目数、本年度申报项目数。
- 项目状态分布图：用ECharts画一个饼图，展示占比。
- 经费使用统计：按项目展示总经费和已用经费的柱状图。
- 按院系或部门的项目排行：如果用户表里有学院/部门字段，可以做一个横向柱状图。
统计接口写起来并不复杂。以“按状态统计项目数”为例：
public List<StatusCountVO> countByStatus() { // 通过MyBatis-Plus的QueryWrapper做分组统计 QueryWrapper<ProjectInfo> wrapper = new QueryWrapper<>(); wrapper.select("status", "count(*) as total"); wrapper.groupBy("status"); return projectMapper.selectMaps(wrapper) .stream() .map(map -> new StatusCountVO( (String) map.get("status"), (Long) map.get("total"))) .collect(Collectors.toList()); }在页面端用模板引擎循环渲染，或者直接对接ECharts的data属性。图表不需要花哨，数据准确、样式统一最重要。
4. 从源码到可运行：调试部署实操记录
4.1 本地IDEA调试时的几个关键设置
很多同学拿到源码的第一反应是直接打开IDEA点运行，结果报各种错误。其实启动前只需要做几件事：
- 确认项目编码是UTF-8。IDEA右下角能看编码格式，如果是GBK，中文页面就会乱码。建议统一设置为UTF-8。
- Maven配置正确。打开
Maven Projects窗口，先执行clean，再执行compile，让依赖全部下载下来。如果依赖下载不了，回到前面提到的镜像配置。 - 运行配置的JDK选对。在Run/Debug Configurations里，选择项目的JRE为JDK 1.8。
- 确认数据库服务已启动。本地MySQL如果没启动，后端点运行会一直卡在数据源初始化错误。
启动成功后，浏览器输入http://localhost:8080，先不要急着点业务功能，建议先做一次“主流程走通”：
- 管理员登录 -> 查看用户列表 -> 发布公告
- 教师登录 -> 创建项目草稿 -> 提交立项
- 管理员审核 -> 立项通过
- 教师录入经费明细
- 管理员查看统计图表
这套流程走通，说明绝大部分核心功能没有问题。
4.2 打包成JAR部署到服务器
本地开发完成后，交付时要考虑怎么把系统跑在别的机器上。最省心的是使用Spring Boot的内嵌Tomcat，打包成可执行JAR。
打包命令：
mvn clean package -DskipTests执行完以后，target/目录下会出现一个xxx.jar。这个JAR就是完整的可运行产物，里面包含了页面模板、静态资源、依赖库，但不包含数据库和数据库里的数据。所以部署新环境时，还要手动导出/导入MySQL数据库。
在服务器上启动最简单的方式：
java -jar project-ms.jar如果想后台运行，用nohup：
nohup java -jar project-ms.jar > run.log 2>&1 &启动后可以把日志输出到run.log，排查问题时再tail -f run.log。
注意：JAR包的运行机制决定了它内置Tomcat默认监听8080端口。如果服务器8080端口被占，用
--server.port=8081临时改端口。
4.3 外部Tomcat部署和JAR部署的差别
虽然JAR部署最简单，但有些学校或机构的服务器环境要求你必须用独立Tomcat部署WAR包，或者评审老师会问“能不能发布到Tomcat里”。所以这里也讲一下转换方法。
首先在启动类继承SpringBootServletInitializer：
@SpringBootApplication public class ProjectMsApplication extends SpringBootServletInitializer { @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) { return builder.sources(ProjectMsApplication.class); } }然后在pom.xml中把打包方式改成war：
<packaging>war</packaging>Tomcat内部是通过webapps目录部署Web应用的。把生成的project.war复制到tomcat/webapps/下，启动Tomcat后会自动解压。
JAR部署和WAR部署我自己实践中最大的区别有三个：
- JAR部署不依赖外部Tomcat，无需配置环境变量
CATALINA_HOME；WAR部署要求本机有独立Tomcat且JDK版本兼容。 - JAR方式默认端口是
application.yml里的server.port；WAR方式默认端口是Tomcat的conf/server.xml中配置的端口，通常是8080。 - 部署路径不同。JAR的访问路径一般是
http://IP:端口/，WAR的访问路径通常是http://IP:端口/项目名/。如果你访问的时候出现404，很可能就是忘了带项目名。
如果服务器是CentOS或Ubuntu，用JAR部署更省心；如果你所在的环境已经装了Tomcat而且运维只允许用Tomcat，那就走WAR路线。
5. 常见问题排查与避坑指南
5.1 数据库连接类的问题
我搜集了几个出现频率最高的数据库相关报错，直接整理成速查表：
| 报错现象 | 可能原因 | 解决办法 |
|---|---|---|
Access denied for user 'root'@'localhost' | 数据库密码不对 | 改application.yml里password |
Unknown database 'xxx' | 数据库没创建或者库名写错 | 检查库名和脚本导入的库名是否一致 |
Could not create connection to database server | 数据库服务没启动 | 启动MySQL，确认进程在跑 |
Public Key Retrieval is not allowed | MySQL 8.0的连接特性 | URL加allowPublicKeyRetrieval=true |
The server time zone value 'CST' is unrecognized | 时区未设置 | URL加serverTimezone=Asia/Shanghai |
这些问题不是代码Bug，基本都是配置不一致造成的。我自己遇到最多的就是同学把原项目里的密码复制过来但本地根本不是这个密码，或者导库时导到了别的库名下面。启动失败的时候，先按这个顺序排查：MySQL是否启动 -> 库名是否一致 -> 账号密码是否正确 -> URL参数是否齐全。
5.2 前端页面样式丢失和静态资源404
前面提到过，如果用拦截器做权限判断，很容易把CSS、JS、图片、字体都拦截掉。一旦登录页有样式但登录后页面变成“只有文字、纯白背景”，大概率就是静态资源被拦截了。
解决方案在注册拦截器的时候把静态资源路径排除掉：
registry.addInterceptor(authInterceptor) .addPathPatterns("/**") .excludePathPatterns("/login", "/doLogin", "/css/**", "/js/**", "/images/**", "/favicon.ico");还有一个常见问题是页面模板引用路径不对。Thymeleaf模板里引用静态资源建议使用th:href="@{/css/style.css}"，不要写死/../css/style.css这种相对路径。JAR包部署以后，相对路径和本地开发时的目录结构不一样，很容易出问题。
5.3 文件上传在Linux服务器上丢失
本地Windows上测试上传文件没问题，但部署到Linux服务器后，发现文件上传成功后无法通过浏览器访问。原因通常是本地路径和服务器路径不一致。
比如代码里写的保存路径是：
String filePath = "D:/upload/" + fileName;Windows下这个路径存在，但Linux下根本没有D盘，目录也不存在。正确的做法是把上传目录做成可配置项：
custom: upload-path: /usr/local/upload/然后在Service里读取配置并创建目录：
File dir = new File(uploadPath); if (!dir.exists()) { dir.mkdirs(); }最后上传成功返回可访问的相对URL，比如/files/20250608xxxx.pdf。别忘了给静态资源映射配置：
registry.addResourceHandler("/files/**") .addResourceLocations("file:" + uploadPath);如果不加这行映射，即使文件保存到了本地目录，浏览器访问/files/xxx.pdf也会返回404。
5.4 并发提交导致数据状态不一致
科研项目申报阶段，可能出现多个角色同时操作同一个项目：负责人提交立项，管理员同时也打开审核页面。如果不做任何并发控制，可能出现“负责人提交成功，管理员这边看到的是旧数据然后驳回”的情况。
解决思路有两个层次：
第一层，前端控制。项目状态一旦变成“已提交”后，相关按钮立刻置灰或隐藏。这能挡住大部分误操作，但挡不住接口直接调用。
第二层，后端控制。在更新项目数据时加入乐观锁。MyBatis-Plus提供@Version注解，在实体类上加一个version字段：
@Version private Integer version;更新的时候MyBatis-Plus会自动带上version条件，比如：
UPDATE project_info SET status = 'SUBMITTED', version = version + 1 WHERE id = ? AND version = ?如果两个请求同时更新，后一个请求执行时会发现版本号不匹配，影响行数为0，这时候提示“操作失败，请刷新后重试”。这个方法简单有效，应付答辩面试完全够用。
6. 论文文档与其他交付物的整理技巧
6.1 万字论文文档的结构怎么安排
拿到“带论文文档1万字以上”这个交付要求，很多同学不知道从哪里下笔。其实论文结构比代码简单得多，固定套路是这样的：
- 摘要：写清楚“本文设计并实现了一个基于Spring Boot的科研项目管理平台，解决了什么问题”
- 第一章：绪论，写背景意义、国内外研究现状、论文结构安排
- 第二章：需求分析，写功能需求、角色分析、用例图、可行性分析
- 第三章：系统设计，写架构设计、功能模块划分、数据库E-R图、表结构说明
- 第四章：系统实现，挑核心模块截图+代码说明，比如项目申报、经费管理、权限拦截
- 第五章：系统测试，写测试用例、功能测试结果、性能测试预分析
- 总结与展望
一万字不用怕，每个章节开展一点点就有了。数据库设计部分列几张表结构、字段说明就很容易撑足篇幅，系统实现部分每个功能模块配两三张截图和一段代码解释，加起来非常快。
关键点在于：论文里的截图和代码一定要和实际系统一致。我用过一段时间整理文档，发现最痛苦的不是写不出来，而是代码改了，文档里的截图还是旧的。所以在写论文之前，先把核心功能完整跑通，再统一截图，避免后期返工。
6.2 数据库脚本和源码如何和文档呼应
文档里写数据库设计时，建议同时包含：
- E-R图，可以用工具画清楚实体间关系，不一定要非常标准，但实体和关系的连线必须和表设计一致。
- 核心表的字段设计表格，包括字段名、类型、是否主键、说明。
- 关键SQL语句或MyBatis-Plus查询示例，比如“按学院统计项目数量”的统计SQL。
这样评审老师看论文的时候能非常快地理解整个系统的数据流转过程。文档尾部的附录可以放完整的建库建表SQL脚本核心部分，但不用贴全部，贴主要表即可。
6.3 给评审演示系统时的推荐顺序
如果你要现场演示这个系统，我强烈建议不要按着自己开发时的思路去点，而是按“业务故事线”来：
- 先展示首页统计，让评审一眼知道系统有哪些功能和数据量。
- 登录管理员账号，介绍一下用户管理、系统管理功能。
- 切换到教师账号，演示创建项目、填写申报书、提交立项。
- 再回到管理员账号，演示审核立项，可以顺便展示专家评审环节。
- 切换到教师账号，根据立项后的项目填写经费支出和进度。
- 最后回到管理员账号，展示经费统计、项目结题列表。
演示时不要乱点，尤其不要顺手删除数据库里的数据。答辩之前我会把数据库备份一份，万一不小心删错，还能恢复。系统演示期间最怕出现的就是“数据库连接断开”或者“项目ID不匹配”，提前把演示环境全部启动好并预演两遍，能避开绝大多数尴尬。
7. 最后再说一点实在经验
7.1 我实际操作中踩过最值钱的坑
第一个坑是数据库连接配置里没有加时区参数，导致所有时间字段都能查询但显示偏差。这个问题看起来很小，在测试阶段排查花了大半天。
第二个坑是上传文件路径写死到本机绝对路径。项目在自己电脑上运行一切正常，打包到服务器后文件上传永远失败。后来我才意识到，路径这种东西就应该做成配置，不能随着开发环境走。
第三个坑是统计接口返回的字段名和前端页面不一致。数据库字段是status，前端页面却是用statusName展示，后台没做转换，页面显示空白。这类小问题在答辩演示时最容易被放大，所以页面需要的任何字段都要在返回实体里明确写好。
7.2 这套项目还能怎么继续扩展
核心流程做完之后，如果时间和精力允许，可以扩展几个方向：
- 引入Spring Security替代手写拦截器，实现更标准化的登录认证和权限控制。
- 增加消息通知模块，项目状态变化时自动通知相关负责人。
- 把经费统计做成更细的月度趋势图，按月份汇总支出。
- 增加项目文档在线预览功能，上传申报书后可以直接在网页预览PDF。
- 把系统部署到云服务器，配置HTTPS域名访问。
这些扩展方向既可以放到论文的“展望”部分，也可以作为后期给其他人演示时的加分项。
说实话，做Spring Boot科研项目管理平台这类工程，最大的收获不是掌握了某个框架接口怎么调，而是把一条完整的业务线从需求到数据库、从后端到前端、从本地调试到服务器部署全部走通。这些经验是不断搜“报错怎么办”搜不出来的，只能在动手解决一个个问题中慢慢攒下来。你能把这个平台做到“代码能跑、数据能看、流程能通、文档能交”，就说明你已经有能力独立处理一个完整的软件交付流程。后面遇到更复杂的系统，也只需在这个底座上加砖加瓦而已。
