≡ 设计助手模板选购站 联系 刘老师
Guide · 选型与工程实践

Spring Boot 项目本地跑不起来?按这 6 步排查

先别改代码。大部分启动失败集中在 JDK 版本、数据库连接、端口占用和前端代理四类问题,按顺序排查最快。

SpringBoot 项目启动失败SpringBoot 部署Vue 项目启动MySQL 连接失败端口占用

拿到源码后第一次启动失败很常见。不要一上来就怀疑代码,按下面 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、前端静态资源的顺序部署。

部署失败算售后吗?

标准版含基础答疑;远程部署属于增值服务,可在下单时加购。

相关模板

继续阅读

先看演示,再决定是否下单

每套模板都有在线演示、交付清单和工程文档预览,不需要先付款。

查看 35 套模板