Docker Compose 实战：一键部署 Web、数据库与缓存微服务环境

2.2 核心配置项拆解

1. version（版本号）

• 用于指定 Docker Compose 的配置版本，需与本地安装的 Docker Compose 版本匹配，否则可能出现兼容性问题。
• 常用版本：3（兼容 Docker 1.13.0 及以上版本），建议直接使用 3.x 版本。

2. services（服务定义）

• 整个配置文件的核心节点，所有需要启动的容器都定义在这个节点下，每个子节点代表一个服务（一个容器）。
• 子节点名称（如 web、mysql、redis）可自定义，建议与服务功能对应，便于识别。

3. 常用服务配置参数

⚠️ 注意：depends_on 只控制容器的启动顺序，不保证依赖服务完全启动（比如 mysql 容器启动，但服务未就绪，web 服务可能启动失败），后续可通过健康检查优化。

三、实战：一键启动 Web+MySQL+Redis 微服务环境

本次实战将搭建一个完整的微服务基础环境，包含 3 个服务：

1. Web 服务：SpringBoot 简单测试应用（模拟实际业务应用）
2. 数据库服务：MySQL 8.0（存储业务数据）
3. 缓存服务：Redis 6.2（缓存热点数据，提升应用性能）

3.1 实战准备

1. 本地已安装 Docker 和 Docker Compose（执行 docker-compose -v 验证）。
2. 新建一个项目目录（如 docker-compose-demo），用于存放 docker-compose.yml 文件和相关挂载目录。
3. 目录结构（最终）：

docker-compose-demo/
├── docker-compose.yml
├── mysql/
│   ├── data/
│   └── conf/
└── redis/
    └── data/

3.2 编写 docker-compose.yml 文件

进入 docker-compose-demo 目录，新建 docker-compose.yml 文件，复制下面的配置：

version: '3'
services:
  # Web 应用服务
  web-app:
    image: java:8-jdk-alpine
    container_name: springboot-test-app
    ports:
      - "8080:8080"
    volumes:
      - ./web/app.jar:/app.jar
    command: java -jar /app.jar
    depends_on:
      - mysql-db
      - redis-cache
    environment:
      - SPRING_DATASOURCE_URL=jdbc:mysql://mysql-db:3306/test_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
      - SPRING_DATASOURCE_USERNAME=root
      - SPRING_DATASOURCE_PASSWORD=123456
      - SPRING_REDIS_HOST=redis-cache
      - SPRING_REDIS_PORT=6379
      - SPRING_REDIS_PASSWORD=123456
    restart: always

  # MySQL 数据库服务
  mysql-db:
    image: mysql:8.0
    container_name: mysql-8.0-db
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=123456
      - MYSQL_DATABASE=test_db
      - MYSQL_CHARSET=utf8mb4
      - MYSQL_COLLATION=utf8mb4_unicode_ci
      - TZ=Asia/Shanghai
    volumes:
      - ./mysql/data:/var/lib/mysql
      - ./mysql/conf:/etc/mysql/conf.d
    restart: always

  # Redis 缓存服务
  redis-cache:
    image: redis:6.2
    container_name: redis-6.2-cache
    ports:
      - "6379:6379"
    command: redis-server --requirepass 123456 --appendonly yes
    volumes:
      - ./redis/data:/data
    restart: always
    environment:
      - TZ=Asia/Shanghai

3.3 一键启动所有服务

1. 打开终端，进入 docker-compose-demo 目录。
2. 执行启动命令：

# 后台启动所有服务（推荐）
docker-compose up -d

# 可选：前台启动，实时查看容器日志
# docker-compose up

3. 启动成功后，执行以下命令，查看容器运行状态：

docker-compose ps

如果所有服务的 State 都显示 Up，说明整套微服务环境启动成功！

3.4 常用 Docker Compose 命令

# 1. 后台启动所有服务
docker-compose up -d

# 2. 停止所有服务（不删除容器和数据）
docker-compose stop

# 3. 停止并删除所有服务、容器
docker-compose down

# 4. 查看所有服务日志
docker-compose logs

# 5. 重启所有服务
docker-compose restart

# 6. 查看服务状态
docker-compose ps

3.5 实战验证

1. 验证 MySQL：使用 Navicat 等工具，连接宿主机 IP:3306，用户名 root，密码 123456，查看是否能成功连接，且存在 test_db 数据库。
2. 验证 Redis：使用 Redis Desktop Manager 等工具，连接宿主机 IP:6379，密码 123456。
3. 验证 Web 应用：打开浏览器，访问 http://localhost:8080，若能看到 SpringBoot 应用的默认页面或自定义接口返回，说明 Web 服务启动成功。

四、常见问题与避坑指南

问题 1：启动时报'version 不兼容'错误

• 原因：docker-compose.yml 文件中的 version 版本，与本地安装的 Docker Compose 版本不匹配。
• 解决方案：将 version 改为 3，或升级 Docker Compose 到最新版本。

问题 2：Web 服务启动失败，提示'无法连接 MySQL/Redis'

• 原因：depends_on 只控制启动顺序，不保证依赖服务完全就绪。
• 解决方案：简单方案：重启 Web 服务；进阶方案：添加健康检查。

问题 3：容器删除后，数据丢失

• 原因：未配置 volumes 数据卷挂载。
• 解决方案：给需要持久化数据的服务配置 volumes 挂载，将数据存储到宿主机目录。

问题 4：执行 docker-compose 命令时，提示'command not found'

• 原因：Docker Compose 未安装，或未配置环境变量。
• 解决方案：重新安装 Docker Compose，并配置环境变量。

五、结尾总结

本文从 Docker Compose 的核心概念出发，拆解了 docker-compose.yml 的关键配置，再通过一个完整的实战案例，教大家一键启动 Web+MySQL+Redis 微服务环境，同时分享了常用命令和避坑指南，适合新手快速上手。

Docker Compose 的核心价值在于'简化配置、统一环境、提升效率'，尤其适合后端开发、测试环境的部署。掌握它之后，你可以轻松管理多个容器，告别繁琐的手动操作，将更多精力放在业务开发上。

建议大家多动手实践，修改配置、尝试添加新的服务（如 Nginx 反向代理），逐步熟练 Docker Compose 的用法。