每年三四月份我的私信里就会被同一条内容刷屏“学长SpringBootVue的新生报到系统帮我看看哪里出了问题”刷了几年之后我算是摸清了所谓大学新生报到系统平台表面上是个很常见的Java Web毕设题目可真要把它做得能答辩、能演示、能顺利跑起来远比想象中麻烦。完整项目源码、SQL脚本、接口文档这三样凑齐了才算是一份合格的交付物。这篇文章就把SpringBootVue大学新生报到系统平台从模块拆解、技术选型、数据库设计到前后端联调和踩坑实录完整地过一遍不管你是准备自己写还是刚接手别人的代码都能直接照着参考。1. 项目整体设计与思路拆解1.1 为什么选 SpringBoot Vue 这套组合先说结论这套组合在“能跑起来”和“答辩能讲清楚”之间取得了一个非常舒服的平衡。如果你用纯Servlet JSP逻辑全堆在服务端页面做得再认真也透着一股十年前的感觉而且前后端代码耦合在一起老师问一句“接口是谁设计的”就很容易露怯。反过来如果你上Spring Cloud微服务加一堆中间件功能没说清楚光启动N个模块就够呛答辩时容易把自己绕进去。SpringBoot Vue 的优势在于分工非常明确SpringBoot 只提供 REST APIVue 只负责渲染页面两边通过 JSON 数据交互。这给答辩带来的好处是老师追问“前端怎么拿到数据的”你只需要说“后端暴露一个接口前端调一下”整个链路是透明的。另外从工程实践的角度看这套技术栈是目前中小型管理系统的主流配置。Maven 依赖集中、起步快前端组件库齐全写出来的界面也比较现代。毕设用这套组合先天印象分就不会低。1.2 核心业务流程与角色模块拆分新生报到系统听起来简单实际上是一条完整的业务链学生在线注册登录、完善个人信息、查看报到进度、提交报到申请辅导员审核确认管理员分配院系专业、班级、宿舍最后生成统计报表。任何一个环节断了整个系统都不算跑通。我习惯把角色分成三类对应三种完全不同的页面和操作权限角色主要操作核心页面学生注册登录、填报信息、提交报到申请、查看审核状态报到申请页、个人信息页、状态查询页辅导员/审核员审核学生报到材料、确认到校情况、修改部分信息待审核列表、学生详情页、审核记录页管理员管理院系专业班级宿舍、账号维护、报到统计导出基础数据管理页、用户管理页、统计报表页模块拆到这里开发顺序也就出来了先把公共的登录注册和权限做了再做学生端的报到流程然后做管理端的配置和审核最后补统计报表。这个顺序能保证项目在中期就有一个“能演示主流程”的版本而不是最后三天连滚带爬。1.3 数据库设计思路与表关系数据库设计是这类系统最容易被忽略又最影响后续开发的部分。标准做法是分开两张核心表一张账号表sys_user只存登录信息一张学生信息表student_info存业务数据。两个表通过user_id关联账号密码只出现在sys_user里这样以后要在系统里加老师账号或管理员账号就不需要动学生表。我的一般表清单是这样的sys_user账号、密码、角色、状态、创建时间student_info学号、姓名、性别、身份证号、联系方式、毕业学校、家庭地址、照片URLdepartment院系specialty专业关联院系class_info班级关联专业dormitory宿舍楼和房间号registration_record报到记录关联学生、班级、宿舍、审核人、审核时间notice公告消息可选项很多项目会加一个公告栏撑页面设计时特别注意两件事。一是主外键不要建得太死毕设项目的数据量不大关联字段在代码里维护即可外键约束反而会增加删除数据的成本。二是所有时间字段统一用datetime状态字段统一用tinyint或varchar加注释避免后面写 SQL 统计时到处踩类型坑。2. 核心细节解析与实操要点2.1 权限设计与 JWT 登录认证权限设计是这类项目里最容易糊弄、又最容易被老师问到的地方。最省力且能讲清楚的方案就是用户登录后后端签发一个 JWT前端把它存进 localStorage之后每个请求都在请求头里带Authorization: Bearer token后端用一个拦截器统一校验。为什么用 JWT 而不是 Session因为前后端分离以后前端可能部署在另一个端口甚至另一台服务器上Session 要处理跨域、共享和失效问题反而比 JWT 麻烦。JWT 本身自带过期时间装在签名和角色信息里后端不存状态符合“无状态接口”的设计思路。后端核心大致长这样public class JwtUtils { private static final SecretKey KEY Keys.hmacShaKeyFor( your-very-long-secret-key-change-me.getBytes(StandardCharsets.UTF_8)); public static String createToken(Long userId, String role) { return Jwts.builder() .setSubject(String.valueOf(userId)) .claim(role, role) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() 24L * 3600 * 1000)) .signWith(KEY) .compact(); } }注意如果你用的是 jjwt 0.12.x 之后的版本signWith(SignatureAlgorithm.HS256, secret)这种老写法会直接编译报错新版本要求传入 Key 对象。很多毕设项目卡在这一步本质上是网上教程版本太旧代码抄的时候没看 maven 坐标。有了拦截器之后接口注释里标清楚“需要什么角色访问”前端按角色控制路由后端再做一次接口级别的校验。前端控制路由是为了体验后端校验接口才是真正的安全边界只有前端校验的权限等于没有权限。2.2 前端路由权限控制与 Axios 拦截器前端这块我推荐用 Vue3 Vite Pinia Vue Router界面用 Element Plus 足够应付这个系统。路由权限控制在router.beforeEach里做思路是每个路由的meta里声明允许的角色进入页面前比对当前用户角色。伪代码是这样的router.beforeEach((to) { const userStore useUserStore() if (to.meta.role userStore.role ! to.meta.role) { return { path: /login, query: { redirect: to.fullPath } } } })注意这里有个容易忽略的点路由守卫判断角色之前页面刷新后 Pinia 里的用户状态是空的必须去调用一个“获取当前用户信息”的接口恢复登录态。常见的做法是在本地存一份简洁的用户对象刷新时先用它顶住再异步刷新真实信息避免每次刷新都被踢回登录页。Axios 拦截器负责两件事往请求头里塞 token以及遇到 401 时统一跳转登录页。代码很短但作用是全局的比在每个页面里手动判断状态码优雅得多。axios.interceptors.request.use(config { const token localStorage.getItem(token) if (token) config.headers.Authorization Bearer ${token} return config }) axios.interceptors.response.use( res res.data, err { if (err.response?.status 401) { localStorage.removeItem(token) router.push(/login) } return Promise.reject(err) } )一个实用的细节是后端接口别只返回裸数据统一包一层{ code, message, data }前端拦截器里只需要关注code业务报错和异常报错分得清清楚楚写页面的人会非常感谢你。2.3 接口文档与统一返回结构拿到的项目里既然单独提到了接口文档说明它不只是“能跑”还要能让别人快速上手联调。最省力的做法是引入 Knife4j它是 Swagger 的增强版界面比原生 Swagger UI 好看很多也支持分组和导出 Markdown。统一返回结构我一般命名为ResultData public class ResultT { private Integer code; private String message; private T data; public static T ResultT ok(T data) { ResultT r new Result(); r.setCode(200); r.setMessage(success); r.setData(data); return r; } public static T ResultT fail(String message) { ResultT r new Result(); r.setCode(500); r.setMessage(message); return r; } }这样做的好处是接口文档上每个接口的返回结构都是一样的模板前端写回调逻辑时不需要针对每个接口单独判断。能用代码表达的约定绝不要靠嘴巴提醒。3. 实操过程与核心环节实现3.1 后端环境搭建与核心配置如果你是从零开始搭建我建议用 Maven 项目依赖按需加别一上来就把全家桶都配上。这个系统必需的依赖就这几样spring-boot-starter-web、mybatis-plus-boot-starter、mysql-connector-j、lombok、jjwt、knife4j。实际开发中最常出问题的地方是版本兼容。Spring Boot 2.7 用的是javax.servletSpring Boot 3.x 换成了jakarta.servlet很多老教程的import javax.annotation.Resource在 Spring Boot 3 里直接报错。如果你接手的是别人生成的代码第一件事就是确认 Spring Boot 版本和 JDK 版本别一上来就开始改业务代码不然环境问题会浪费你一整天。核心配置application.yml大致是这个样子server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/enroll_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: 123456 servlet: multipart: max-file-size: 10MB mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: id-type: auto这里的allowPublicKeyRetrievaltrue和serverTimezoneAsia/Shanghai是很多人踩坑的经典位置。MySQL 8 默认的认证方式在部分驱动下会报Public Key Retrieval is not allowed不加这个参数项目直接启动不了。时间区域不指定的话数据库里存的时间和 Java 里显示的时间经常差八个小时排查起来极其痛苦。服务启动类上记得加MapperScan扫描 mapper 接口所在包不然 MyBatis-Plus 会提示找不到 Statement越早加越好。3.2 SQL 脚本与初始化数据SQL 脚本是交付物里的一个关键部分很多人在本地能跑换一台电脑就启动不了原因基本是脚本不完整或字符集不对。写脚本的时候要强制加上库名、字符集和注释别留一个裸的CREATE TABLE就交差。CREATE DATABASE IF NOT EXISTS enroll_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE enroll_system; CREATE TABLE sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL COMMENT 加密后的密码, role VARCHAR(20) NOT NULL COMMENT STUDENT/COUNSELOR/ADMIN, status TINYINT DEFAULT 1 COMMENT 1启用 0禁用, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE student_info ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, student_no VARCHAR(20) NOT NULL, name VARCHAR(50) NOT NULL, gender VARCHAR(10), id_card VARCHAR(30), phone VARCHAR(20), department_id BIGINT, specialty_id BIGINT, class_id BIGINT, address VARCHAR(255), photo_url VARCHAR(255), create_time DATETIME DEFAULT CURRENT_TIMESTAMP );初始化数据里面一定要放好演示账号。比如管理员admin、辅导员teacher01、学生stu001密码统一用一个固定的密文存进去。这里我有一个个人习惯演示账号的密码用 BCrypt 加密后放 SQL 里同时在项目文档里写清楚“登录账号是什么、密码是什么”答辩时直接用现成账号进入系统绝对不要现场注册。3.3 前后端联调与接口对接前后端分离项目最烦的就是跨域问题。开发环境推荐用 Vite 的代理把请求转发到后端这样前端代码里写的axios请求路径是/api/login而不是http://localhost:8080/login浏览器的跨域限制直接绕开了。// vite.config.js export default defineConfig({ server: { port: 3000, proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } } })后端如果有 Controller 层面的CrossOrigin建议保留一份全局配置因为只配前端代理的话一旦被打包成单个 jar 部署前端请求路径就要重新调整到时候跨域问题大概率会反扑。写一个登录接口的对接示例const res await $http.post(/api/auth/login, { username: form.username, password: form.password }) if (res.code 200) { localStorage.setItem(token, res.data.token) localStorage.setItem(userInfo, JSON.stringify(res.data.user)) }这里再提供一个实用的部署思路毕设演示阶段前端npm run build之后把dist目录直接拷到 SpringBoot 的src/main/resources/static下面再打成一个 jar 包启动只用跑一个进程就能完成整套演示免去本地同时开前端开发服务器和后端两个窗口的混乱稳定很多。4. 常见问题与排查技巧实录4.1 启动报错和依赖冲突速查表我把这类项目里出现频率最高的几个问题整理了一下遇到哪个直接对号入座报错或现象常见原因解决方法Public Key Retrieval is not allowedMySQL 8 连接参数缺少选项JDBC URL 加allowPublicKeyRetrievaltrue数据库时间差 8 小时时区未指定JDBC URL 加serverTimezoneAsia/Shanghai接口 405 / 404前端请求路径和后端接口不匹配打开浏览器开发者工具看 Network 实际请求路径Invalid bound statementMapper 接口没扫描到启动类加MapperScanVue Router 刷新后页面 404使用了 history 模式且后端没有回退开发环境用 Vite 代理生产环境由 Nginx 配置try_files回退到index.htmlCORS 跨域前后端端口不一致开发环境推荐前端代理不要只依赖后端注解JWT 编译报错signWith方法签名不匹配jjwt 版本过新API 变了升级代码姿势改用Keys.hmacShaKeyFor传入 Key4.2 想改成自己学校数据时要注意的坑新生报到系统最需要定制的地方就是院系、专业和班级数据。直接改 SQL 脚本没问题但要注意两点一是department、specialty、class_info三张表有上下级关系专业表里的department_id必须指向真实存在的数据删数据前先确认没有关联记录二是很多项目里前端页面会把学校名称写死比如首页标题、页脚版权、分享标题这些地方全部要在代码里搜一遍再替换不然换一台电脑部署页面还是显示别人学校的名字太尴尬了。如果你是拿别人的源码改造另一个常见风险是图片上传路径。很多系统把上传目录写死在D:/upload或/root/project/upload本地跑没问题换个环境就报文件找不到。建议把文件路径配置放到application.yml里通过Value注入这属于一劳永逸的改动。4.3 答辩演示时容易翻车的三个细节代码没问题、接口没问题最后挂在演示环节的项目我见过太多了。第一个细节是演示账号一定要提前登录过一次避免现场输入密码时因为失误连续失败被锁定第二个细节是 JWT 的过期时间不要太短很多人默认配成 15 分钟答辩论到一半 token 过期页面突然跳到登录页非常影响节奏。建议直接改成 24 小时演示场景下安全已经不是首要考虑因素。第三个细节是统计报表页。这类系统到最后大多会有一个“报到率统计”图表如果数据是空的页面就什么线条都画不出来。解决办法是在 SQL 脚本里预置一批真实的模拟数据报到状态、院系、班级都填好演示时点开报表有点有面还能顺着数据讲一讲统计口径。最后说一件我踩过好几次的坑毕设项目不需要把功能做得特别花但一定要能一口气演示完。所以我在搭新生报到系统时永远先把登录、提交报到、管理员审核这三条主链路调到最顺再去做统计报表和导出这些锦上添花的功能。系统交付时把源码、SQL、接口文档、演示账号说明放到一个目录里标清楚启动步骤。一个项目能不能拿高分很多时候不看代码量就看对方能不能在十分钟内把它跑起来。
每年三四月份我的私信里就会被同一条内容刷屏“学长SpringBootVue的新生报到系统帮我看看哪里出了问题”刷了几年之后我算是摸清了所谓大学新生报到系统平台表面上是个很常见的Java Web毕设题目可真要把它做得能答辩、能演示、能顺利跑起来远比想象中麻烦。完整项目源码、SQL脚本、接口文档这三样凑齐了才算是一份合格的交付物。这篇文章就把SpringBootVue大学新生报到系统平台从模块拆解、技术选型、数据库设计到前后端联调和踩坑实录完整地过一遍不管你是准备自己写还是刚接手别人的代码都能直接照着参考。1. 项目整体设计与思路拆解1.1 为什么选 SpringBoot Vue 这套组合先说结论这套组合在“能跑起来”和“答辩能讲清楚”之间取得了一个非常舒服的平衡。如果你用纯Servlet JSP逻辑全堆在服务端页面做得再认真也透着一股十年前的感觉而且前后端代码耦合在一起老师问一句“接口是谁设计的”就很容易露怯。反过来如果你上Spring Cloud微服务加一堆中间件功能没说清楚光启动N个模块就够呛答辩时容易把自己绕进去。SpringBoot Vue 的优势在于分工非常明确SpringBoot 只提供 REST APIVue 只负责渲染页面两边通过 JSON 数据交互。这给答辩带来的好处是老师追问“前端怎么拿到数据的”你只需要说“后端暴露一个接口前端调一下”整个链路是透明的。另外从工程实践的角度看这套技术栈是目前中小型管理系统的主流配置。Maven 依赖集中、起步快前端组件库齐全写出来的界面也比较现代。毕设用这套组合先天印象分就不会低。1.2 核心业务流程与角色模块拆分新生报到系统听起来简单实际上是一条完整的业务链学生在线注册登录、完善个人信息、查看报到进度、提交报到申请辅导员审核确认管理员分配院系专业、班级、宿舍最后生成统计报表。任何一个环节断了整个系统都不算跑通。我习惯把角色分成三类对应三种完全不同的页面和操作权限角色主要操作核心页面学生注册登录、填报信息、提交报到申请、查看审核状态报到申请页、个人信息页、状态查询页辅导员/审核员审核学生报到材料、确认到校情况、修改部分信息待审核列表、学生详情页、审核记录页管理员管理院系专业班级宿舍、账号维护、报到统计导出基础数据管理页、用户管理页、统计报表页模块拆到这里开发顺序也就出来了先把公共的登录注册和权限做了再做学生端的报到流程然后做管理端的配置和审核最后补统计报表。这个顺序能保证项目在中期就有一个“能演示主流程”的版本而不是最后三天连滚带爬。1.3 数据库设计思路与表关系数据库设计是这类系统最容易被忽略又最影响后续开发的部分。标准做法是分开两张核心表一张账号表sys_user只存登录信息一张学生信息表student_info存业务数据。两个表通过user_id关联账号密码只出现在sys_user里这样以后要在系统里加老师账号或管理员账号就不需要动学生表。我的一般表清单是这样的sys_user账号、密码、角色、状态、创建时间student_info学号、姓名、性别、身份证号、联系方式、毕业学校、家庭地址、照片URLdepartment院系specialty专业关联院系class_info班级关联专业dormitory宿舍楼和房间号registration_record报到记录关联学生、班级、宿舍、审核人、审核时间notice公告消息可选项很多项目会加一个公告栏撑页面设计时特别注意两件事。一是主外键不要建得太死毕设项目的数据量不大关联字段在代码里维护即可外键约束反而会增加删除数据的成本。二是所有时间字段统一用datetime状态字段统一用tinyint或varchar加注释避免后面写 SQL 统计时到处踩类型坑。2. 核心细节解析与实操要点2.1 权限设计与 JWT 登录认证权限设计是这类项目里最容易糊弄、又最容易被老师问到的地方。最省力且能讲清楚的方案就是用户登录后后端签发一个 JWT前端把它存进 localStorage之后每个请求都在请求头里带Authorization: Bearer token后端用一个拦截器统一校验。为什么用 JWT 而不是 Session因为前后端分离以后前端可能部署在另一个端口甚至另一台服务器上Session 要处理跨域、共享和失效问题反而比 JWT 麻烦。JWT 本身自带过期时间装在签名和角色信息里后端不存状态符合“无状态接口”的设计思路。后端核心大致长这样public class JwtUtils { private static final SecretKey KEY Keys.hmacShaKeyFor( your-very-long-secret-key-change-me.getBytes(StandardCharsets.UTF_8)); public static String createToken(Long userId, String role) { return Jwts.builder() .setSubject(String.valueOf(userId)) .claim(role, role) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() 24L * 3600 * 1000)) .signWith(KEY) .compact(); } }注意如果你用的是 jjwt 0.12.x 之后的版本signWith(SignatureAlgorithm.HS256, secret)这种老写法会直接编译报错新版本要求传入 Key 对象。很多毕设项目卡在这一步本质上是网上教程版本太旧代码抄的时候没看 maven 坐标。有了拦截器之后接口注释里标清楚“需要什么角色访问”前端按角色控制路由后端再做一次接口级别的校验。前端控制路由是为了体验后端校验接口才是真正的安全边界只有前端校验的权限等于没有权限。2.2 前端路由权限控制与 Axios 拦截器前端这块我推荐用 Vue3 Vite Pinia Vue Router界面用 Element Plus 足够应付这个系统。路由权限控制在router.beforeEach里做思路是每个路由的meta里声明允许的角色进入页面前比对当前用户角色。伪代码是这样的router.beforeEach((to) { const userStore useUserStore() if (to.meta.role userStore.role ! to.meta.role) { return { path: /login, query: { redirect: to.fullPath } } } })注意这里有个容易忽略的点路由守卫判断角色之前页面刷新后 Pinia 里的用户状态是空的必须去调用一个“获取当前用户信息”的接口恢复登录态。常见的做法是在本地存一份简洁的用户对象刷新时先用它顶住再异步刷新真实信息避免每次刷新都被踢回登录页。Axios 拦截器负责两件事往请求头里塞 token以及遇到 401 时统一跳转登录页。代码很短但作用是全局的比在每个页面里手动判断状态码优雅得多。axios.interceptors.request.use(config { const token localStorage.getItem(token) if (token) config.headers.Authorization Bearer ${token} return config }) axios.interceptors.response.use( res res.data, err { if (err.response?.status 401) { localStorage.removeItem(token) router.push(/login) } return Promise.reject(err) } )一个实用的细节是后端接口别只返回裸数据统一包一层{ code, message, data }前端拦截器里只需要关注code业务报错和异常报错分得清清楚楚写页面的人会非常感谢你。2.3 接口文档与统一返回结构拿到的项目里既然单独提到了接口文档说明它不只是“能跑”还要能让别人快速上手联调。最省力的做法是引入 Knife4j它是 Swagger 的增强版界面比原生 Swagger UI 好看很多也支持分组和导出 Markdown。统一返回结构我一般命名为ResultData public class ResultT { private Integer code; private String message; private T data; public static T ResultT ok(T data) { ResultT r new Result(); r.setCode(200); r.setMessage(success); r.setData(data); return r; } public static T ResultT fail(String message) { ResultT r new Result(); r.setCode(500); r.setMessage(message); return r; } }这样做的好处是接口文档上每个接口的返回结构都是一样的模板前端写回调逻辑时不需要针对每个接口单独判断。能用代码表达的约定绝不要靠嘴巴提醒。3. 实操过程与核心环节实现3.1 后端环境搭建与核心配置如果你是从零开始搭建我建议用 Maven 项目依赖按需加别一上来就把全家桶都配上。这个系统必需的依赖就这几样spring-boot-starter-web、mybatis-plus-boot-starter、mysql-connector-j、lombok、jjwt、knife4j。实际开发中最常出问题的地方是版本兼容。Spring Boot 2.7 用的是javax.servletSpring Boot 3.x 换成了jakarta.servlet很多老教程的import javax.annotation.Resource在 Spring Boot 3 里直接报错。如果你接手的是别人生成的代码第一件事就是确认 Spring Boot 版本和 JDK 版本别一上来就开始改业务代码不然环境问题会浪费你一整天。核心配置application.yml大致是这个样子server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/enroll_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: 123456 servlet: multipart: max-file-size: 10MB mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: id-type: auto这里的allowPublicKeyRetrievaltrue和serverTimezoneAsia/Shanghai是很多人踩坑的经典位置。MySQL 8 默认的认证方式在部分驱动下会报Public Key Retrieval is not allowed不加这个参数项目直接启动不了。时间区域不指定的话数据库里存的时间和 Java 里显示的时间经常差八个小时排查起来极其痛苦。服务启动类上记得加MapperScan扫描 mapper 接口所在包不然 MyBatis-Plus 会提示找不到 Statement越早加越好。3.2 SQL 脚本与初始化数据SQL 脚本是交付物里的一个关键部分很多人在本地能跑换一台电脑就启动不了原因基本是脚本不完整或字符集不对。写脚本的时候要强制加上库名、字符集和注释别留一个裸的CREATE TABLE就交差。CREATE DATABASE IF NOT EXISTS enroll_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE enroll_system; CREATE TABLE sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL COMMENT 加密后的密码, role VARCHAR(20) NOT NULL COMMENT STUDENT/COUNSELOR/ADMIN, status TINYINT DEFAULT 1 COMMENT 1启用 0禁用, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE student_info ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, student_no VARCHAR(20) NOT NULL, name VARCHAR(50) NOT NULL, gender VARCHAR(10), id_card VARCHAR(30), phone VARCHAR(20), department_id BIGINT, specialty_id BIGINT, class_id BIGINT, address VARCHAR(255), photo_url VARCHAR(255), create_time DATETIME DEFAULT CURRENT_TIMESTAMP );初始化数据里面一定要放好演示账号。比如管理员admin、辅导员teacher01、学生stu001密码统一用一个固定的密文存进去。这里我有一个个人习惯演示账号的密码用 BCrypt 加密后放 SQL 里同时在项目文档里写清楚“登录账号是什么、密码是什么”答辩时直接用现成账号进入系统绝对不要现场注册。3.3 前后端联调与接口对接前后端分离项目最烦的就是跨域问题。开发环境推荐用 Vite 的代理把请求转发到后端这样前端代码里写的axios请求路径是/api/login而不是http://localhost:8080/login浏览器的跨域限制直接绕开了。// vite.config.js export default defineConfig({ server: { port: 3000, proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } } })后端如果有 Controller 层面的CrossOrigin建议保留一份全局配置因为只配前端代理的话一旦被打包成单个 jar 部署前端请求路径就要重新调整到时候跨域问题大概率会反扑。写一个登录接口的对接示例const res await $http.post(/api/auth/login, { username: form.username, password: form.password }) if (res.code 200) { localStorage.setItem(token, res.data.token) localStorage.setItem(userInfo, JSON.stringify(res.data.user)) }这里再提供一个实用的部署思路毕设演示阶段前端npm run build之后把dist目录直接拷到 SpringBoot 的src/main/resources/static下面再打成一个 jar 包启动只用跑一个进程就能完成整套演示免去本地同时开前端开发服务器和后端两个窗口的混乱稳定很多。4. 常见问题与排查技巧实录4.1 启动报错和依赖冲突速查表我把这类项目里出现频率最高的几个问题整理了一下遇到哪个直接对号入座报错或现象常见原因解决方法Public Key Retrieval is not allowedMySQL 8 连接参数缺少选项JDBC URL 加allowPublicKeyRetrievaltrue数据库时间差 8 小时时区未指定JDBC URL 加serverTimezoneAsia/Shanghai接口 405 / 404前端请求路径和后端接口不匹配打开浏览器开发者工具看 Network 实际请求路径Invalid bound statementMapper 接口没扫描到启动类加MapperScanVue Router 刷新后页面 404使用了 history 模式且后端没有回退开发环境用 Vite 代理生产环境由 Nginx 配置try_files回退到index.htmlCORS 跨域前后端端口不一致开发环境推荐前端代理不要只依赖后端注解JWT 编译报错signWith方法签名不匹配jjwt 版本过新API 变了升级代码姿势改用Keys.hmacShaKeyFor传入 Key4.2 想改成自己学校数据时要注意的坑新生报到系统最需要定制的地方就是院系、专业和班级数据。直接改 SQL 脚本没问题但要注意两点一是department、specialty、class_info三张表有上下级关系专业表里的department_id必须指向真实存在的数据删数据前先确认没有关联记录二是很多项目里前端页面会把学校名称写死比如首页标题、页脚版权、分享标题这些地方全部要在代码里搜一遍再替换不然换一台电脑部署页面还是显示别人学校的名字太尴尬了。如果你是拿别人的源码改造另一个常见风险是图片上传路径。很多系统把上传目录写死在D:/upload或/root/project/upload本地跑没问题换个环境就报文件找不到。建议把文件路径配置放到application.yml里通过Value注入这属于一劳永逸的改动。4.3 答辩演示时容易翻车的三个细节代码没问题、接口没问题最后挂在演示环节的项目我见过太多了。第一个细节是演示账号一定要提前登录过一次避免现场输入密码时因为失误连续失败被锁定第二个细节是 JWT 的过期时间不要太短很多人默认配成 15 分钟答辩论到一半 token 过期页面突然跳到登录页非常影响节奏。建议直接改成 24 小时演示场景下安全已经不是首要考虑因素。第三个细节是统计报表页。这类系统到最后大多会有一个“报到率统计”图表如果数据是空的页面就什么线条都画不出来。解决办法是在 SQL 脚本里预置一批真实的模拟数据报到状态、院系、班级都填好演示时点开报表有点有面还能顺着数据讲一讲统计口径。最后说一件我踩过好几次的坑毕设项目不需要把功能做得特别花但一定要能一口气演示完。所以我在搭新生报到系统时永远先把登录、提交报到、管理员审核这三条主链路调到最顺再去做统计报表和导出这些锦上添花的功能。系统交付时把源码、SQL、接口文档、演示账号说明放到一个目录里标清楚启动步骤。一个项目能不能拿高分很多时候不看代码量就看对方能不能在十分钟内把它跑起来。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
