Docker Compose 重启后容器 IP 变更导致服务不可用怎么排查？

Docker Compose 重启后容器 IP 变更问题在 2024 年多个生产环境中被报告，典型错误信息为"getaddrinfo(host='xxxx', err=12):Timeout while contacting DNS servers"，表明服务间通过硬编码 IP 通信时会出现连接超时。

原因分析

Docker Compose 默认使用 bridge 网络模式，容器每次重启后会被分配新的动态 IP 地址。根据 2024 年 10 月 15 日的技术资料，docker0 网卡默认地址段为 172.17.0.1/16，当宿主机网络与该地址段重叠时会引发路由异常。如果服务配置中硬编码了容器 IP（如 SEATA_IP: 192.168.150.101），重启后 IP 变更会导致连接失败，典型报错为"request:/nacos/v1/ns/instance/list failed,servers:[192.168.150.101:8848],code:500,msg:connect timed out"。

解决方案

方案一：使用服务名代替 IP 地址

Docker Compose 默认提供网络别名，服务间可通过服务名通信。修改 docker-compose.yml 配置，将硬编码 IP 改为服务名：

services:
  web:
    build: .
    depends_on:
      db:
        condition: service_healthy
  db:
    image: postgres:15
    healthcheck:
      test: ["CMD-SHELL","pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5

上述配置中，web 服务通过服务名"db"访问数据库，无需关心 IP 地址变化。根据 2025 年 11 月 12 日发布的资料，depends_on condition 设置为 service_healthy 可确保服务真正就绪后才启动依赖服务。

方案二：配置固定 IP 地址

在 docker-compose.yml 中定义自定义网络并指定固定 IP：

networks:
  app_net:
    driver: bridge
    ipam:
      config:
        - subnet: 172.20.0.0/16

services:
  app:
    image: myapp
    networks:
      app_net:
        ipv4_address: 172.20.0.10

但需注意，2024 年 9 月 13 日的案例显示，设置固定 IP 后若网络配置不当会导致"no upstream connection available"错误。建议先检查宿主机网络是否与 172.17.0.1/16 冲突，如有冲突需修改/etc/docker/daemon.json 调整为非冲突段（如 192.168.200.1/24）。

方案三：添加健康检查与重试机制

在应用层加入重试逻辑，避免因网络延迟引发启动竞争。healthcheck 配置推荐值为：interval 5s、timeout 5s、retries 3-5。使用以下命令实时查看服务输出：

docker-compose logs -f

快速识别启动阻塞点，确认依赖服务是否真正可用。

注意事项

根据多个论坛和 issue 的真实反馈，用户常踩的坑包括：

仅依赖 depends_on 无法等待服务真正可用，需结合 healthcheck 判断服务就绪状态，否则会出现"数据库连接拒绝"错误
YAML 文件格式对缩进敏感，使用 Tab 键缩进会导致解析异常，必须用空格
宿主机端口已被占用会触发"Address already in use"错误，使用"sudo lsof -i :80"或"netstat -ano | findstr :80"排查
非 root 用户操作 docker 需要加入 docker 用户组，否则执行 compose 命令报"permission denied"，执行"sudo usermod -aG docker $user"修复
volumes 配置指向不存在的宿主机目录时容器无法启动，需先执行"mkdir -p ./data"创建目录

参考来源

来源：GitHub Issues - Docker Compose 网络配置问题汇总（2024 年 9 月 13 日）

来源：Docker 官方文档 - Docker Compose 服务依赖机制说明（2025 年 11 月 12 日）

来源：Stack Overflow - Docker 容器 IP 变更导致服务不可用排查指南（2024 年 10 月 15 日）

来源：Docker Compose 运行异常全解析 - 从报错到解决的完整指南（2025 年 9 月 25 日）

笙亿网络策划

Docker Compose重启后容器IP变更导致服务不可用怎么排查？