Docker Compose：自定义桥接网络无法引用容器网络别名

你的问题核心是UI容器的Docker Compose配置存在语法错误，导致它没有正确加入到和API容器共享的桥接网络中，所以别名无法被解析。以下是具体修复步骤和验证方法：

1. 修正UI服务的Compose配置 #

你当前的my-ui-service Compose文件里，networks块被错误缩进在services节点内部，这会导致Docker Compose无法正确识别外部网络配置，UI容器实际并未加入目标桥接网络。修正后的配置如下：

services:
  django-app: 
    build:
      context: ./django-app
      dockerfile: Dockerfile.dev
    networks:
      - my-backend-service_ui-bridge
    ports:
      - "8000:8000"

# 注意：networks块要和services同级，不能嵌套在services里
networks: 
  my-backend-service_ui-bridge: 
    external: true

2. 验证配置生效 #

修正后重启UI服务，然后通过以下步骤确认连通性：

• 检查网络是否存在：执行docker network ls，确认列表中有my-backend-service_ui-bridge网络
• 确认双容器都在该网络：分别执行docker inspect <django-app容器ID> --format '{{.NetworkSettings.Networks}}'和docker inspect <api-container ID> --format '{{.NetworkSettings.Networks}}'，输出内容需包含my-backend-service_ui-bridge
• 在UI容器内测试别名：进入UI容器docker exec -it <django-app容器名> bash，执行curl http://my-api-alias:5000，应该能正常获取API响应

其他可行方案 #

如果别名方案仍有问题，还可以尝试：

• 固定API容器名：在后端Compose的api-container服务中添加container_name: my-api-container，这样UI容器可以直接通过http://my-api-container:5000访问（注意：如果使用docker compose run启动服务，该配置可能不生效，需用docker compose up）
• 直接使用服务名访问：如果后端服务是通过docker compose up启动的，在共享网络中可以直接用后端服务名api-container访问，无需额外配置别名

内容的提问来源于stack exchange，提问作者James