架构与系统设计 / 系统课时
开发环境准备
开发环境准备
企业支付平台同时依赖 Java 运行时、构建工具和多种基础设施。本课使用“本机开发工具 + Docker 容器”的方式完成统一环境,最终得到可编译工程,并能连通 MySQL、Redis 与 RabbitMQ。
学习目标
- 准备 JDK 21、Maven 3.9+ 与 Docker Compose v2
- 用一份 Compose 文件启动数据库、缓存和消息队列
- 通过命令验证端口、账号与容器健康状态
确定环境基线
建议把 Java 与 Maven 安装在本机,把有状态中间件放入容器。这样 IDE 调试速度更快,基础设施版本也能由配置文件固定,团队成员不必分别手工安装数据库和消息队列。
| 组件 | 建议基线 | 本地用途 |
|---|---|---|
| JDK | 21 | 编译和运行 Spring Boot 服务 |
| Maven | 3.9+ | 依赖解析、测试与打包 |
| Docker Compose | v2 | 编排本地基础设施 |
| MySQL | 8.4 | 交易、商户与配置数据 |
| Redis | 7 | 缓存、幂等键与分布式锁 |
| RabbitMQ | 4 | 异步通知与事件解耦 |
检查本机工具
在终端执行以下命令,先确认命令可用,再继续启动容器。不同操作系统显示的补丁版本可能不同,只要主版本满足要求即可。
java -version
mvn -version
docker version --format '{{.Server.Version}}'
docker compose version预期输出
openjdk version "21.<PATCH>"
Apache Maven 3.9.<PATCH>
<DOCKER_VERSION>
Docker Compose version v2.<PATCH>若 java 或 mvn 找不到,先配置 JAVA_HOME,再把 JDK 和 Maven 的 bin 目录加入 PATH。若 Docker Server 版本无法读取,通常是 Docker Desktop 或 Docker Engine 尚未启动。
启动基础设施
在工程根目录创建 compose.yaml。示例将数据写入命名卷,重启容器后数据仍会保留;账号仅用于本地开发,不应复制到生产环境。
services:
mysql:
image: mysql:8.4
container_name: pay-mysql
environment:
MYSQL_ROOT_PASSWORD: root123
MYSQL_DATABASE: pay_platform
MYSQL_USER: pay
MYSQL_PASSWORD: pay123
ports:
- "3306:3306"
volumes:
- mysql-data:/var/lib/mysql
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-proot123"]
interval: 5s
timeout: 3s
retries: 20
redis:
image: redis:7-alpine
container_name: pay-redis
ports:
- "6379:6379"
command: ["redis-server", "--appendonly", "yes"]
volumes:
- redis-data:/data
rabbitmq:
image: rabbitmq:4-management
container_name: pay-rabbitmq
environment:
RABBITMQ_DEFAULT_USER: pay
RABBITMQ_DEFAULT_PASS: pay123
ports:
- "5672:5672"
- "15672:15672"
volumes:
- rabbitmq-data:/var/lib/rabbitmq
volumes:
mysql-data:
redis-data:
rabbitmq-data:该配置生效后,MySQL、Redis 和 RabbitMQ 分别监听 3306、6379、5672,RabbitMQ 管理页面监听 15672。执行启动命令:
docker compose up -d
docker compose ps预期输出
NAME SERVICE STATUS
pay-mysql mysql Up (healthy)
pay-redis redis Up
pay-rabbitmq rabbitmq Up首次拉取镜像会显示下载进度,表格顺序和状态文本可能略有差异。MySQL 需要完成初始化后才会进入 healthy。
验证服务可用
不要只看容器处于运行状态,还要执行一次真实读写或协议响应。以下命令分别验证数据库查询、Redis 心跳和 RabbitMQ 节点状态。
docker exec pay-mysql mysql -upay -ppay123 -e "SELECT 1;" pay_platform
docker exec pay-redis redis-cli ping
docker exec pay-rabbitmq rabbitmq-diagnostics -q ping预期输出
1
1
PONG
Ping succeeded如果端口被占用,先用 docker compose down 停止当前环境,或修改宿主机端口,例如把 "3306:3306" 改为 "13306:3306"。应用连接地址也要同步改为 localhost:13306。