快速开始

从零跑起第一个环境

拿到源码后在一台干净机器上跑到能下单的最短路径,每步的验证方式与卡住时的检查点。

最后更新:2026/11/19

目标是跑通一次完整下单,不是把所有功能都过一遍。先跑通一条线,再横向铺开。

一、准备

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 端口。默认账号登录后,先建一个商品分类、再建一个商品、设好价格与库存。

七、跑通下单

  1. 前台打开商品列表,找到刚建的商品
  2. 加入购物车 → 下单
  3. 支付选择「测试支付」(开发环境预置,不走真实渠道)
  4. 管理端看到订单状态变为待发货
  5. 发货 → 前台确认收货

这五步都通了,环境就算跑起来了。

八、卡住时查这里

现象检查点
启动报 Communications link failureMySQL 是否在跑、端口与账号是否对
启动报 Redis 连接失败Redis 是否在跑、密码是否配置
管理端登录 404后端是否已启动、代理配置是否正确
前端请求跨域失败后端 CORS 配置与前端的 baseURL
商品图片不显示文件存储路径是否存在、是否有写权限
下单提示库存不足商品是否设置了库存、库存是否为冻结状态

九、下一步

环境跑通后,建议按这个顺序继续:

  1. 读《模块划分与代码结构》了解代码组织
  2. 在测试环境走一遍《一键部署与升级回滚》
  3. 按《部署前需要准备什么》准备正式环境

需要针对你的场景给建议?

不用先看完全部文档。说清产品线与当前进度,我们直接给判断。