目标是跑通一次完整下单,不是把所有功能都过一遍。先跑通一条线,再横向铺开。
一、准备
git clone <仓库地址>
cd zhimengdie-b2c-mall-root需要的环境:JDK 21、Maven 3.9+、Node 22+、MySQL 8、Redis 6+。可以全装在本机,也可以用 Docker 起中间件。
二、起中间件
最省事的方式是用 Docker Compose 起 MySQL 与 Redis(编排文件在 docker/ 下):
docker compose -f docker/compose-middleware.yml up -d验证:
docker ps # 两个容器都是 Up
mysql -h127.0.0.1 -uroot -p -e "show databases;"
redis-cli -h 127.0.0.1 ping # PONG三、建库与初始化
mysql -uroot -p -e "CREATE DATABASE zhimengdie_b2c_mall DEFAULT CHARSET utf8mb4;"
mysql -uroot -p zhimengdie_b2c_mall < docker/sql/full.sql字符集必须是
utf8mb4。用默认字符集会在这里埋下后面所有中文乱码的坑。
四、改配置
配置在 env/ 下,从模板复制:
cp env/application-dev.yml.example env/application-dev.yml要改的就三项:数据库连接、Redis 连接、文件存储路径。其它保持默认。
五、编译与启动
mvn -DskipTests clean install # 首次约 3~5 分钟
mvn -pl zhimengdie-server spring-boot:run启动成功的标志:日志里出现 Started ZhimengdieApplication in x seconds,且没有 APPLICATION FAILED TO START。
验证:
curl http://127.0.0.1:8986/actuator/health
# {"status":"UP"}六、起管理端与前台
cd web && npm ci && npm run dev管理端默认 3100 端口。默认账号登录后,先建一个商品分类、再建一个商品、设好价格与库存。
七、跑通下单
- 前台打开商品列表,找到刚建的商品
- 加入购物车 → 下单
- 支付选择「测试支付」(开发环境预置,不走真实渠道)
- 管理端看到订单状态变为待发货
- 发货 → 前台确认收货
这五步都通了,环境就算跑起来了。
八、卡住时查这里
| 现象 | 检查点 |
|---|---|
启动报 Communications link failure | MySQL 是否在跑、端口与账号是否对 |
| 启动报 Redis 连接失败 | Redis 是否在跑、密码是否配置 |
| 管理端登录 404 | 后端是否已启动、代理配置是否正确 |
| 前端请求跨域失败 | 后端 CORS 配置与前端的 baseURL |
| 商品图片不显示 | 文件存储路径是否存在、是否有写权限 |
| 下单提示库存不足 | 商品是否设置了库存、库存是否为冻结状态 |
九、下一步
环境跑通后,建议按这个顺序继续:
- 读《模块划分与代码结构》了解代码组织
- 在测试环境走一遍《一键部署与升级回滚》
- 按《部署前需要准备什么》准备正式环境