SpringBoot+Vue 毕设项目开发踩坑记录（前后端分离）

最近在做一套 SpringBoot+Vue 的本科毕业设计管理系统，过程踩了不少坑，在这里记录下来，给做同类毕设的同学参考。

1. 跨域问题

前后端分离项目最常见的就是跨域报错。很多新手直接在前端配置代理，部署到服务器之后就失效。

推荐方案：后端增加全局跨域配置类，统一处理跨域，本地调试和服务器部署都生效。不要只依靠前端 vue.config.js 代理，代理仅适合本地开发。

2. MyBatis 查询返回 null

遇到 MyBatis 查询字段返回 null，大概率是数据库字段名和实体类属性名不一致。

两种解决办法：

1. 在 application.yml 开启驼峰命名自动转换；
2. 在 Mapper.xml 里写别名映射。
   毕设项目推荐直接开启驼峰，减少 xml 里重复写字段别名。

3. 项目打包部署

SpringBoot 打包用 maven 打包成 jar 包，很多同学会遇到静态资源找不到的问题。

打包前要确认 pom 资源过滤配置，保证 html、js、图片等静态文件能够打入 jar 包。

Linux 服务器运行命令：nohup java -jar xxx.jar &，后台持续运行。

记得开放服务器端口，不然外部无法访问项目。

4. 日期类型传输报错

前端传时间字符串，后端 Date 接收直接报错。

可以用 @DateTimeFormat 和 @JsonFormat 注解配合，统一时间序列化格式，避免接口报错。

总结

SpringBoot+Vue 做毕设上手很快，但是很多细节问题会卡住很久。遇到报错优先看控制台异常信息，大部分问题网上都有解决方案。

我把这套项目的脚手架、部署文档、SQL 脚本整理成资源放在主页，需要做毕设的同学可以参考学习，仅供学习研究。