Java 后端 / 系统课时
准备 PostgreSQL、Redis 与 Docker
准备 PostgreSQL、Redis 与 Docker
本课使用 Docker Compose 搭建可重复创建的 PostgreSQL 与 Redis 开发环境,固定端口、账号、数据卷和健康检查,并通过数据库与缓存客户端命令验证真实连通性。
学习目标
- 确认 Docker Engine 与 Compose v2 可以正常运行
- 使用一份 Compose 配置同时启动 PostgreSQL 和 Redis
- 验证服务健康状态、认证信息与 Spring Boot 连接参数
规划本地服务
开发环境需要明确端口、账号和数据持久化位置,避免每次重建都改变连接信息。以下配置仅用于本地开发,生产环境必须改用独立密钥、受控网络和正式备份策略。
| 服务 | 宿主机端口 | 数据库或认证 | 持久化卷 |
|---|---|---|---|
| PostgreSQL | 5432 | 数据库 enterprise,用户 app |
pg_data |
| Redis | 6379 | 密码 redis_dev_password |
redis_data |
先确认 Docker 与 Compose 插件可用。
docker version
docker compose version预期输出
Client: Docker Engine - Community
Server: Docker Engine - Community
...
Docker Compose version v2.<MINOR>.<PATCH>如果只有 Client 信息而没有 Server 信息,说明 Docker 守护进程尚未启动。桌面系统应启动 Docker Desktop,Linux 应检查 Docker 服务状态和当前用户是否有访问 Docker Socket 的权限。
编写 Compose 配置
新建目录 local-infra,在其中创建 compose.yaml。配置使用命名卷保存数据,并通过健康检查区分“容器已启动”和“服务已可用”。
services:
postgres:
image: postgres:16-alpine
container_name: sb3-postgres
environment:
POSTGRES_DB: enterprise
POSTGRES_USER: app
POSTGRES_PASSWORD: app_dev_password
ports:
- "5432:5432"
volumes:
- pg_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U app -d enterprise"]
interval: 5s
timeout: 3s
retries: 10
redis:
image: redis:7-alpine
container_name: sb3-redis
command:
- redis-server
- --appendonly
- "yes"
- --requirepass
- redis_dev_password
ports:
- "6379:6379"
volumes:
- redis_data:/data
healthcheck:
test: ["CMD-SHELL", "REDISCLI_AUTH=redis_dev_password redis-cli ping | grep PONG"]
interval: 5s
timeout: 3s
retries: 10
volumes:
pg_data:
redis_data:开发密码直接写入文件是为了便于首次复现。真实团队项目应改用不提交到 Git 的 .env 文件、Docker Secret 或外部密钥管理服务。启动前先检查 Compose 语法。
docker compose config --quiet预期结果
命令不输出内容且退出码为 0,表示 Compose 配置可以被正确解析。启动并查看健康状态
在 compose.yaml 所在目录启动服务,再查看容器状态。
docker compose up -d
docker compose ps预期输出
NAME SERVICE STATUS
sb3-postgres postgres Up <TIME> (healthy)
sb3-redis redis Up <TIME> (healthy)首次启动会拉取镜像,输出中可能出现下载进度。只有状态进入 healthy 才表示服务完成初始化;刚启动时短暂显示 starting 属于正常现象。
验证 PostgreSQL 与 Redis
从容器内调用 PostgreSQL 客户端,查询当前数据库与当前用户。这一步同时验证容器、数据库初始化和账号认证。
docker compose exec -T postgres psql -U app -d enterprise -c "select current_database(), current_user;"预期输出
current_database | current_user
------------------+--------------
enterprise | app
(1 row)再通过 Redis 客户端执行 PING。使用环境变量传递密码,可以避免命令行参数产生密码警告。
docker compose exec -T -e REDISCLI_AUTH=redis_dev_password redis redis-cli ping预期输出
PONG两个命令都成功后,说明服务内部认证可用。宿主机应用还需要使用映射端口连接,因此端口被其他程序占用时,容器可能无法正常启动。
准备 Spring Boot 连接参数
后续项目可通过环境变量覆盖连接信息,避免把开发密码硬编码在 Java 源码中。以下变量可放入 IDE 的运行配置或本地启动脚本。
export SPRING_DATASOURCE_URL="jdbc:postgresql://localhost:5432/enterprise"
export SPRING_DATASOURCE_USERNAME="app"
export SPRING_DATASOURCE_PASSWORD="app_dev_password"
export SPRING_DATA_REDIS_HOST="localhost"
export SPRING_DATA_REDIS_PORT="6379"
export SPRING_DATA_REDIS_PASSWORD="redis_dev_password"生效行为
Spring Boot 启动时会读取上述环境变量,并覆盖对应的数据源与 Redis 配置项。如果 Spring Boot 应用也运行在同一 Compose 网络中,主机名应改为服务名 postgres 和 redis,不能继续使用 localhost;容器内的 localhost 只代表当前应用容器。
定位失败并管理数据
服务未进入健康状态时,先查看最近日志。
docker compose logs postgres redis --tail=100预期结果
日志应显示 PostgreSQL 初始化或 Redis 启动过程;错误行通常会指出端口、权限、配置或认证问题。日常暂停使用 Compose 的 stop 子命令,恢复使用 start。删除容器和网络使用 down,它默认保留命名卷;只有明确需要清空全部数据库与缓存数据时,才在 down 后增加 -v。
端口冲突时,可将 PostgreSQL 映射改为 "15432:5432",并同步修改 JDBC 地址。若修改密码后认证仍失败,通常是旧数据卷保留了首次初始化结果;确认数据可删除后再清空卷并重建。