拿到源码后第一次启动失败很常见。不要一上来就怀疑代码,按下面 6 步从环境到前端逐层排查,通常 10 分钟内能定位。
第 1 步:确认 JDK 版本
先看项目 pom.xml 里的 java.version 或 maven.compiler.source。Spring Boot 3 需要 JDK 17+,Spring Boot 2.7 通常用 JDK 8/11。版本不匹配时,常见报错是 Unsupported class file major version 或编译不通过。
java -version
mvn -v
第 2 步:确认 Maven 依赖能下载
如果卡在依赖下载,先看网络和镜像配置。国内环境可以在 settings.xml 配置阿里云镜像;如果公司网络限制,改用离线仓库。不要反复删除 .m2,先看具体是哪个依赖失败。
第 3 步:确认 MySQL 已启动、库已建、账号能连
按顺序检查:MySQL 服务是否运行、数据库是否已创建、账号密码是否与配置文件一致、时区和字符集是否正确。常见报错是 Unknown database、Access denied、Communications link failure。
mysql -h127.0.0.1 -uroot -p
show databases;
use your_db;
show tables;
第 4 步:检查配置文件
重点看 application.yml / application.properties 中的数据源、端口、文件上传路径、跨域白名单。很多项目区分 dev / prod 配置,启动时确认激活的是哪一个。
第 5 步:检查端口占用
后端默认 8080,但一套服务器上可能同时跑了多个系统。端口被占用时,启动日志会明确写 Port 8080 was already in use。改端口后,记得同步前端代理地址。
# Windows
netstat -ano | findstr :8080
# Linux / macOS
lsof -i :8080
第 6 步:前端单独启动,先代理再打包
前端先 npm install,再 npm run dev;确认 vite.config / vue.config 里的代理指向后端端口。页面能打开但接口 404,通常是代理没配或后端 context-path 不一致;页面空白,先看浏览器 Console 和 Network。
还是起不来怎么办
把三样东西发给技术支持:启动日志最后 50 行、JDK/Maven/MySQL 版本、你改过的配置文件。不要只发一句“跑不起来”,没有日志很难定位。
每套模板都有在线演示、交付清单和工程文档预览,不需要先付款。
常见问题
Windows 一键部署包需要装什么?
通常自带 JRE、MySQL、Nginx 和启动脚本,按安装说明双击运行即可;端口冲突时会自动避让或提示修改。
可以部署到自己的云服务器吗?
可以。项目提供 Linux 部署说明,按 JDK、MySQL、Nginx、后端 jar、前端静态资源的顺序部署。
部署失败算售后吗?
标准版含基础答疑;远程部署属于增值服务,可在下单时加购。