1. 这个毕设到底在做什么论文管理系统背后的真实需求先说清楚高校学位论文全流程管理平台这个题目在计算机毕设里属于典型的“中大型业务系统”方向。它不追求算法难度也不考什么高深框架原理核心考察的是你对 Java Web 业务系统的整体把控能力——需求建模、数据库设计、权限控制、流程状态机、文件处理、前后端协作这些才是评委真正会盯住的地方。我第一次带类似的毕设时很多学生以为这系统就是做个“论文上传下载网站”结果一做就发现根本不是那么回事。真正的论文管理流程从学生选题就开始了后面跟着开题报告、任务书、中期检查、初稿提交、查重报告、指导老师意见、评阅打分、答辩分组、最终归档一整套走下来至少涉及六七个状态节点、四五个角色。一个“管论文的系统”本质上是把一个学校教务部门多年沉淀下来的流程规则搬到线上让线上的状态流转和线下的纸质表格保持一致这才是这个题目的核心价值。这类系统解决的痛点很具体指导老师记不住自己带了多少个学生、每个学生的进度到哪一步学生搞不清自己该交什么东西、截止日期是什么时候教务处收集中期材料时要一个个核对表格版本答辩分组排考场全靠手算。上线一个管理系统之后所有进度变成可视化的数据每个角色只看到自己该看的内容该提醒的有提醒、该审批的有审批整个周期从混乱变成有序。适合拿这个题目做毕设的人群也很明确第一类是已经学过 Spring Boot 基础、但还没做过完整项目的同学用它来把知识串成体系第二类是打算走 Java 后端方向、想在校招简历里放一个“能讲清楚业务、能画出架构图”的项目的人。这个题目做完你能讲明白的东西——RBAC 权限模型、状态机设计、文件存储策略、多角色视图分离——恰好都是企业级项目面试里常问的点。2. 整体设计与思路拆解为什么选 Spring Boot功能边界怎么划2.1 技术选型不是炫技是为了“能落地”Spring Boot 在 Java 毕设中的地位基本上就是“默认答案”但你要能说清楚为什么是它而不是别的。市面上也没有别的选择Py 系有 Django、FlaskNode 系有 Express但从教学、资料密度、面试认可度三个维度看Spring Boot 的综合匹配度最高。具体展开说Spring Boot 的优势体现在四个层面。第一是自动配置机制它把 Spring 家族里大量繁琐的 XML 配置收敛成了一堆 starter一个spring-boot-starter-web就把内嵌 Tomcat、Spring MVC、Jackson 全带进来了小团队做业务系统时不需要一开始就去抠底层配置能把精力放在业务流程上。第二是生态完整做论文管理系统需要什么组件几乎都有现成 starter——操作数据库有spring-boot-starter-data-jpa或 MyBatis做权限校验有 Spring Security 或 Sa-Token做参数校验有spring-boot-starter-validation文件存储可以用集成 MinIO 的 starter省下了造轮子的时间。第三是部署简单打成 jar 一行java -jar就能跑起来评委验收时不用装 Tomcat、配环境演示成本低印象分自然高。第四是资料可查遇到任何报错搜“Spring Boot 具体关键词”基本都能找到博客或官方文档这一点对毕设时间紧张的同学来说是隐形的救命稻草。那为什么不用微服务这是我在辅导时经常要强调的一点。毕设的项目体量用户量级就是本校几千人一个单体应用把所有功能放在一个工程里逻辑清楚、部署简单、排错容易。硬拆微服务引入注册中心、网关、分布式事务这些概念不仅工作量爆炸答辩时如果说不清楚每个组件带来的真实收益反而会被评委追问到怀疑人生。单体优先这是业务复杂度决定的不是技术落后。2.2 功能模块与角色权限先想清楚“谁用什么”论文管理系统的功能边界我建议直接按角色来划分因为用户的诉求就是权限设计的第一手需求。系统里一共有四类角色学生、指导老师、教务管理员、系统管理员。不需要再做复杂的部门层级或跨学院权限本科毕设的场景里这些角色已经覆盖了所有操作入口。学生端的功能是查看论文流程的当前节点和待办事项、下载任务书模板、提交开题报告、上传论文初稿和终稿、查看指导老师反馈意见、申请答辩。指导老师端查看名下学生列表、审阅开题报告和论文、填写指导意见和评分、给学生选题打通过或退回标记。教务管理员端维护论文周期的时间节点比如“开题截止时间是几号”“查重截止时间是几号”、做查重结果导入、安排答辩分组和评委、汇总最终成绩和归档状态。系统管理员端就是基础的账号维护、角色分配、数据初始化。这个权限模型对应到数据库设计中就是经典的 RBAC 四张表用户表、角色表、用户角色关联表、菜单权限表。不需要细粒度到按钮级别的权限控制角色到菜单、接口到角色两级就够了。我见过有同学把权限表设计成八九张表还带操作日志审计实际意义不大反而增加了答辩时解释的复杂度。2.3 论文流程的状态机设计不要让代码散落成 if-else整个系统里最容易被忽视、但也是最值得在答辩中拿出来讲的是“流程状态机”的设计。论文从选题到归档每一个环节都不是孤立的下一个步骤能不能做取决于上一个步骤有没有通过。比如学生上传了开题报告状态变成WAITING_REVIEW指导老师审核打回状态回退为REJECTED学生修改后重新提交状态再变成WAITING_REVIEW只有审核通过才开放中期报告的上传入口。如果用一堆 if-else 写在 Service 里状态流会越来越难维护。更清晰的做法是先把全流程的状态枚举定义出来再用一张独立的流程表去记录每篇论文当前所处的节点。我把状态定义放在一个枚举类里代码是这样public enum ThesisStatus { SELECTION_PENDING(选题待确认, 1), SELECTION_APPROVED(选题已通过, 2), OPENING_REPORT_REVIEW(开题报告审核中, 3), OPENING_REPORT_PASSED(开题报告已通过, 4), MIDTERM_REVIEW(中期检查阶段, 5), INITIAL_DRAFT_UPLOADED(初稿已提交, 6), REVISION_REQUIRED(需要修改, 7), FINAL_SUBMITTED(终稿已提交, 8), DEFENSE_ARRANGED(已安排答辩, 9), ARCHIVED(已归档, 10); private final String description; private final int order; }每个状态之间的跳转我在 Service 层做一个统一的transition(currentStatus, targetStatus, role)方法只有定义了合法迁移路径的状态变化才允许执行。这样做的好处是答辩时你可以直接画出一张状态流转图评委一眼就能看出你理解业务流程。2.4 数据库设计几张核心表怎么建论文管理系统的表我建议控制在 12 到 15 张。核心的是这几张thesis表是主体字段包括student_id、title、status、topic_source选题来源可选项是指导教师命题和学生自拟、thesis_type毕业论文还是毕业设计、final_score、archive_url。这张表的设计要点是不要把所有内容都塞进去比如查重报告、开题报告这些是附件应该单独用文件表记录。thesis_file表记录所有上传的文件字段包括thesis_id、file_type枚举任务书、开题报告、中期报告、初稿、终稿、查重报告、file_name、file_path、file_size、upload_time。把文件信息和业务主体分开是为了后面扩展文件版本控制时不用动主表结构。review_record表记录每一次审核行为字段包括thesis_id、reviewer_id、review_type开题审核、中期审核、定稿评定、result通过/退回、comment、review_time。这张表其实也承担审计职责学生和老师都能看到历史审核记录避免出现“我明明交了你却说没收到”的扯皮。defense_group和defense_score是答辩环节的表前者记录分组信息和答辩时间地点后者记录评委给学生打的分。答辩分数的计算方式需要注意一个组通常有 3 位评委总分的算法是去掉最高分最低分再取平均这部分可以直接在 SQL 里用窗口函数做。建表的 SQL 里所有时间字段我用datetime状态字段用tinyint配合枚举翻译外键只建逻辑关联不建物理约束。物理外键在并发写入时会影响性能而且一旦数据初始化时顺序错了外键约束会直接让插入失败毕设阶段没必要给自己加这些负担。3. 核心细节解析与实操要点3.1 登录认证从 Session 到 JWT 的选择论文管理系统的登录认证我推荐用 JWT而不是传统的 Session 方案。不是因为 JWT 更“高级”而是因为前端如果用 Vue 来做后续接口调用时把 token 放在请求头里比操作 cookie 要顺手得多。具体实现上用户提交账号密码后后端接口校验通过生成一个 token 返回给前端。token 的 payload 里只放userId、role、expireTime不放任何敏感信息。我这里用一个自己封装的工具类来生成public class JwtUtil { private static final String SECRET_KEY your-256-bit-secret; public static String generateToken(Long userId, String role) { return Jwts.builder() .setSubject(userId.toString()) .claim(role, role) .setExpiration(new Date(System.currentTimeMillis() 2 * 60 * 60 * 1000)) .signWith(SignatureAlgorithm.HS256, SECRET_KEY) .compact(); } }生成 token 之后需要写一个拦截器或者过滤器在每个请求进来时解析 token、判断角色是否有权限访问该接口。我用 HandlerInterceptor 实现了一个简单的认证拦截public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { String token request.getHeader(Authorization); if (token null || !JwtUtil.validateToken(token)) { response.setStatus(401); return false; } // 把 userId 和 role 存入 request attribute后续 controller 里直接用 request.setAttribute(userId, JwtUtil.getUserId(token)); request.setAttribute(role, JwtUtil.getRole(token)); return true; } }有个细节容易踩坑JWT 的密钥千万不要硬编码在代码里。虽然这是毕设项目但把密钥放到application.yml的配置项里既方便修改也是好习惯。另外 token 的有效期建议设置为 2 小时前端在拿到 401 响应时自动跳回登录页体验会比“一直可用但身份过期”更清晰。3.2 文件上传与在线预览论文系统最核心的功能论文管理系统如果没有文件上传整个流程就断了。这个模块看起来简单但有几个坑必须在设计阶段就避开。第一个坑是文件大小限制。Spring Boot 默认的上传大小上限是 1MB而一篇带图表的论文终稿动辄几十 MB如果不配置学生上传到一半直接被拒绝。需要在配置文件里放开限制spring: servlet: multipart: max-file-size: 100MB max-request-size: 200MB第二个坑是文件存储的位置。我推荐把文件存在服务器的本地磁盘路径按年/学院/学号/文件类型这样的目录结构组织。不要直接存在项目的resources目录下因为项目打成 jar 包运行后jar 内部是只读的写入会直接报错。合理做法是在配置里指定一个外部绝对路径file: upload-dir: /data/thesis_files/上传接口核心代码PostMapping(/upload) public Result upload(RequestParam(file) MultipartFile file, RequestParam(thesisId) Long thesisId, RequestParam(fileType) String fileType) { // 校验文件类型只允许 pdf、doc、docx、zip String originalFilename file.getOriginalFilename(); String suffix originalFilename.substring(originalFilename.lastIndexOf(.)); ListString allowed Arrays.asList(.pdf, .doc, .docx, .zip); if (!allowed.contains(suffix.toLowerCase())) { return Result.error(不支持的文件格式); } // 构建存储路径文件名带上时间戳防止重名覆盖 String uploadPath fileUploadDir / thesisId / fileType /; File dir new File(uploadPath); if (!dir.exists()) { dir.mkdirs(); } String storedName System.currentTimeMillis() _ originalFilename; file.transferTo(new File(uploadPath storedName)); // 落库记录文件信息 thesisFileService.saveFileInfo(thesisId, fileType, originalFilename, uploadPath storedName); return Result.success(); }文件预览这块如果是 PDF后端可以直接返回文件流让浏览器内嵌打开如果是 Word浏览器不支持直接内联预览最简单的做法是提示用户下载后用本地软件查看或者把 Word 通过 OpenOffice 转 PDF 预览。毕设阶段不建议折腾 word 转 pdf 的服务复杂度高且不稳定直接提供下载入口就好。3.3 多角色数据隔离同一个页面不同人看到不同内容接口设计中最容易犯的一个错误是给前端返回数据时没有做角色维度的过滤。比如学生登录后调getThesisList理论上只应该看到自己的论文但如果接口里没有WHERE student_id ?这个条件学生把接口地址改一下参数就能看到别的学生的数据这在答辩演示时一旦被发现是非常致命的安全漏洞。我处理这个问题的方式是不信任前端传的任何 id 参数当前操作人的 userId 一律从登录态里获取。比如学生查询自己的论文列表GetMapping(/myThesis) public Result getMyThesis(HttpServletRequest request) { Long userId (Long) request.getAttribute(userId); ListThesisVO list thesisService.listByStudentId(userId); return Result.success(list); }老师查询名下学生也是同理从登录态拿 teacherId而不是让前端把老师 id 传过来。这条经验在工作中的系统开发里同样成立永远不要相信前端传来的身份信息。3.4 前端页面设计不做花哨 UI但要有完整闭环前端这块很多同学喜欢一上来就搞 Element UI 各种组件炫技实际上论文管理系统最适合的前端方案是 Vue Element Plus 的后台管理模板比如 vue-element-admin 或者 RuoYi 这样的开源骨架。直接用现成的后台模板登录页、菜单栏、路由权限、表格组件全都有了你只需要把接口对接上就行。页面清单大概是登录页、学生工作台流程进度 待办提醒、论文提交页分步骤上传各类材料、教师审阅页列表 详情 审核操作、管理员设置页周期配置 查重导入 答辩分组、成绩汇总页按学院/专业统计。一个加分项是把论文流程做成可点击的步骤条。学生登录后能看到自己正处在整个流程的第几步每步是绿色已完成、橙色进行中还是灰色未开始。这是业务系统里常见的“进度可视化”建议作为重点页面来展示答辩效果好。4. 实操过程与核心环节实现从建表到跑通全流程4.1 项目初始化与依赖引入创建一个 Spring Boot 项目我建议用 start.spring.io 直接在线生成Java 版本选 8 或 11Spring Boot 版本选 2.7.x 这种稳定版本。版本选型上有讲究Spring Boot 2.x 搭配 JDK 8 是最常见的教学环境组合兼容性最好如果选了 Spring Boot 3.x要求 JDK 17 起步很多老教程的依赖坐标对不上光是启动报错就能折腾两天。我常用的 pom.xml 依赖如下dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.0/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependenciesORM 层我在 MyBatis 和 JPA 之间推荐 MyBatis。原因很实际MyBatis 的 SQL 是写死的你能精确控制每一条查询语句出问题时排查思路非常直接JPA 虽然自动建表和增删改查很省事但一旦涉及复杂查询它的方法命名和 JPQL 对新手来说很容易写出 N1 查询问题答辩时被问“这个查询走了几条 SQL”就会很被动。4.2 数据库建表脚本一张初始化 SQL 搞定我提供一份简化版的建表 SQL覆盖最核心的几张表。实际项目里可以在此基础上扩展字段。-- 用户表 CREATE TABLE sys_user ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 主键, username VARCHAR(50) NOT NULL COMMENT 登录账号, password VARCHAR(100) NOT NULL COMMENT BCrypt加密后的密码, real_name VARCHAR(50) COMMENT 姓名, role VARCHAR(20) NOT NULL COMMENT STUDENT/TEACHER/ADMIN, college VARCHAR(100) COMMENT 学院, major VARCHAR(100) COMMENT 专业, student_no VARCHAR(20) COMMENT 学号, phone VARCHAR(20) COMMENT 联系电话, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT系统用户表; -- 论文表 CREATE TABLE thesis ( id BIGINT NOT NULL AUTO_INCREMENT, student_id BIGINT NOT NULL COMMENT 学生用户ID, teacher_id BIGINT COMMENT 指导老师用户ID, title VARCHAR(200) COMMENT 论文题目, status INT NOT NULL DEFAULT 1 COMMENT 当前流程状态对应枚举值, topic_source VARCHAR(20) COMMENT 选题来源老师命题/学生自拟, thesis_type VARCHAR(20) COMMENT 毕业论文/毕业设计, final_score DECIMAL(5,2) COMMENT 最终成绩, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT论文信息表; -- 论文文件表 CREATE TABLE thesis_file ( id BIGINT NOT NULL AUTO_INCREMENT, thesis_id BIGINT NOT NULL, file_type VARCHAR(30) NOT NULL COMMENT 任务书/开题报告/中期报告/初稿/终稿/查重报告, file_name VARCHAR(200) NOT NULL COMMENT 原始文件名, file_path VARCHAR(500) NOT NULL COMMENT 存储路径, file_size BIGINT COMMENT 文件大小字节, upload_user_id BIGINT NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT论文文件表; -- 审核记录表 CREATE TABLE review_record ( id BIGINT NOT NULL AUTO_INCREMENT, thesis_id BIGINT NOT NULL, reviewer_id BIGINT NOT NULL, review_type VARCHAR(30) NOT NULL COMMENT 开题审核/中期审核/定稿评定, result TINYINT NOT NULL COMMENT 1通过 2退回, comment VARCHAR(500) COMMENT 审核意见, review_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT审核记录表;密码字段统一用 BCrypt 加密存储这一步不要省。Spring Security 或者spring-security-crypto单独引一个包就能拿到BCryptPasswordEncoder直接encoder.encode(password)就能用答辩时如果有人提“明文密码泄露”的问题这就是你的防护证据不用多解释。4.3 后端分层结构 Controller 只做转发别写业务Java 后端代码风格上有一个“三层结构”惯例Controller 只接收参数和返回结果不写任何业务逻辑Service 层承载业务规则Mapper/Dao 层做数据库交互。这个结构看起来老生常谈但很多同学写着写着就违反了。比如上传论文文件一个不好的写法是在 Controller 里直接操作 File 对象、调 Mapper 存数据库、还自己判断文件类型把整个上传逻辑全塞在一个方法里。一段 200 行的 Controller既难读也难以测试。正确的做法是 Controller 只做三件事接收参数、调用 Service、返回统一结果对象。统一返回对象我之前用的是这种Data public class ResultT { private int code; private String msg; private T data; public static T ResultT success(T data) { ResultT result new Result(); result.code 200; result.msg success; result.data data; return result; } public static T ResultT error(String msg) { ResultT result new Result(); result.code 500; result.msg msg; return result; } }所有接口统一返回Result对象前端拿到code ! 200就直接弹msg这样的好处是整个项目的异常处理路径是单一的不会出现“这个接口返回 null、那个接口返回空字符串”的混乱局面。4.4 关键流程实现选题申请与审核选题是整个流程的第一环。学生提交选题申请提交内容包括题目、选题来源老师命题还是自拟、选题理由。老师端收到申请后可以选择通过或退回退回时必须填写意见。Service 层的核心逻辑Service public class ThesisServiceImpl implements ThesisService { Override public void submitTopicSelection(Long studentId, TopicSubmitDTO dto) { // 1. 创建 thesis 记录初始状态为 SELECTION_PENDING Thesis thesis new Thesis(); thesis.setStudentId(studentId); if (dto.getTeacherId() ! null) { thesis.setTeacherId(dto.getTeacherId()); } thesis.setTitle(dto.getTitle()); thesis.setTopicSource(dto.getTopicSource()); thesis.setThesisType(dto.getThesisType()); thesis.setStatus(ThesisStatus.SELECTION_PENDING.getOrder()); thesisMapper.insert(thesis); } Transactional Override public void reviewTopic(Long thesisId, Integer result, String comment) { Thesis thesis thesisMapper.selectById(thesisId); if (thesis.getStatus() ! ThesisStatus.SELECTION_PENDING.getOrder()) { throw new BusinessException(当前状态不可审核); } // 2. 记录审核意见 ReviewRecord record new ReviewRecord(); record.setThesisId(thesisId); record.setReviewType(选题审核); record.setResult(result); record.setComment(comment); reviewRecordMapper.insert(record); // 3. 更新论文状态 if (result 1) { thesis.setStatus(ThesisStatus.SELECTION_APPROVED.getOrder()); } else { thesis.setStatus(ThesisStatus.SELECTION_PENDING.getOrder()); } thesisMapper.updateById(thesis); } }这里必须使用Transactional事务注解因为“写审核记录”和“更新论文状态”是两步操作任何一个失败都会导致数据不一致。这个点值得在答辩时主动提出来属于加分细节。选题审核通过后学生端界面解锁开题报告上传入口整个流程进入下一环。4.5 答辩安排双评委评分与自动汇总答辩安排这个功能看似简单却涉及一个多对多的关系设计问题一个答辩组有多个学生一个组有多个评委老师。我的表结构是defense_group和defense_student、defense_score。分组信息确定后管理员把学生批量加入某组每组配置两到三个评委。评委登录系统后在“答辩评分”菜单里看到自己所在组的学生列表逐个打分、填写评语。defense_score表的设计CREATE TABLE defense_score ( id BIGINT NOT NULL AUTO_INCREMENT, defense_group_id BIGINT NOT NULL, student_id BIGINT NOT NULL, judge_id BIGINT NOT NULL COMMENT 评委用户ID, score DECIMAL(5,2) COMMENT 评分, comment VARCHAR(500) COMMENT 评语, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_student_judge (student_id, judge_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT答辩评分表;评分完成后系统按“去掉最高最低分取平均”的规则自动算出每个学生的答辩成绩。这里如果用 SQL 可以直接用COUNT判断评委人数再决定算法但做成 Service 逻辑更易懂。成绩确认后汇总到thesis.final_score。4.6 演示数据的初始化别让评委看到一个空系统验收答辩时最尴尬的场景就是评委打开系统发现论文列表是空的想要演示审核流程都没有数据可看。所以项目里一定要额外准备一个数据库初始化脚本填充几组演示数据。我通常手动造三组数据一个学生账号一个老师账号一组完成开题报告待审核的数据一组从初稿到终稿都走完的数据。光有账号还不行还需要在thesis_file表里预先插入几条文件记录。但这个数据一定不要用压缩包因为答辩现场如果演示下载不管用这些预置文件的其他功能展示都会受影响。我测试下来实际上传一个几十 KB 的 PDF 作为演示素材反而是最稳妥的纯文本类材料用真实的也行主要脚本控制好上传的 mime 类型判断。插入演示数据的代码可以用CommandLineRunner来实现应用启动时检测到没有初始化过就自动写入演示时打开系统直接就能看到完整流程不用手动去找账号密码配数据。5. 常见问题与排查技巧实录5.1 Spring Boot 启动后页面端口被占用、上传文件失败我见过最频繁的启动问题就是端口被占用。本地开发的端口是 8080如果上次关掉应用时连接没有完全释放再次启动就直接报Port 8080 was already in use。排查时可以换一个端口比如 8081跳过这个报错但建议还是先找到占用进程用命令行排查。我自己的处理习惯是直接改配置文件把开发端口定为 8088这样可以避免和其他 Spring Boot 项目撞车。要是实在想让应用固定 8080 端口可以在application.yml里加上server.port: 8088运行时生效。上传相关的报错重点关注两个地方一是配置文件是否真的生效了二是上传目录的写权限。文件上传路径设置为/data/thesis_files/后在 Windows 本地开发时需要改成相对路径或直接放到项目目录下如果忘了把路径改成./files/在 Windows 上很容易因为路径不存在创建失败。最隐蔽的问题出在file.transferTo()方法上如果你传入的目标路径是一个不存在的目录它会抛IllegalStateException。所以我在上传前始终有一段mkdirs()逻辑这是从实际报错里总结出来的。5.2 JWT 登录后跨域请求失败跨域问题是前后端分离项目跑起来后第一个遇到的问题。前端在localhost:5173起服务后端在localhost:8088前端一调接口就报跨域错误。解决方式是在后端加一个全局 CORS 配置类Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(http://localhost:*) .allowedMethods(GET, POST, PUT, DELETE) .allowedHeaders(*) .allowCredentials(true) .maxAge(3600); } }这里有个细节用了 JWT 之后前端请求会带Authorization请求头如果再允许携带 cookie 的话跨域选项必须同时配置好。如果还是报跨域优先检查是不是拦截器先于 CorsFilter 执行了导致请求在到达 Controller 之前就被拦了那需要在拦截器里放行OPTIONS请求。5.3 多表联查时字段歧义、性能差论文列表页往往要同时显示学生姓名、指导老师姓名、当前状态、提交时间这些信息分布在三张表里最常见的写法是在 Service 层先查论文表拿到studentId后再循环查询用户表这就是典型的 N1 问题几百条数据页面要卡几秒钟。正确做法是在 Mapper 里直接用一条连表查询完成。我写了一个 VO 类ThesisVO它和实体类的区别在于多了studentName、teacherName这类冗余展示字段查询时从三张表里 join 出来直接填充。5.4 状态流转出现非法操作有些同学在测试时发现学生跳过中期检查直接上传终稿或者被退回的开题报告还能直接提交初稿。这个问题的根源在于后端接口没有校验步骤前置条件只依赖前端按钮的显隐控制。前端隐藏按钮并不安全因为接口是可以被直接调用的。我的处理方式是写一个状态校验的公共方法在每个提交接口的入口调用private void checkStatus(Thesis thesis, int expectedStatus) { if (thesis.getStatus() ! expectedStatus) { throw new BusinessException(当前状态不支持该操作); } }维护这个状态规则的核心是把合法状态流转路径放在一个配置类里维护而不是散落在各个 Service 方法里。这样改流程时只动一处配置也方便答辩时展示状态机设计思路。6. 我的实战体会从零到验收几个最值得记住的教训带这个项目走过完整流程之后我总结了几条踩出来的经验放在最后分享。第一数据库设计时间占比要够。花一个周末把 ER 图和数据字典画清楚后面写代码的效率会翻倍。很多同学边写代码边改表结构Mapper 层各类selectById反复删改这是最浪费时间的方式。建议先建库建表插入几条模拟数据和后端实体类一一对应好了再开始写接口。第二演示文档要提前准备。这里的演示文档指的是一张“功能运行手册”里面写清楚每个角色的账号密码、演示路径、对应的关键数据。答辩前自己完整走三遍流程连续走一遍不卡壳现场就不容易出问题。第三代码注释和命名规范别偷懒。这个项目的代码量不算大但类名和方法名是否规范在答辩时体现出的专业度差距很大。比如接口路径用/api/thesis/submitTopic这种一眼能看懂的风格方法名用submitTopicSelection、reviewTopic而不是handle1、do2细节积累起来就是别人评判你工程素养的依据。第四状态机设计值得在答辩时作为核心亮点来讲。很多毕设做的是“记录型系统”而论文管理是一个“流程型系统”你能讲清楚每个状态由谁触发、由谁审批、在什么条件下流转就已经超越了一大半只做增删改查的毕设。如果你拿到了这个题目不用慌。它的核心不是创新算法而是把一套常见的业务规则做得完整、闭环、可演示。技术栈都是成熟方案资源丰富到几乎不存在卡住三天的问题。沉住气按流程设计、数据库设计、编码、联调、演示准备这个顺序走下来你会在这个过程中得到一个真正能代表自己能力的项目。