前言
很多同学拿到一个全栈项目源码后，第一步就卡在“怎么跑起来”。本文以一套开源代驾系统为例，完整演示从环境准备到服务启动、后台登录的全过程，步骤可直接复用到同类 Spring Boot + Vue 项目。
源码地址： gitee.com/zhoujian666…
环境准备
- JDK 17（本项目已从 Java 8 升级到 17）
- Maven 3.6+
- Node.js 16+ 与 npm
- MySQL 8
- Redis 5+
- RabbitMQ 3.8+
第一步：克隆代码
git clone https://gitee.com/zhoujian6666/biaoma-ride-car-service.git
仓库中包含后端服务与管理后台前端两部分代码。
第二步：初始化数据库
- 创建数据库（utf8mb4 编码）
- 执行仓库中的 SQL 初始化脚本，生成业务表结构与基础数据
- 记录数据库账号密码，后面配置用
第三步：配置后端
修改后端工程的配置文件（application.yml 或对应 profile）：
- 数据源：MySQL 地址、账号、密码
- Redis：地址、端口、密码
- RabbitMQ：连接信息
- 第三方服务：高德地图 Key、微信支付/支付宝支付参数（本地调试可先不配置支付回调域名）
注意 Java 17 下部分老依赖需要升级版本，本项目已处理完毕，直接用 Maven 安装依赖即可。
第四步：启动后端服务
系统包含两个 API 服务：
- 管理端 API：供后台管理系统调用
- 用户端 API：供用户端/司机端调用，内嵌 Netty WebSocket 服务
分别用 Maven 启动，启动后检查端口与日志，确认无 Bean 初始化错误。
第五步：启动管理后台前端
cd 前端目录
npm install
npm run serve
前端基于 Vue 2 + Vue CLI 5（webpack 5），Node 版本建议 16 或 18。启动后浏览器访问本地端口，使用初始化脚本中的管理员账号登录。
常见问题
- npm install 报错 node-sass 相关：Node 版本过高，切到 16/18 即可
- 后端启动报 SSL 连接错误：MySQL 8 默认开启 SSL，连接串加 useSSL=false
- WebSocket 连不上：检查用户端 API 是否成功启动，Netty 端口是否被占用
- 支付回调失败：本地环境没有公网回调地址属于正常现象，可先用沙箱或注释回调逻辑调试
写在最后
跑通这套流程后，你就拥有了一个完整的代驾业务系统：下单、派单、计价、支付、分润、后台管理全部可用，适合做毕设演示或二次开发起点。
遇到问题欢迎评论区交流，觉得有用欢迎 Star。
