架构与系统设计 / 系统课时

开发环境准备

开发环境准备

企业支付平台同时依赖 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 异步通知与事件解耦

检查本机工具

在终端执行以下命令,先确认命令可用,再继续启动容器。不同操作系统显示的补丁版本可能不同,只要主版本满足要求即可。

bash
java -version
mvn -version
docker version --format '{{.Server.Version}}'
docker compose version

预期输出

text
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。示例将数据写入命名卷,重启容器后数据仍会保留;账号仅用于本地开发,不应复制到生产环境。

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。执行启动命令:

bash
docker compose up -d
docker compose ps

预期输出

text
NAME           SERVICE    STATUS
pay-mysql      mysql      Up (healthy)
pay-redis      redis      Up
pay-rabbitmq   rabbitmq   Up

首次拉取镜像会显示下载进度,表格顺序和状态文本可能略有差异。MySQL 需要完成初始化后才会进入 healthy。

验证服务可用

不要只看容器处于运行状态,还要执行一次真实读写或协议响应。以下命令分别验证数据库查询、Redis 心跳和 RabbitMQ 节点状态。

bash
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

预期输出

text
1
1
PONG
Ping succeeded

如果端口被占用,先用 docker compose down 停止当前环境,或修改宿主机端口,例如把 "3306:3306" 改为 "13306:3306"。应用连接地址也要同步改为 localhost:13306。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

开发环境准备

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通