Java 后端 / 系统课时
使用 Docker Compose 联调
使用 Docker Compose 联调
本课解决企业后端开发中多服务本地联调复杂的问题,最终能够使用 Docker Compose 编排 Spring Boot、PostgreSQL、Redis、Kafka 和监控组件,并验证服务间网络与数据持久化。
学习目标
- 理解 Compose 中服务、网络和数据卷的关系
- 掌握多组件环境的编排配置方法
- 能够定位容器启动、连接和持久化问题
设计多服务联调结构
企业级 Spring Boot 应用通常依赖数据库、缓存、消息队列和监控系统。Docker Compose 可以通过统一配置文件描述这些组件,让开发环境快速复现生产依赖关系。
服务之间默认通过 Compose 创建的内部网络通信,数据库和缓存数据则需要通过数据卷保存,避免容器删除后数据丢失。

编写 Compose 配置
以下是一个简化联调环境示例,展示应用依赖和持久化配置。
yaml
services:
app:
image: spring-app:<ID>
ports:
- "<PORT>:<PORT>"
depends_on:
- postgres
- redis
- kafka
postgres:
image: postgres:16
environment:
POSTGRES_PASSWORD: example
volumes:
- pg-data:/var/lib/postgresql/data
redis:
image: redis:7
kafka:
image: apache/kafka:<ID>
volumes:
pg-data:启动环境:
bash
docker compose up -d预期输出
text
Container app started
Container postgres started
Container redis started
Container kafka started验证网络与持久化
Compose 服务之间使用服务名解析。例如应用连接数据库时,应使用 postgres 作为主机名,而不是本机地址。
bash
docker compose ps预期输出
text
NAME STATUS
app running
postgres running
redis running
kafka running停止并重新启动环境后,需要确认 PostgreSQL 数据仍存在,这说明数据卷配置生效。
排查联调失败问题
容器环境出现问题时,应按照服务状态、网络连接、配置参数、数据持久化顺序定位。
常见原因包括:应用启动早于数据库就绪、端口映射错误、容器内部地址使用错误、数据卷权限不足等。查看日志可以快速确认启动阶段失败原因:
bash
docker compose logs app预期结果
text
Application started successfully按自己的节奏,确认真正理解。