Docker Compose构建时.env变量未替换致Azure认证失败

我的配置与代码 #

docker-compose.yaml #

services:
  planview:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: planview
    environment:
      - AZURE_TENANT_ID=${AZURE_TENANT_ID}
      - AZURE_CLIENT_ID=${AZURE_CLIENT_ID}
      - AZURE_CLIENT_SECRET=${AZURE_CLIENT_SECRET}

Python凭据获取代码 #

load_dotenv(".env")
client_id = os.getenv('AZURE_CLIENT_ID')
tenant_id = os.getenv('AZURE_TENANT_ID')
client_secret = os.getenv('AZURE_CLIENT_SECRET')

Dockerfile #

FROM python:3.10

ADD planview.py .

WORKDIR /code

COPY ./requirements.txt /code/requirements.txt

RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt

COPY . /code/app

CMD ["python3", "/planview.py"]

问题现象 #

执行docker compose up时，镜像构建、容器运行、脚本执行均正常；但执行docker compose build创建镜像时，抛出错误：

ValueError: client_id should be the id of an Azure Active Directory application

已确认凭据有效，尝试过env_file:配置也无法解决，找不到docker-compose的问题点。

核心问题是构建阶段（build）无法获取docker-compose里的environment变量，这些变量仅在容器运行阶段生效；同时构建过程中你的脚本也无法正确加载本地.env文件，最终导致凭据为空触发错误。

具体原因 #

1. docker-compose的environment属于容器运行时参数，构建镜像时不会注入这些变量，所以build阶段脚本执行时拿不到AZURE相关值，client_id为空引发报错。
2. Dockerfile的文件路径逻辑混乱：脚本被加到根目录，但.env被复制到/code/app，运行时脚本在根目录执行，load_dotenv(".env")找不到文件——但docker compose up时，运行时环境变量覆盖了脚本的.env加载逻辑，所以能正常工作。

修复步骤 #

方法1：仅在运行时加载凭据（推荐，安全）

确保脚本只在容器启动后才执行凭据验证逻辑，避免在构建阶段（比如模块导入时）触发验证。

• 把需要凭据的代码移到if __name__ == "__main__":块内，或者移到运行时才调用的函数中。
• 修正Dockerfile的路径问题，保证文件结构清晰：

FROM python:3.10

WORKDIR /code

# 先复制依赖文件，利用Docker缓存
COPY requirements.txt .
RUN pip install --no-cache-dir --upgrade -r requirements.txt

# 复制所有代码到工作目录
COPY . .

# 执行工作目录下的脚本
CMD ["python3", "planview.py"]

这样脚本和.env在同一目录，load_dotenv(".env")能正确加载，同时运行时docker-compose的environment变量会覆盖.env的值，两种方式都能生效。

方法2：构建阶段传递环境变量（不推荐，不安全）

如果必须在构建阶段使用凭据，需要通过构建参数传递，但会把凭据直接打包进镜像，存在安全风险：

• 修改docker-compose.yaml，添加构建参数：

services:
  planview:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        - AZURE_TENANT_ID=${AZURE_TENANT_ID}
        - AZURE_CLIENT_ID=${AZURE_CLIENT_ID}
        - AZURE_CLIENT_SECRET=${AZURE_CLIENT_SECRET}
    container_name: planview
    environment:
      - AZURE_TENANT_ID=${AZURE_TENANT_ID}
      - AZURE_CLIENT_ID=${AZURE_CLIENT_ID}
      - AZURE_CLIENT_SECRET=${AZURE_CLIENT_SECRET}

• 修改Dockerfile，接收构建参数并转为环境变量：

FROM python:3.10

ARG AZURE_TENANT_ID
ARG AZURE_CLIENT_ID
ARG AZURE_CLIENT_SECRET

ENV AZURE_TENANT_ID=$AZURE_TENANT_ID
ENV AZURE_CLIENT_ID=$AZURE_CLIENT_ID
ENV AZURE_CLIENT_SECRET=$AZURE_CLIENT_SECRET

WORKDIR /code

COPY requirements.txt .
RUN pip install --no-cache-dir --upgrade -r requirements.txt

COPY . .

CMD ["python3", "planview.py"]

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