Docker Compose指定固定IP报错，旧配置失效求助

问题根源 #

Docker Compose v2的配置合并逻辑与旧版（v1）存在差异：若未确保common.yml的网络定义被优先加载，其他文件仅引用网络名称时，Docker会自动创建带默认子网的网络，而非复用common.yml中自定义子网的配置，最终导致固定IP与子网不匹配触发报错。

具体解决步骤 #

1. 明确指定启动时的文件加载顺序 #

启动命令必须将common.yml放在最前，保证其网络配置被优先加载，后续文件仅做补充：

docker-compose -f common.yml -f service-a.yml -f service-b.yml up -d

Compose v2按文件顺序合并配置，前置文件的网络定义不会被后置文件覆盖，避免自动创建默认网络。

2. 统一在common.yml维护网络配置，其他文件仅引用 #

恢复common.yml中的自定义子网网络定义：

# common.yml
networks:
  main-net:
    driver: bridge
    ipam:
      config:
        - subnet: 172.20.0.0/16
  jmx-net:
    driver: bridge
    ipam:
      config:
        - subnet: 172.21.0.0/16

其他docker-compose文件仅保留网络引用，无需重复定义子网：

# service-a.yml
services:
  app-service:
    networks:
      main-net:
        ipv4_address: 172.20.0.10
      jmx-net:

networks:
  main-net:
    external: false  # 明确使用已定义的网络，禁止自动创建
  jmx-net:
    external: false

3. 清理旧的自动生成网络 #

先停止所有关联服务，再删除Docker自动创建的错误子网网络：

# 停止服务
docker-compose -f common.yml -f service-a.yml -f service-b.yml down
# 删除自动创建的网络
docker network rm main-net jmx-net

重新启动服务后，会加载common.yml中的自定义子网配置。

4. 验证配置正确性 #

• 启动前用以下命令查看合并后的完整配置，确认子网定义已正确加载：

  docker-compose -f common.yml -f service-a.yml -f service-b.yml config
  

• 启动后检查网络实际配置：

  docker inspect main-net
  

  输出中IPAM.Config.Subnet应与common.yml定义一致。

关于重复定义子网的说明 #

重复定义子网虽能临时解决问题，但会造成配置冗余，若各文件子网定义不一致还会触发合并冲突，统一在common.yml维护网络配置是更可靠的方案。

内容的提问来源于stack exchange，提问作者Евгений Шакалов