企业官网建设流程全解析

毕业设计做“高校教师教研信息填报系统”，以SpringBoot为技术核心，是目前很主流也很有代表性的选题。一方面这个题材贴近实际业务——高校教研管理里的成果填报、审核、汇总、统计确实是真实存在的痛点；另一方面SpringBoot技术栈能覆盖从后端接口、权限控制到数据库设计的完整闭环，答辩也容易讲清楚。

这篇博文我会按照完整项目的落地路径来讲：从选题拆解、技术选型、数据库设计、核心功能实现，到环境配置、常见坑点、面试答辩加分的角度全部过一遍。内容适合正在做类似毕设的同学参考，也可以当作SpringBoot从入门到实际项目的复盘笔记。

1. 立项拆解：高校教研填报到底在解决什么问题

1.1 学校里的真实业务痛点

很多同学做毕设时容易犯一个错误——拿着技术去找场景，而不是从场景反推技术。教研信息填报系统这个题目的价值在于，它背后的业务流程非常清晰且高频。

高校每学期都要组织教师填报教研成果，包括发表的论文、立项或结项的课题、教学获奖、专利软著、教材专著、指导学生竞赛等。传统做法是教务处发Excel模板，各学院汇总后交给教师填写，然后科研秘书手动合并、催收、检查格式，最后再逐级审核。这个过程存在几个非常实际的痛点：版本混乱（每个老师手里的Excel格式不一样）、填报延期（催收靠邮件和微信）、审核留痕难（改没改、谁批的说不清）、汇总统计慢（年度考核时需要重新人工整理）。

“教研信息填报系统”解决的就是这组问题：让教师在网页上填表、提交，让院系审核人在线审批，让管理员批量导出、多维度统计。把这个逻辑搞清楚之后，系统的功能边界就不会跑偏。

1.2 角色与权限模型的两种设计路线

系统角色通常分为三类：教师、院系审核人（科研秘书/教学院长）、管理员（教务处工作人员）。有些系统还会加入学生（辅助填报竞赛信息），但毕设不建议加太多角色，否则容易失控。

权限模型上，目前毕设项目最常见的方案有两条路线：

• 基于Spring Security或Sa-Token做完整RBAC（角色-权限-菜单三级）；
• 基于拦截器做简单的角色判断。

我建议走第一个方案但是简化实现：用Spring Security进行认证，用注解@PreAuthorize("hasRole('ADMIN')")做方法级权限控制。这样在答辩时能讲清楚“认证-授权-会话”的完整链路，而且不容易被评委追问“只用拦截器，如果角色变多怎么办”。

如果不想代码量太大，也可以使用Sa-Token，它对SpringBoot的集成比Spring Security省事很多。但是要提前评估：你所在学校有没有指定技术栈要求，如果必须用Spring Security，那就老老实实用。

1.3 功能模块怎么划分才能保证“完整但可控”

功能模块的划分直接决定了开发量和工作量预估。教研填报系统的核心功能可以这样拆：

建议毕业论文里的功能需求分析就按这个表格写，不要贪多。每一项功能写清楚“前置条件、基本流程、异常流程、角色权限”，这是软件工程要求的数据流/业务逻辑描述方式，也是答辩提问的高频范围。

有一点要特别提醒：不要把“获奖证书上传”做成必选功能，因为涉及文件存储容量和格式校验，会让系统复杂度上一个台阶。如果实在要加，放到“拓展功能”里说明即可，不影响主体完整性。

2. 技术选型：SpringBoot及其生态的取舍分析

2.1 为什么用SpringBoot而不是SSH或SSM

这个问题看似基础，却是毕业答辩里几乎必问的技术点。SpringBoot解决了传统SSM/SSH开发的几个核心痛点：XML配置繁琐（Spring+SpringMVC需要维护大量bean配置）、依赖版本冲突（jar包版本由开发者自己管理）以及部署流程长（需要打war包扔进Tomcat）。

SpringBoot通过自动配置（AutoConfiguration）和约定优于配置，让项目开箱即用。比如引入spring-boot-starter-web之后，SpringMVC的所有核心组件都会被自动装配，内置Tomcat也被打成可执行jar包直接运行。在一次答辩里，我用这样一句话让评委理解了自动装配的价值：“以前配一个SpringMVC工程，web.xml、springmvc.xml、applicationContext.xml三个配置文件的体系非常庞杂；SpringBoot用starter把常用组件全部打包，你只需要关心的业务代码。”

此外关于SpringBoot的版本选择，这里要展开说清楚：版本不能一味追新。SpringBoot 3.x要求JDK17起步，并且把包名从javax.*迁移到了jakarta.*，很多网上教程用的还是旧写法，如果你下载的代码是2.x系列的，直接把import javax.servlet.*搬到3.x项目里会直接编译报错。所以毕设项目最好选择SpringBoot 2.7.x（JDK8/11都兼容），除非学校明确要求必须用3.x。

热搜词里有“springboot版本太高”这个说法，说的就是这个坑。版本高不代表用着舒服，生态兼容性问题会让开发进度卡壳。核心思路是：版本的选择权交给业务需要，而不是为了追新而升级。

2.2 持久层选型：MyBatis还是MyBatis-Plus

持久层的选择上，除了原生MyBatis还有MyBatis-Plus和Spring Data JPA。对毕设项目来说，MyBatis-Plus是我比较推荐的组合，理由如下：

• 提供BaseMapper，单表增删改查一行代码都不用写；
• 条件构造器LambdaQueryWrapper让动态SQL从XML里解放出来，代码可读性好很多；
• 分页插件集成简单，一个MybatisPlusInterceptor搞定。

这个选择在答辩时有一个非常大的优势：你可以做对比分析——原生MyBatis需要手写大量重复的基础CRUD，虽然SQL灵活可控，但过度消耗开发时间；MyBatis-Plus在小项目里能以较少代码覆盖绝大多数查询场景，报表统计类的复杂SQL仍然可以用@Select注解自定义写入，灵活性并没有损失多少。

2.3 前端方案：Vue3 + Element Plus与Thymeleaf两条路线

前端是前后端分离（SpringBoot + Vue3 + Element Plus）还是服务端渲染（Thymeleaf + Bootstrap）？我见过太多毕设在这个选择上反复横跳，最后把自己搞崩。

如果开发时间充裕（8周以上），并且你对Vue基础语法有信心，首选SpringBoot + Vue3 + Element Plus的前后端分离方案。原因是这个方案在“界面完成度”上的表现力非常强，Element Plus的表格、表单、弹窗组件几乎长在后台管理系统的审美点上，和OA类项目天然匹配。搭建工程时，前端走Vite + Vue3 + Pinia + Vue Router + Axios，后端用SpringBoot。

如果时间紧张或者前端基础薄弱，那就选Thymeleaf + Bootstrap/AdminLTE这套方案。Thymeleaf是SpringBoot官方推荐的服务端模板引擎，热更新配置也成熟（spring.thymeleaf.cache=false可在开发期实时刷新），和SpringMVC的Model/View机制无缝结合。今年许多同学用Thymeleaf做毕设，数据展示能用Thymeleaf语法 + JavaScript库（jQuery/ECharts）完成，系统完整性并不差。

Hebb的教训是：不要既想学Vue又想快速答辩，半年基础学习按三个月起步，Vue入门容易精通难，中途踩到跨域、Vite代理、组件封装这些细节，调试成本往往会超出预期。

每条路线我都提一下技术细节：

• 前后端分离下：前端请求加baseURL时注意代理配置，后端要配置CORS跨域或采用@CrossOrigin；
• Thymeleaf方案下：注意th:each、th:if的语法，分页有条件渲染时别把条件写错位置；
• 如果用了Spring Security，前端请求要携带token，Thymeleaf页面中sec:authorize可以按角色控制按钮展示。

2.4 文件存储：本地磁盘与MinIO怎么选

填报系统涉及上传成果附件（PDF、图片）。毕设阶段首选本地磁盘存储，也就是配置一个虚拟路径映射到磁盘目录，例如：

file: upload-dir: /data/edu-report/ access-path: /files/**

然后用WebMvcConfigurer做静态资源映射：

@Configuration public class FileConfig implements WebMvcConfigurer { @Value("${file.upload-dir}") private String uploadDir; @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/files/**") .addResourceResolver(new PathResourceResolver()) .addResourceLocations("file:" + uploadDir); } }

如果学校对存储方案有“分布式、上云”的趋势要求，那可以把MinIO（开源对象存储）作为加分项，引入minio-javaSDK，将文件上传到MinIO指定的bucket。MinIO和SpringBoot的集成近年来在毕设项目里越来越常见，原因是Java操作MinIO的API很简洁，几行代码就能实现上传、查询URL、删除，而且本地用Docker跑一个MinIO实例也不难。基于SpringBoot的毕设项目里，很多同学在后端模块上用S3协议接口将MinIO接入，存储容量和访问速度都比本地磁盘强，答辩时能讲出“本地存储的局限是扩容难、单点故障风险大，引入对象存储可以解耦业务与存储”，这属于非常标准的扩展思路。

3. 数据库设计与核心功能实现

3.1 建表：教研填报系统的表结构怎么设计

教研填报系统至少要包含这些数据表。我给出一个比较规范的物理表清单和字段逻辑：

用户表（sys_user）

院系列表（sys_college）：id、college_name、sort_order。

成果主表（report_main）：一次填报提交作为一个主记录，包含教师ID、填报年度、状态、提交时间。

成果子表：建议拆分成report_paper（论文）、report_project（课题）、report_award（获奖）、report_patent（专利软著）、report_book（教材专著）五张子表。每张子表以report_id关联主表，字段如下：

• 论文：论文名称、期刊名称、ISSN号、发表时间、级别（SCI/EI/核心/普刊）、是否通讯作者、排名；
• 课题：课题名称、课题来源（国家级/省部级/校级）、立项编号、立项时间、结项时间、经费、排名、角色（主持/参与）；
• 获奖：获奖名称、奖项等级、获奖时间、颁奖单位、排名；
• 专利：专利名称、专利号、专利类型（发明/实用新型/外观）、授权时间、发明人排名；
• 教材：教材名称、出版社、书号、出版时间、编写角色。

审核记录表（audit_record）：主表ID、审核人ID、审核结果（通过/驳回）、审核意见、审核时间。

这套设计是典型的主从表（一到多）结构。好处在于不同成果类型字段差异很大时，拆分到不同子表会大幅降低空字段比例，也便于扩展新的成果类型。设计时注意各表字段写清楚注释，这在论文里属于“数据库设计”章节的硬素材。

3.2 状态机设计：草稿、提交、审核、驳回的流转控制

状态流转是这类系统最容易被开发时忽视的细节。建议用整数状态字段，不仅便于存储，查询条件也好写：

• 0-草稿：教师保存未提交，可以修改；
• 1-待审核：已提交，等待院系审核人审批；
• 2-审核通过；
• 3-已驳回，教师可以修改后重新提交（变回1）。

在代码层面，这个状态机可以封装成一个枚举类：

@Getter public enum ReportStatus { DRAFT(0, "草稿"), SUBMITTED(1, "待审核"), APPROVED(2, "已通过"), REJECTED(3, "已驳回"); private final int code; private final String desc; ReportStatus(int code, String desc) { this.code = code; this.desc = desc; } }

所有更新状态的地方统一校验“前置状态”，避免用户通过接口直接跳状态。比如“审核通过”只允许从“待审核”状态转移，不允许从“草稿”直接变成“已通过”。这不仅能防止业务数据脏乱，也让答辩时能从容回答“状态机怎么设计”的问题。

3.3 填报表单的实现与动态字段处理

填报页面是整个系统里功能最多的一部分。因为不同成果类型字段不同，前端表单要动态渲染：选“论文”时显示期刊名称、ISSN、级别；选“课题”时显示课题来源、经费、立项编号等。后端接收时用统一的DTO，前端提交时用type字段区分类型，这样后端接口可以收敛为一条/report/save。

后端接收的设计上，要注意“同一个接口接收多种结构”是变长结构、字典映射、参数分组的问题。如果采用“主表 + 各子表拆分”的方案，最简单的实现是类型判断后，不同子表数据分开写入；复杂一点的方案是路由模式。我推荐的做法是：用ReportSaveDTO包含主表公共字段和一个Map<String, Object> extraData，前端把子表字段以JSON对象传过来，后端用Fastjson2/Jackson解析成对应实体。

这个设计需要重点处理参数合法性和类型转换，如果抽不出精力，那就在前端把子表数据拼成明确DTO，后端写四个save方法分别处理四类子表，代码冗余一点但思路更直观，不容易出错。

3.4 Excel导入导出：用EasyExcel告别POI原生API

填报系统在“管理员导出汇总表”时必然要处理Excel。千万不要用Apache POI原生API，一个表格数据量不大时它还能接受，但整理格式和样式非常繁琐，一个字段的单元格合并都能折腾半天。推荐使用阿里巴巴的EasyExcel，它对POI封装得很好，注解驱动，一行代码就能把实体列表写入Excel。

导出代码大概是这个形态：

// 返回excel文件下载 response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); response.setCharacterEncoding("utf-8"); String fileName = URLEncoder.encode("教研成果汇总", "UTF-8").replaceAll("\\+", "%20"); response.setHeader("Content-Disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx"); EasyExcel.write(response.getOutputStream(), PaperExcelDTO.class) .sheet("论文成果") .doWrite(list);

PaperExcelDTO的字段上用@ExcelProperty("论文题目")这样的注解指定表头，用@ColumnWidth(30)控制列宽。需要注意点是：页面上使用了window.location.href直接请求下载接口时，后端要处理好文件名编码；如果用Axios做blob下载，响应类型要配置对，否则下载的文件会打不开。

类似地，导入也一样——准备一个模板文件，用EasyExcel.read()监听器逐行解析，校验空值和必填项后批量插入。导入功能在毕设论文里也是含金量较高的模块，评委容易提问“数据校验策略”。

3.5 统计报表：按院系、年度、职称维度聚合

教研统计模块需要注意的是：不要在应用层做数据聚合，尽量用SQL在数据库层面一次性查询结果。典型统计包括：各院系发表论文数量、各年度课题立项数量、职称分布、院系审核完成率。

举例说明：

SELECT c.college_name, COUNT(r.id) AS report_count, COUNT(CASE WHEN r.`status` = 1 THEN 1 END) AS pending_count, COUNT(CASE WHEN r.`status` = 2 THEN 1 END) AS approved_count, COUNT(CASE WHEN r.`status` = 3 THEN 1 END) AS rejected_count FROM report_main r LEFT JOIN sys_user u ON r.user_id = u.id LEFT JOIN sys_college c ON u.college_id = c.id WHERE r.report_year = #{year} GROUP BY c.college_name ORDER BY c.sort_order

这个SQL查询的是各院系填报量和审核状态分布，后端返回List<CollegeReportStatDTO>，前端用ECharts的饼图、柱状图进行可视化展示。对于统计维度字段多的报表需求，也可以在sys_dict字典表里维护字段代码，实现灵活扩展。

热词搜索里频繁出现的“springboot整合redis”，在这个模块也有展开空间：把统计结果加一层Redis缓存，设置5分钟过期，避免报表页面反复点击给数据库造成压力。用Cacheable注解或者手动setIfAbsent都可以，校区量不大，实际效果未必看得出差距，但方案本身能写进论文的“系统优化”章节。

4. 开发环境与SpringBoot项目构建实录

4.1 用IDEA创建SpringBoot项目的关键步骤

用IDEA创建SpringBoot项目是毕设开发的第一步，这个过程中有几个细节不要踩坑。

第一步，在IDEA里选择 New Project -> Spring Initializr，Server URL保持默认的start.spring.io即可。选Java版本时注意与SpringBoot版本的对应关系。如果选了SpringBoot 2.7.x，JDK选8或11都行；如果选了3.x，JDK必须17+。

第二步，选Dependencies。建议至少包含：Spring Web、Spring Security、MyBatis Framework、MySQL Driver、Validation。如果还要做接口文档，加一个springdoc-openapi（Swagger3），但注意别把Swagger的守卫路径配错——否则线上接口文档会公开。SpringBoot 3.x下尽量用springdoc而不是springfox，后者不兼容Jakarta命名空间的问题非常烦人。

第三步，项目创建成功后，在pom.xml中确认parent版本。建议把spring-boot-starter-parent版本固定为2.7.18，这也是2.x系列的最终版本，稳定性最高。持续引用热词里“springboot版本太高”的场景，这里应当编写一个简明版本选型思路说明：版本选择依赖兼容性矩阵，而不是依赖最新发布日期。

在IDEA里配置启动端口也是热词边的常客（“idea 2026 怎么配置springboot服务 编辑配置数据 比如启动端口”）。实际上端口配置非常简单，在application.yml里加一行：

server: port: 8080

如果想在IDEA的Run Configuration里做临时覆盖，也可以在Environment variables里添加SERVER_PORT=8081。这个技巧在开发时很有用，尤其是你同时启动了后端和另一个模块时，不需要改配置文件就能切换端口。

4.2 Maven项目构建与依赖管理的几个常见操作

Maven是SpringBoot项目的基石。很多同学第一次遇到依赖反复报错、jar无法下载都出在Maven配置上。

先在IDEA中检查Maven settings：File -> Settings -> Build Tools -> Maven，确认Maven home path指向的是本地安装版本（建议3.8.x/3.9.x），而不是IDEA自带的。如果网络下载依赖慢，在settings.xml中配置阿里云镜像：

<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>

另外，SpringBoot项目的Maven构建方法一句话概括：在项目根目录执行mvn clean package -DskipTests即可产出可执行jar。如果打包时遇到spring-boot-maven-plugin没有把依赖打进去的问题，检查pom里是否引入了spring-boot-starter-parent，并且maven-compiler-plugin的source和target版本与JDK一致。

还有一个经典问题：需要引入本地外部jar包（比如学校发的SDK或Oracle驱动），常规的Maven中央仓库没有这个包。做法是把jar安装到本地仓库：

mvn install:install-file -Dfile=xxx.jar -DgroupId=com.schoollib -DartifactId=xxx-sdk -Dversion=1.0.0 -Dpackaging=jar

然后在pom.xml中按坐标引用。如果图省事直接在项目里建lib目录，则要配合systemPath或SpringBoot打包的includeSystemScope配置，不然打包后的jar会缺依赖，运行时ClassNotFound。

4.3 application.yml配置最佳实践

SpringBoot的核心配置集中在application.yml中，对毕设而言以下几项要特别留意：

spring: datasource: url: jdbc:mysql://localhost:3306/edu_report?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 20MB max-request-size: 100MB redis: host: localhost port: 6379 database: 0 server: port: 8082 mybatis-plus: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.edureport.entity configuration: map-underscore-to-camel-case: true

MySQL8的serverTimezone=Asia/Shanghai建议写明确，否则你部署到云端服务器时，和本地的时区不一致会导致查询出的时间相差8小时，这种问题几乎无从排查（只会觉得哪里不对）。字符集编码characterEncoding=utf8也必须写，否则中文乱码能气死人。

端口配置别用8080默认端口和你的前端开发服务器冲突，建议后端用8082，跨域代理统一到前端配置。就业后团队协作里也常见这种约定，application.yml分成application-dev.yml、application-prod.yml的思路在这里也可以介绍，答辩时能体现工程化意识。

4.4 登录认证：JWT还是Session方案

登录模块是SpringBoot后端开发的必修课。教研填报系统建议直接使用JWT做无状态认证。流程是：用户提交用户名密码，后端校验通过后生成一个JWT令牌返回前端；前端把令牌存储在本地（localStorage或Pinia），每次请求在Authorization header里带上Bearer token；后端使用拦截器或者Spring Security的OncePerRequestFilter解析JWT，获取用户ID和角色，放入SecurityContext。

具体代码片段（简化版JWT工具）：

@Component public class JwtUtils { @Value("${jwt.secret}") private String secret; @Value("${jwt.expire-hours}") private int expireHours; public String generateToken(Long userId, String username, String role) { return Jwts.builder() .setSubject(username) .claim("userId", userId) .claim("role", role) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() + expireHours * 3600 * 1000)) .signWith(SignatureAlgorithm.HS256, secret) .compact(); } public Claims parseToken(String token) { return Jwts.parser() .setSigningKey(secret) .parseClaimsJws(token) .getBody(); } }

记住：不要让密码以明文存储在数据库中。使用BCryptPasswordEncoder哈希后再存。手动插入初始管理员SQL时要在SQL里填充一个BCrypt加密后的字符串，常见误区是直接把明文123456填进去，导致登录永远失败（因为对比时用的是BCrypt算法）。

两个方案各说清楚优劣：

• JWT优点：后端无状态、支持多端、存在于Authorization头，适合前后端分离；
• JWT缺点：无法主动吊销、token泄露后有效期难控制，所以开发时要设置合理的过期时间（建议8~24小时）。

把这两点写进论文的“技术选型”章节，得分会上去不少。有的同学还会问“为什么不用Session”，此时先说明Session依赖服务端存储（存在内存/Redis中），在多实例部署时需要共享Session存储，而JWT天然免去这个复杂度。

4.5 Docker部署SpringBoot项目的实操记录

毕设最后如果能在部署环节亮个相，整个项目完成度会大大提升。用Docker部署SpringBoot项目是成本最低的部署方式。

先在项目根目录建一个Dockerfile：

FROM openjdk:8-jre-slim WORKDIR /app COPY target/edu-report-0.0.1-SNAPSHOT.jar app.jar EXPOSE 8082 ENV SPRING_PROFILES_ACTIVE=prod ENTRYPOINT ["java", "-jar", "app.jar"]

然后用Maven构建jar并构建镜像：

mvn clean package -DskipTests docker build -t edu-report:1.0 . docker run -d -p 8082:8082 --name edu-report \ -v /data/edu-report:/app/upload \ --env-file .env \ edu-report:1.0

这里的-v /data/edu-report:/app/upload是把宿主机目录挂载到容器内，让上传的文件不会因为容器重建而丢失；--env-file .env存放数据库密码等敏感配置。

如果是一台云服务器，还可以用docker-compose.yml一次性同时装配MySQL、Redis、后端服务，避免手工配置数据库连接。Compose文件里每个服务分别映射端口和存储卷，对于毕设项目它已经足够。注意：把数据库配置放到compose里时，不要写在镜像里，环境变量MYSQL_ROOT_PASSWORD单独管理。

5. 常见问题排查与避坑指南实录

5.1 SpringBoot版本带来的连环坑

“springboot版本太高”这个热词背后是很多同学换到SpringBoot 3.x后遇到的各种依赖不兼容问题。最常见的有：

• springfox-swagger2版本对SpringBoot 3.x完全不兼容，出现NPE或空指针；
• javax.servlet全被改为jakarta.servlet，导入路径全报错；
• 一些老的第三方starter包不支持JDK17的代理机制，容易方法调用报错。

排查的方式是看报错信息和依赖树（IDEA右下角Maven的Show Dependencies），不要盲目升级。换回SpringBoot 2.7.18是减少烦恼最快的路径，等基础功能全通后再单独升级也行。另外SpringBoot默认使用CGLIB动态代理，原因是JDK动态代理只能代理接口，若碰到目标类是类而不是接口的AOP场景，CGLIB会更适用；这在SpringBoot 2.x及以后已经是默认行为，很多文章和面试题都强调这一点，搞懂它会让你对Spring AOP的理解更立体。

5.2 前后端分离下的跨域问题

前后端分离项目必踩跨域坑。解决方案有两种：

后端全局配置CORS：

@Configuration public class CorsConfig implements WebMvcConfigurer { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**") .allowedOriginPatterns("*") .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS") .allowedHeaders("*") .allowCredentials(true) .maxAge(3600); } }

前端Vite配置开发代理：

server: { proxy: { '/api': { target: 'http://localhost:8082', changeOrigin: true, rewrite: path => path.replace(/^\/api/, '') } } }

菜鸟最容易犯的问题：后端配了跨域，但加了JWT拦截器时没有给OPTIONS预检请求放行，结果浏览器报了跨域错误但从后端日志看不出来。处理方式是在JWT过滤器中，对请求方法为OPTIONS的请求直接chain.doFilter放行，不然预检失败一切白费。

5.3 文件上传的路径与预览访问迷思

本地存储文件时，最常见的坑是上传成功后不知道文件访问到哪里。把file.upload-dir有写错（比如结尾少个/）会导致拼接路径错误；上传成功后把文件路径返回给前端时，不要返回本地磁盘绝对路径（如/data/...），而应该返回虚拟路径（如/files/2025/11/xxx.pdf），由前端拼接后端域名来预览。否则前端直接访问file:///data/...会打不开。

上传前要校验后缀白名单（.pdf,.jpg,.png,.doc,.docx），不能只在前端校验，这属于后端安全的基本功；同时要注意SpringMVC对MultipartFile的大小限制，如果线上部署后上传报MaxUploadSizeExceededException，就调整spring.servlet.multipart.max-file-size，然后在全局异常里拦截这个异常返回客户端友好提示。热词里的“springboot实现视频转码”虽然和本项目不相关，但文件上传模块的用户体验问题是同一个思路：“限制大小、限制类型、异步处理”。如果成果附件包含视频或大文件，这个思路可以展开，但毕设优先保交付质量即可。

5.4 时间字段、枚举与查询条件联动的坑

Java后端和MySQL交互时，实体字段建议统一用LocalDateTime，数据库字段用datetime；不要在实体里使用Date+SimpleDateFormat做手工格式化，Java 8的LocalDateTime配合Jackson可以自动完成JSON序列化。配置spring.jackson.date-format只对java.util.Date生效，LocalDateTime要用@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")或者全局注册JacksonCustomizer。

条件查询容易被忽视的是：如果前端传了startDate但没传endDate，后端对空值要判断；mybatis-plus的条件构造器里between需要两个参数都非空才追加。这类细节不处理，就会出现“根据日期查询老是无结果”的诡异问题。

5.5 部署后的502/404/端口冲突排查

云端部署后常见的三种故障：502 Bad Gateway、404、端口被占用。

• 502一般发生在Nginx反代后端时，后端服务没起来或监听在127.0.0.1而不是0.0.0.0。SpringBoot默认会监听所有地址，不需要特别修改，但如果改了server.address配置，要留意；
• 404多半是Nginx的location路径没匹配到后端，或者是前端路由用了history模式但Nginx配置里没有try_files回退到index.html；
• 端口被占用时，Linux下用netstat -tunlp | grep 8082找出PID，kill -9那是最后的手段，审题上要能解释为何服务未正常退出。

我建议在服务器上用docker logs -f edu-report看后端日志，而不是直接改代码重发。很多部署排查都能从日志里直接找到原因。

6. SpringBoot面试与答辩加分点梳理

6.1 SpringBoot自动装配原理怎么讲才高分

“说说SpringBoot的自动装配原理”几乎是必考面试题，也是答辩问答环节的经典问题。可以按这个逻辑讲：

SpringBoot项目的启动类上有@SpringBootApplication，它由@EnableAutoConfiguration、@SpringBootConfiguration、@ComponentScan三个注解组合而成。其中@EnableAutoConfiguration通过AutoConfigurationImportSelector加载META-INF/spring.factories（SpringBoot 2.7及以前）或META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports（SpringBoot 3.0及以后）中注册的自动配置类。

然后以MyBatis的自动配置举例：引入了mybatis-spring-boot-starter后，自动配置类MybatisAutoConfiguration生效，它创建一个SqlSessionFactory，扫描@Mapper接口，并通过条件注解（如@ConditionalOnClass、@ConditionalOnMissingBean）在缺少对应Bean时才进行配置，这就是“约定优于配置”的实现基础。讲解时不要只背概念，要能说出spring.factories、AutoConfigurationImportSelector、@ConditionalOnMissingBean几个关键名词，再有项目代码的例证就更有说服力。

6.2 SpringBoot的代理机制与事务失效场景

SpringBoot默认使用CGLIB动态代理，这是Spring Framework 6.0开始的默认行为（SpringBoot 2.x + Spring Framework 5.x下，如果类有接口也会默认用JDK动态代理，直到spring.aop.proxy-target-class=true被设置为true）。了解这一点对避免事务失效很有帮助。例如在一个Service里调用同一个类的另一个@Transactional方法时，由于走的是this引用，没有经过代理对象，事务配置不会生效。解决方式要么拆到不同的Service，要么用AopContext.currentProxy()。这个问题虽然偏高级，但提到项目里有涉及到提交流程的事务场景（保存主表+子表）的话，非常值得写进答辩准备笔记。

6.3 系统扩展方向：若依框架与中大型后台的通用解法

很多人在毕设做后台管理系统时会参考若依（RuoYi）的开源脚手架，它本质上是SpringBoot + Vue/Thymeleaf的中后台快速开发框架，内置了用户、角色、菜单、字典、定时任务、代码生成器等功能，覆盖了大量高校管理类系统的通用需求。

毕设项目中不一定非要用若依全套框架，但可以参考它的几种做法：字典表统一管理枚举值和前端下拉选项；菜单权限动态生成路线；代码生成器快速生成CRUD前后端代码。如果论文的后续工作里有“系统可推广到其他高校”这类描述，说“参照若依的通用RBAC设计，抽出可复用的权限模块”是非常合理的扩展思路。

6.4 更进一步的延伸：从单体到微服务与消息队列

教研填报系统的业务规模其实不需要上微服务，但是在“系统展望”章节可以做技术延伸展示思考深度。例如：教务系统与人事系统数据互通时，可以引入消息队列（如RocketMQ）做异步解耦——教师提交成果后，后端向消息队列发一条通知，学校中间件消费后同步到科研管理平台。热词中的“springboot整合activemq”或RocketMQ可以放进一个rabbitMQ/RocketMQ消费者模块的演示。这样既没有过度设计，又体现了扩展能力。

另外可以将填报附件转存到MinIO、试卷和成绩同步、跨校区同步，这类场景用消息队列和对象存储组合是标准的分布式系统解决方案。写“展望”时点到为止，不要真把这个做成主线功能，否则会被评委追问实现细节。

面试中如果被问“为什么不用微服务”，正确答法不是批判微服务，而是说明“业务规模不具备千万级请求的并发基础，单体架构能极大降低运维复杂度，而且数据库耦合度低、领域边界清晰的前提下，未来拆分成多个业务服务是可行的”。

收尾前的一个实用小技巧

我自己在做这类系统时有一个固定习惯：在开发阶段先建一个“造数服务”或直接写SQL存储过程，批量生成1000条以上的模拟数据（多个学院、多个年份、多个成果类型），这样在测试列表分页、统计图表、导出Excel时，效果会直观很多。毕设演示时如果数据库只有十条记录，评委看不出系统处理压力的能力；有了一千条，分页、统计、导出的效果会非常真实。

另外，在答辩前要为每个角色分别准备演示账号：教师号（待审核状态的数据）、院系审核号（有待办列表）、管理员号（汇总统计全量数据）。演示时先从教师填报一条数据，到院系审核通过，再到管理员统计页面刷新出该条记录，一条完整的全链路演示，比零散展示几个页面更有说服力。

做这个项目的过程中我最大的体会是：SpringBoot不是靠背知识点学会的，而是靠把一条请求从浏览器走到数据库再返回浏览器的全过程亲手串起来才真正理解的。教研填报系统麻雀虽小，但借由它，你会把认证、权限、状态流转、文件上传、Excel处理、统计报表、部署上线全部踩一遍，这对项目的完整性理解和后续找工作时的项目面试都极有价值。希望这篇拆解能帮你在做毕设的路上少走一些弯路。