如何用.env参数化Dockerfile？docker-compose结合pytest运行时网络未定义错误排查

你的问题出在两个核心点：docker-compose的网络引用配置错误，以及pytest-testcontainers没有正确加载你的环境变量文件，下面一步步给你解决：

1. 修正docker-compose.yml的网络引用 #

在你的docker-compose文件里，networks块已经定义了一个内部引用名为atp的网络，它指向外部的$NETWORK_NAME网络。但在services.rabbitmq_local.networks里，你错误地使用了$NETWORK_NAME作为网络引用——这是不对的，因为这个字段需要填写的是你在networks块里定义的内部别名（也就是atp），而不是实际的外部网络名称。

修改后的docker-compose.yml这部分应该是：

version: '2.3'
networks:
  atp:
    name: $NETWORK_NAME
    external: true
services:
  rabbitmq_local:
    image: 'rabbitmq:3.6-management-alpine'
    ports:
      - '5672:5672'
      - '15672:15672'
    networks:
      - atp  # 这里改成内部别名atp

2. 确保pytest-testcontainers加载你的环境变量文件 #

docker-compose默认只会自动加载当前目录下名为.env的文件，而你的文件叫rabbit.env，所以pytest在调用docker-compose时并没有加载这个文件，导致$NETWORK_NAME变量为空，才会出现undefined network ""的错误。

你有两种解决方式：

方式一：重命名环境变量文件 #

直接把rabbit.env改名为.env，这样docker-compose（包括pytest-testcontainers调用它时）会自动加载里面的环境变量。

方式二：在pytest fixture里指定env文件 #

如果不想重命名文件，可以在你的network fixture里显式指定要加载的env文件。比如：

from testcontainers.compose import DockerCompose
import pytest

@pytest.fixture(scope="session")
def network():
    # 指定env_file参数为你的rabbit.env
    with DockerCompose(".", compose_file_name="docker-compose.yml", env_file="rabbit.env") as compose:
        yield compose

为什么原来的写法会报错？ #

• 当你在services里写-$NETWORK_NAME时，docker-compose会把它当作一个内部网络的名称去查找，但你并没有在networks块里定义这个名称的网络，而且因为环境变量没加载，这个变量是空字符串，所以就提示找不到未定义的空网络。
• 正确的逻辑是：通过networks块定义一个内部别名，关联到外部的实际网络名，然后services引用这个内部别名即可。

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