简介这份资源是面向高校计算机相关专业毕业生的Spring Boot大创管理系统毕业论文文档适合正在准备毕业设计、需要参考完整论文结构与项目实现思路的学生。文档围绕大学生创新创业项目管理场景梳理了学生、指导老师、院系管理员三类角色的申报、审核、评审与结项流程并给出SSM框架与MySQL数据库的技术选型说明。压缩包共1个doc文件约2.57MB内容涵盖摘要、需求分析、可行性分析、功能与业务流程分析、数据库ER图与数据字典、数据流图、详细设计、系统截图、测试及总结等章节结构完整、逻辑清晰。已有134人学习可作为论文写作框架与系统设计说明的参考样本帮助读者快速把握从需求到测试的论述脉络理解B/S模式下管理系统的设计要点与文档组织方式。1. 从一份“能跑起来的论文”说起大创管理系统到底解决了谁的麻烦每年三四月高校里管大创项目的老师最头疼的不是评审本身而是收表。学生交上来的申报书散在邮箱、微信群、共享文档里中检材料拖到截止日还在催结项报告和评审意见对不上号最后归档时发现某个项目的指导老师签字页丢了。这套基于 Spring Boot 的大创管理系统就是冲着这条链路去的把项目申报、中检、结项、评审、专家分配全部收进一个 B/S 后台学生、指导老师、院系管理员三个角色各看各的菜单数据落在 MySQL 里不再靠人肉对表。它适合两类人一是要交课程设计或毕业设计、需要一套结构完整可演示的 Java Web 项目二是真想给院系搭个轻量项目管理系统、又不想上重型平台的开发者。下面按“能干什么、怎么跑、怎么改”拆开讲。2. 系统骨架与角色权限三个角色、十一个功能模块怎么落到代码里2.1 技术栈选型SSM 打底Spring Boot 做启动器这个项目的技术组合在同类里算标准配置Spring Boot 负责启动和自动装配Spring MVC 接管请求路由MyBatis 做持久层MySQL 存数据前端是 JSP 或 Thymeleaf 模板加 Bootstrap 那一套。论文正文里写的是 SSM 框架摘要里又提 Spring Boot实际落地时通常是“Spring Boot 整合 SSM”的写法——用 Spring Boot 的 starter 把 Spring、Spring MVC、MyBatis 串起来省掉大量 XML。常见做法是在pom.xml里引这几个依赖!-- Spring Boot Web内嵌 Tomcat Spring MVC -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis 与 Spring Boot 整合 -- dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.1/version /dependency !-- MySQL 驱动 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency这段依赖的关键点在于mybatis-spring-boot-starter它会把DataSource、SqlSessionFactory、MapperScannerConfigurer自动配好你只需要在启动类上打MapperScan(com.example.mapper)Mapper 接口就能被注入。版本号这里给的是常见可用组合实际以你本地 JDK 为准——论文里明确写了 JDK 1.8那就别上 Spring Boot 3.x3.x 要求 JDK 17这是新手最容易翻车的地方。2.2 角色与菜单权限不是靠前端藏按钮系统定义了三个角色学生、指导老师、院系管理员。从功能清单看指导老师和管理员的菜单高度重合都有优秀项目管理、项目类型管理、项目信息管理、项目申报/中检/结项/评审管理、专家评审管理、评审方案管理学生则多了大创资讯浏览少了类型和方案维护。这种“菜单重合但数据范围不同”的结构落地时一般用一张user表加role字段区分登录后把角色写进 Session拦截器按角色放行 URL。// 登录拦截器按角色校验访问路径 public class RoleInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest req, HttpServletResponse resp, Object handler) throws Exception { HttpSession session req.getSession(); Object user session.getAttribute(loginUser); if (user null) { // 未登录一律打回登录页 resp.sendRedirect(/login); return false; } String role (String) session.getAttribute(role); String uri req.getRequestURI(); // 学生不允许进入类型管理、评审方案维护等后台路径 if (student.equals(role) (uri.startsWith(/projectType) || uri.startsWith(/reviewPlan))) { resp.sendError(403, 无权限访问); return false; } return true; } }这里要说明的是loginUser和role是登录成功时塞进 Session 的两个键拦截器只做粗粒度路径拦截真正的数据隔离还得在 Service 层补——比如学生查项目申报列表时SQL 里必须带where student_id #{currentUserId}否则学生能看到别人的申报书这是这类系统最常见的权限漏洞。前端藏菜单只是体验优化不能当安全边界。2.3 目录结构按“控制器—服务—映射”三层铺开拿到源码后先看目录这类 Spring Boot 项目的包结构基本是固定的照着找入口不会迷路src/main/java/com/example/ ├── controller/ # 各模块的 Controller如 ProjectDeclareController ├── service/ # 业务接口 ├── service/impl/ # 业务实现事务和状态流转写在这里 ├── mapper/ # MyBatis Mapper 接口 ├── entity/ # 与数据库表对应的实体类 ├── config/ # 拦截器注册、跨域、静态资源映射 └── Application.java # 启动类带 MapperScan src/main/resources/ ├── application.yml # 数据源、端口、MyBatis 配置 ├── mapper/ # XML 映射文件复杂查询放这里 └── static/ templates/ # 前端页面与静态资源对应到功能模块controller下通常会有ProjectDeclareController项目申报、ProjectCheckController中检、ProjectFinishController结项、ProjectReviewController评审、ExpertReviewController专家评审、ReviewPlanController评审方案、ExcellentProjectController优秀项目、NewsController大创资讯等。找某个功能时先按菜单名猜 Controller 名再顺着 Service 看状态字段怎么变比通读全文快得多。2.4 数据库设计从实体属性图反推建表论文里给了管理员、评审方案、大创资讯三张实体属性图字段能直接对上表结构。以评审方案为例实体属性有标题、创新点、前期准备、实施方案、预期成果、经费预算、成员素质、图片、创建时间落到建表语句大致是这样CREATE TABLE review_plan ( id BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT 主键, title VARCHAR(200) NOT NULL COMMENT 方案标题, innovation LONGTEXT COMMENT 创新点, preparation LONGTEXT COMMENT 前期准备, implement LONGTEXT COMMENT 实施方案, expected LONGTEXT COMMENT 预期成果, budget DECIMAL(10,2) COMMENT 经费预算, member_quality LONGTEXT COMMENT 成员素质, picture VARCHAR(200) COMMENT 图片路径, addtime TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT评审方案;addtime用DEFAULT CURRENT_TIMESTAMP是这类项目的惯用写法插入时不用手动赋值。注意budget用DECIMAL而不是FLOAT经费金额别用浮点这是数据库设计的基本纪律。项目申报、中检、结项三张表结构类似都会带project_id、student_id、status、addtime这几个公共字段状态字段是整条业务链的骨架下一章细讲。3. 核心业务链路一条项目从申报到结项要过几道状态3.1 项目申报表单落库与文件上传学生端最核心的动作是提交申报。Controller 接收表单Service 做必填校验和重复申报判断Mapper 插入记录。典型写法PostMapping(/projectDeclare/add) public String addDeclare(ProjectDeclare form, RequestParam(file) MultipartFile file, HttpSession session, Model model) { // 1. 从 Session 取当前学生 ID不信任前端传值 Long studentId (Long) session.getAttribute(userId); form.setStudentId(studentId); // 2. 同一学生对同一项目类型只允许一条待审申报 int exist declareService.countPending(studentId, form.getTypeId()); if (exist 0) { model.addAttribute(msg, 已有待审核申报请勿重复提交); return projectDeclare/edit; } // 3. 附件存到本地目录数据库只存相对路径 if (!file.isEmpty()) { String path fileService.save(file, declare); form.setFilePath(path); } form.setStatus(待审核); // 初始状态 declareService.insert(form); return redirect:/projectDeclare/list; }逻辑说明studentId必须从 Session 取前端传的studentId可以被篡改countPending防重复提交避免学生连点两次生成两条记录文件只存路径不存二进制数据库轻、备份也方便。参数上status的取值建议统一成中文常量或枚举别一会儿“待审核”一会儿“0”后面状态流转会乱。3.2 中检与结项状态机是整条链的骨架申报通过后进入中检中检通过后进入结项每一步都由指导老师或管理员审核。这类系统的状态流转通常写成 Service 里的条件更新而不是让前端直接改status// 中检审核只有“待审核”状态才能被通过或驳回 Transactional public void auditCheck(Long checkId, String result, String opinion) { ProjectCheck check checkMapper.selectById(checkId); if (!待审核.equals(check.getStatus())) { throw new RuntimeException(该中检记录已处理不能重复审核); } check.setStatus(result); // 通过 / 驳回 check.setOpinion(opinion); checkMapper.updateById(check); // 通过后同步更新项目主表阶段供列表页展示 if (通过.equals(result)) { projectMapper.updateStage(check.getProjectId(), 已中检); } }Transactional保证“改中检记录”和“改项目主表阶段”要么都成功要么都回滚这是血泪经验——早期没加事务时中检记录改成功了但项目主表没更新列表页显示的状态和详情页对不上排查半天。result建议只允许“通过”“驳回”两个值Service 里做白名单校验别直接把前端字符串塞进数据库。3.3 评审与专家分配多对多关系怎么落表评审环节涉及项目、评审方案、专家三方。一个项目可以有多位专家评一位专家也可以评多个项目典型多对多。落地时一般拆成两张表expert_review存“某专家对某项目的评审记录”review_plan存方案模板。分配专家时插入expert_review记录状态置为“待评审”专家登录后只查expert_id 当前用户且状态为“待评审”的记录。-- 专家待评审列表按专家过滤 状态过滤两个条件缺一不可 SELECT er.id, p.project_name, er.status, er.addtime FROM expert_review er JOIN project_info p ON er.project_id p.id WHERE er.expert_id #{expertId} AND er.status 待评审 ORDER BY er.addtime DESC;这条 SQL 的关键在expert_id条件漏掉就会把别的专家的待办也查出来。分页用 MyBatis 的LIMIT或 PageHelper 都行数据量不大时前端分页也够用。3.4 优秀项目与大创资讯内容型模块的通用套路优秀项目和大创资讯本质是内容展示模块结构几乎一样标题、简介、图片、内容、创建时间。Controller 提供列表、详情、后台增删改列表页做条件查询和分页。这类模块没有复杂状态重点在图片上传路径和富文本内容的 XSS 过滤——富文本直接存 HTML 再原样输出是这类项目常见的安全短板至少要在输出时做一次转义或用白名单过滤。4. 本地跑起来环境、配置、建库、启动四步4.1 环境准备与版本对齐先确认三样东西JDK 1.8、Maven 3.6、MySQL 5.7 或 8.0。论文明确写了 JDK 1.8Spring Boot 2.x 配 JDK 8 是稳的如果你本地只有 JDK 17要么装个 8要么把 Spring Boot 升到 3.x 并改javax为jakarta后者改动面不小新手别轻易尝试。MySQL 8.0 要注意驱动类名是com.mysql.cj.jdbc.Driver连接串要带时区和 SSL 参数。4.2 建库与导入数据源码包里一般带一个.sql文件先建库再导入# 登录 MySQL 后执行 CREATE DATABASE dachuang DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 退出后用命令行导入注意路径换成你本地的 sql 文件 mysql -u root -p dachuang dachuang.sql导入后检查几张核心表有没有数据user登录账号、project_info项目主表、review_plan评审方案。如果user表为空登录页怎么试都进不去这是最常见的“跑不起来”原因之一。4.3 改配置数据源和端口打开application.yml把数据源改成你本地的server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/dachuang?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.entityserverTimezone不写可能报时区错误mapper-locations路径要和实际 XML 存放位置一致否则启动时报“Invalid bound statement”这个报错后面避坑章还会提。4.4 启动与验证在项目根目录执行mvn spring-boot:run或直接跑启动类的main方法。控制台出现Started Application in x seconds后浏览器访问http://localhost:8080。验证顺序建议先用管理员账号登录看菜单是否齐全再退出用学生账号登录确认看不到类型管理和评审方案菜单最后走一遍“申报—中检—结项”的最小闭环每步都去数据库里核对status字段有没有按预期变化。跑通这条闭环说明环境、权限、状态流转三块都没问题。5. 避坑与排查五个真实会卡住你的问题5.1 启动报“Invalid bound statement (not found)”现象项目能启动但一访问列表页就 500日志里是Invalid bound statement。原因Mapper 接口方法和 XML 里的id对不上或者mapper-locations没配到 XML 所在目录。解决先确认resources/mapper下 XML 文件名与接口名一致再检查 XML 里namespace是否写全限定类名最后核对application.yml的mapper-locations通配路径。三者缺一不可。5.2 中文乱码列表页标题全是问号现象数据库里中文正常页面显示乱码。原因建库时字符集用了latin1或连接串没带characterEncodingutf8。解决库和表统一utf8mb4连接串补上useUnicodetruecharacterEncodingutf8JSP 页面顶部加% page contentTypetext/html;charsetUTF-8 %。三处都对齐才不会反复。5.3 登录成功但立刻跳回登录页现象输入正确账号密码页面闪一下又回登录页。原因Session 里的用户键名和拦截器里取的键名不一致或者拦截器把登录接口本身也拦了。解决统一 Session 键名如loginUser并在拦截器preHandle里放行/login、/doLogin、静态资源路径。改完清一次浏览器缓存再试。5.4 文件上传后图片裂开现象上传成功数据库有路径但页面图片 404。原因上传目录不在静态资源映射范围内或路径存的是绝对路径、换台机器就失效。解决上传目录配到spring.web.resources.static-locations覆盖的路径下数据库只存相对路径如/upload/xxx.jpg页面用相对路径拼接。别存D:\upload\...这种绝对路径。5.5 审核后列表状态不更新现象中检审核通过详情页状态变了列表页还是“待审核”。原因列表查询走了缓存或审核方法没加事务导致主表更新失败但没报错。解决先看 Service 方法有没有Transactional再看列表 SQL 是不是查了关联表的旧字段。这类问题八成是事务或关联查询字段选错逐层打印 SQL 日志最快。6. 二次开发怎么改从“能演示”到“能交付”的三处改造拿到这类项目直接交差和真正能用之间差三件事我一般按这个顺序改。第一处是权限收口。原项目大概率只做了菜单级拦截数据级隔离靠前端传参。改造思路是在 Service 层统一注入当前用户所有列表查询强制带user_id或student_id条件写一个BaseService或在 Mapper 参数里统一塞currentUserId。验证方法很简单用学生 A 登录手动改 URL 里的id去访问学生 B 的申报详情改完必须返回 403 或空数据。第二处是状态流转收口。把散落在各 Controller 里的setStatus收敛到一个ProjectFlowService用枚举定义状态和允许的迁移public enum ProjectStatus { DECLARED(待审核), CHECKING(中检中), CHECKED(已中检), FINISHING(结项中), FINISHED(已结项), REJECTED(已驳回); private final String label; ProjectStatus(String label) { this.label label; } public String getLabel() { return label; } }迁移前先校验当前状态 - 目标状态是否在允许表里不在就抛业务异常。这样以后加“延期申请”之类的新状态只改枚举和迁移表不用满项目找setStatus。第三处是导出与归档。院系管理员真正需要的是把某批次项目导成 Excel 归档原项目一般没有。加一个ProjectExportController用 EasyExcel 或 POI 按条件查库写流字段对齐申报表即可。注意导出也要走权限校验别让普通学生把全量数据导走。改造点改动位置验证方式数据级权限Service / Mapper 参数改 URL id 越权访问应被拒状态机收口新增 FlowService 枚举非法状态迁移抛异常Excel 导出新增 ExportController导出条数与列表筛选结果一致最后说个习惯这类毕设型项目我每次接手第一件事不是看代码而是先把.sql导进本地库、把三个角色的账号各登一遍、走通一条完整业务链再动任何一行代码。因为它的坑往往不在代码逻辑而在数据初始化和配置对不上。从那以后我每次改这类系统都强制先跑通最小闭环再改省下的排查时间比写代码多得多。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/11/2 14:20:21 · 阅读 1.2k 基于Spring Boot的大创管理系统：从申报到结项的全流程实现
简介这份资源是面向高校计算机相关专业毕业生的Spring Boot大创管理系统毕业论文文档适合正在准备毕业设计、需要参考完整论文结构与项目实现思路的学生。文档围绕大学生创新创业项目管理场景梳理了学生、指导老师、院系管理员三类角色的申报、审核、评审与结项流程并给出SSM框架与MySQL数据库的技术选型说明。压缩包共1个doc文件约2.57MB内容涵盖摘要、需求分析、可行性分析、功能与业务流程分析、数据库ER图与数据字典、数据流图、详细设计、系统截图、测试及总结等章节结构完整、逻辑清晰。已有134人学习可作为论文写作框架与系统设计说明的参考样本帮助读者快速把握从需求到测试的论述脉络理解B/S模式下管理系统的设计要点与文档组织方式。1. 从一份“能跑起来的论文”说起大创管理系统到底解决了谁的麻烦每年三四月高校里管大创项目的老师最头疼的不是评审本身而是收表。学生交上来的申报书散在邮箱、微信群、共享文档里中检材料拖到截止日还在催结项报告和评审意见对不上号最后归档时发现某个项目的指导老师签字页丢了。这套基于 Spring Boot 的大创管理系统就是冲着这条链路去的把项目申报、中检、结项、评审、专家分配全部收进一个 B/S 后台学生、指导老师、院系管理员三个角色各看各的菜单数据落在 MySQL 里不再靠人肉对表。它适合两类人一是要交课程设计或毕业设计、需要一套结构完整可演示的 Java Web 项目二是真想给院系搭个轻量项目管理系统、又不想上重型平台的开发者。下面按“能干什么、怎么跑、怎么改”拆开讲。2. 系统骨架与角色权限三个角色、十一个功能模块怎么落到代码里2.1 技术栈选型SSM 打底Spring Boot 做启动器这个项目的技术组合在同类里算标准配置Spring Boot 负责启动和自动装配Spring MVC 接管请求路由MyBatis 做持久层MySQL 存数据前端是 JSP 或 Thymeleaf 模板加 Bootstrap 那一套。论文正文里写的是 SSM 框架摘要里又提 Spring Boot实际落地时通常是“Spring Boot 整合 SSM”的写法——用 Spring Boot 的 starter 把 Spring、Spring MVC、MyBatis 串起来省掉大量 XML。常见做法是在pom.xml里引这几个依赖!-- Spring Boot Web内嵌 Tomcat Spring MVC -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis 与 Spring Boot 整合 -- dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.1/version /dependency !-- MySQL 驱动 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency这段依赖的关键点在于mybatis-spring-boot-starter它会把DataSource、SqlSessionFactory、MapperScannerConfigurer自动配好你只需要在启动类上打MapperScan(com.example.mapper)Mapper 接口就能被注入。版本号这里给的是常见可用组合实际以你本地 JDK 为准——论文里明确写了 JDK 1.8那就别上 Spring Boot 3.x3.x 要求 JDK 17这是新手最容易翻车的地方。2.2 角色与菜单权限不是靠前端藏按钮系统定义了三个角色学生、指导老师、院系管理员。从功能清单看指导老师和管理员的菜单高度重合都有优秀项目管理、项目类型管理、项目信息管理、项目申报/中检/结项/评审管理、专家评审管理、评审方案管理学生则多了大创资讯浏览少了类型和方案维护。这种“菜单重合但数据范围不同”的结构落地时一般用一张user表加role字段区分登录后把角色写进 Session拦截器按角色放行 URL。// 登录拦截器按角色校验访问路径 public class RoleInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest req, HttpServletResponse resp, Object handler) throws Exception { HttpSession session req.getSession(); Object user session.getAttribute(loginUser); if (user null) { // 未登录一律打回登录页 resp.sendRedirect(/login); return false; } String role (String) session.getAttribute(role); String uri req.getRequestURI(); // 学生不允许进入类型管理、评审方案维护等后台路径 if (student.equals(role) (uri.startsWith(/projectType) || uri.startsWith(/reviewPlan))) { resp.sendError(403, 无权限访问); return false; } return true; } }这里要说明的是loginUser和role是登录成功时塞进 Session 的两个键拦截器只做粗粒度路径拦截真正的数据隔离还得在 Service 层补——比如学生查项目申报列表时SQL 里必须带where student_id #{currentUserId}否则学生能看到别人的申报书这是这类系统最常见的权限漏洞。前端藏菜单只是体验优化不能当安全边界。2.3 目录结构按“控制器—服务—映射”三层铺开拿到源码后先看目录这类 Spring Boot 项目的包结构基本是固定的照着找入口不会迷路src/main/java/com/example/ ├── controller/ # 各模块的 Controller如 ProjectDeclareController ├── service/ # 业务接口 ├── service/impl/ # 业务实现事务和状态流转写在这里 ├── mapper/ # MyBatis Mapper 接口 ├── entity/ # 与数据库表对应的实体类 ├── config/ # 拦截器注册、跨域、静态资源映射 └── Application.java # 启动类带 MapperScan src/main/resources/ ├── application.yml # 数据源、端口、MyBatis 配置 ├── mapper/ # XML 映射文件复杂查询放这里 └── static/ templates/ # 前端页面与静态资源对应到功能模块controller下通常会有ProjectDeclareController项目申报、ProjectCheckController中检、ProjectFinishController结项、ProjectReviewController评审、ExpertReviewController专家评审、ReviewPlanController评审方案、ExcellentProjectController优秀项目、NewsController大创资讯等。找某个功能时先按菜单名猜 Controller 名再顺着 Service 看状态字段怎么变比通读全文快得多。2.4 数据库设计从实体属性图反推建表论文里给了管理员、评审方案、大创资讯三张实体属性图字段能直接对上表结构。以评审方案为例实体属性有标题、创新点、前期准备、实施方案、预期成果、经费预算、成员素质、图片、创建时间落到建表语句大致是这样CREATE TABLE review_plan ( id BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT 主键, title VARCHAR(200) NOT NULL COMMENT 方案标题, innovation LONGTEXT COMMENT 创新点, preparation LONGTEXT COMMENT 前期准备, implement LONGTEXT COMMENT 实施方案, expected LONGTEXT COMMENT 预期成果, budget DECIMAL(10,2) COMMENT 经费预算, member_quality LONGTEXT COMMENT 成员素质, picture VARCHAR(200) COMMENT 图片路径, addtime TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT评审方案;addtime用DEFAULT CURRENT_TIMESTAMP是这类项目的惯用写法插入时不用手动赋值。注意budget用DECIMAL而不是FLOAT经费金额别用浮点这是数据库设计的基本纪律。项目申报、中检、结项三张表结构类似都会带project_id、student_id、status、addtime这几个公共字段状态字段是整条业务链的骨架下一章细讲。3. 核心业务链路一条项目从申报到结项要过几道状态3.1 项目申报表单落库与文件上传学生端最核心的动作是提交申报。Controller 接收表单Service 做必填校验和重复申报判断Mapper 插入记录。典型写法PostMapping(/projectDeclare/add) public String addDeclare(ProjectDeclare form, RequestParam(file) MultipartFile file, HttpSession session, Model model) { // 1. 从 Session 取当前学生 ID不信任前端传值 Long studentId (Long) session.getAttribute(userId); form.setStudentId(studentId); // 2. 同一学生对同一项目类型只允许一条待审申报 int exist declareService.countPending(studentId, form.getTypeId()); if (exist 0) { model.addAttribute(msg, 已有待审核申报请勿重复提交); return projectDeclare/edit; } // 3. 附件存到本地目录数据库只存相对路径 if (!file.isEmpty()) { String path fileService.save(file, declare); form.setFilePath(path); } form.setStatus(待审核); // 初始状态 declareService.insert(form); return redirect:/projectDeclare/list; }逻辑说明studentId必须从 Session 取前端传的studentId可以被篡改countPending防重复提交避免学生连点两次生成两条记录文件只存路径不存二进制数据库轻、备份也方便。参数上status的取值建议统一成中文常量或枚举别一会儿“待审核”一会儿“0”后面状态流转会乱。3.2 中检与结项状态机是整条链的骨架申报通过后进入中检中检通过后进入结项每一步都由指导老师或管理员审核。这类系统的状态流转通常写成 Service 里的条件更新而不是让前端直接改status// 中检审核只有“待审核”状态才能被通过或驳回 Transactional public void auditCheck(Long checkId, String result, String opinion) { ProjectCheck check checkMapper.selectById(checkId); if (!待审核.equals(check.getStatus())) { throw new RuntimeException(该中检记录已处理不能重复审核); } check.setStatus(result); // 通过 / 驳回 check.setOpinion(opinion); checkMapper.updateById(check); // 通过后同步更新项目主表阶段供列表页展示 if (通过.equals(result)) { projectMapper.updateStage(check.getProjectId(), 已中检); } }Transactional保证“改中检记录”和“改项目主表阶段”要么都成功要么都回滚这是血泪经验——早期没加事务时中检记录改成功了但项目主表没更新列表页显示的状态和详情页对不上排查半天。result建议只允许“通过”“驳回”两个值Service 里做白名单校验别直接把前端字符串塞进数据库。3.3 评审与专家分配多对多关系怎么落表评审环节涉及项目、评审方案、专家三方。一个项目可以有多位专家评一位专家也可以评多个项目典型多对多。落地时一般拆成两张表expert_review存“某专家对某项目的评审记录”review_plan存方案模板。分配专家时插入expert_review记录状态置为“待评审”专家登录后只查expert_id 当前用户且状态为“待评审”的记录。-- 专家待评审列表按专家过滤 状态过滤两个条件缺一不可 SELECT er.id, p.project_name, er.status, er.addtime FROM expert_review er JOIN project_info p ON er.project_id p.id WHERE er.expert_id #{expertId} AND er.status 待评审 ORDER BY er.addtime DESC;这条 SQL 的关键在expert_id条件漏掉就会把别的专家的待办也查出来。分页用 MyBatis 的LIMIT或 PageHelper 都行数据量不大时前端分页也够用。3.4 优秀项目与大创资讯内容型模块的通用套路优秀项目和大创资讯本质是内容展示模块结构几乎一样标题、简介、图片、内容、创建时间。Controller 提供列表、详情、后台增删改列表页做条件查询和分页。这类模块没有复杂状态重点在图片上传路径和富文本内容的 XSS 过滤——富文本直接存 HTML 再原样输出是这类项目常见的安全短板至少要在输出时做一次转义或用白名单过滤。4. 本地跑起来环境、配置、建库、启动四步4.1 环境准备与版本对齐先确认三样东西JDK 1.8、Maven 3.6、MySQL 5.7 或 8.0。论文明确写了 JDK 1.8Spring Boot 2.x 配 JDK 8 是稳的如果你本地只有 JDK 17要么装个 8要么把 Spring Boot 升到 3.x 并改javax为jakarta后者改动面不小新手别轻易尝试。MySQL 8.0 要注意驱动类名是com.mysql.cj.jdbc.Driver连接串要带时区和 SSL 参数。4.2 建库与导入数据源码包里一般带一个.sql文件先建库再导入# 登录 MySQL 后执行 CREATE DATABASE dachuang DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 退出后用命令行导入注意路径换成你本地的 sql 文件 mysql -u root -p dachuang dachuang.sql导入后检查几张核心表有没有数据user登录账号、project_info项目主表、review_plan评审方案。如果user表为空登录页怎么试都进不去这是最常见的“跑不起来”原因之一。4.3 改配置数据源和端口打开application.yml把数据源改成你本地的server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/dachuang?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.entityserverTimezone不写可能报时区错误mapper-locations路径要和实际 XML 存放位置一致否则启动时报“Invalid bound statement”这个报错后面避坑章还会提。4.4 启动与验证在项目根目录执行mvn spring-boot:run或直接跑启动类的main方法。控制台出现Started Application in x seconds后浏览器访问http://localhost:8080。验证顺序建议先用管理员账号登录看菜单是否齐全再退出用学生账号登录确认看不到类型管理和评审方案菜单最后走一遍“申报—中检—结项”的最小闭环每步都去数据库里核对status字段有没有按预期变化。跑通这条闭环说明环境、权限、状态流转三块都没问题。5. 避坑与排查五个真实会卡住你的问题5.1 启动报“Invalid bound statement (not found)”现象项目能启动但一访问列表页就 500日志里是Invalid bound statement。原因Mapper 接口方法和 XML 里的id对不上或者mapper-locations没配到 XML 所在目录。解决先确认resources/mapper下 XML 文件名与接口名一致再检查 XML 里namespace是否写全限定类名最后核对application.yml的mapper-locations通配路径。三者缺一不可。5.2 中文乱码列表页标题全是问号现象数据库里中文正常页面显示乱码。原因建库时字符集用了latin1或连接串没带characterEncodingutf8。解决库和表统一utf8mb4连接串补上useUnicodetruecharacterEncodingutf8JSP 页面顶部加% page contentTypetext/html;charsetUTF-8 %。三处都对齐才不会反复。5.3 登录成功但立刻跳回登录页现象输入正确账号密码页面闪一下又回登录页。原因Session 里的用户键名和拦截器里取的键名不一致或者拦截器把登录接口本身也拦了。解决统一 Session 键名如loginUser并在拦截器preHandle里放行/login、/doLogin、静态资源路径。改完清一次浏览器缓存再试。5.4 文件上传后图片裂开现象上传成功数据库有路径但页面图片 404。原因上传目录不在静态资源映射范围内或路径存的是绝对路径、换台机器就失效。解决上传目录配到spring.web.resources.static-locations覆盖的路径下数据库只存相对路径如/upload/xxx.jpg页面用相对路径拼接。别存D:\upload\...这种绝对路径。5.5 审核后列表状态不更新现象中检审核通过详情页状态变了列表页还是“待审核”。原因列表查询走了缓存或审核方法没加事务导致主表更新失败但没报错。解决先看 Service 方法有没有Transactional再看列表 SQL 是不是查了关联表的旧字段。这类问题八成是事务或关联查询字段选错逐层打印 SQL 日志最快。6. 二次开发怎么改从“能演示”到“能交付”的三处改造拿到这类项目直接交差和真正能用之间差三件事我一般按这个顺序改。第一处是权限收口。原项目大概率只做了菜单级拦截数据级隔离靠前端传参。改造思路是在 Service 层统一注入当前用户所有列表查询强制带user_id或student_id条件写一个BaseService或在 Mapper 参数里统一塞currentUserId。验证方法很简单用学生 A 登录手动改 URL 里的id去访问学生 B 的申报详情改完必须返回 403 或空数据。第二处是状态流转收口。把散落在各 Controller 里的setStatus收敛到一个ProjectFlowService用枚举定义状态和允许的迁移public enum ProjectStatus { DECLARED(待审核), CHECKING(中检中), CHECKED(已中检), FINISHING(结项中), FINISHED(已结项), REJECTED(已驳回); private final String label; ProjectStatus(String label) { this.label label; } public String getLabel() { return label; } }迁移前先校验当前状态 - 目标状态是否在允许表里不在就抛业务异常。这样以后加“延期申请”之类的新状态只改枚举和迁移表不用满项目找setStatus。第三处是导出与归档。院系管理员真正需要的是把某批次项目导成 Excel 归档原项目一般没有。加一个ProjectExportController用 EasyExcel 或 POI 按条件查库写流字段对齐申报表即可。注意导出也要走权限校验别让普通学生把全量数据导走。改造点改动位置验证方式数据级权限Service / Mapper 参数改 URL id 越权访问应被拒状态机收口新增 FlowService 枚举非法状态迁移抛异常Excel 导出新增 ExportController导出条数与列表筛选结果一致最后说个习惯这类毕设型项目我每次接手第一件事不是看代码而是先把.sql导进本地库、把三个角色的账号各登一遍、走通一条完整业务链再动任何一行代码。因为它的坑往往不在代码逻辑而在数据初始化和配置对不上。从那以后我每次改这类系统都强制先跑通最小闭环再改省下的排查时间比写代码多得多。希望帮到你。本文还有配套的精品资源点击获取