Docker注入的环境变量无法被Python脚本读取

核心原因 #

Docker 镜像构建阶段（RUN 指令执行时）和容器运行阶段是完全隔离的两个环境：

• 通过 docker run --env-file env.list 注入的环境变量属于容器运行时变量，构建镜像时的 RUN 指令根本无法访问这些变量。
• 若你在 Dockerfile 中用 ENV 配置了变量但 RUN 脚本仍读不到，大概率是 ENV 指令写在了 RUN 指令之后——Dockerfile 按顺序执行，后续指令无法影响前面的指令。

对应解决办法 #

1. 需在构建阶段使用该变量 #

如果你的 Python 脚本必须在构建镜像时执行且依赖该变量，不能用 docker run 注入的方式，要在构建阶段传递变量：

• 修改 Dockerfile，用 ARG 接收构建参数，再转为 ENV 供 RUN 使用：

  ARG INJECT_THIS
  ENV INJECT_THIS=$INJECT_THIS
  COPY run.py .
  RUN python run.py
  

• 执行构建命令时传递参数：

  docker build --build-arg INJECT_THIS=your_target_value .
  

• 若想直接从 env.list 读取构建参数，可执行：

  docker build --build-arg $(cat env.list) .
  

2. 仅需在容器运行时执行脚本 #

把 Dockerfile 中的 RUN python run.py 替换为 CMD 或 ENTRYPOINT 指令，让脚本在容器启动（运行阶段）时执行，这样就能读取到 docker run 注入或 Dockerfile 中 ENV 配置的变量：
修改后的 Dockerfile 示例：

FROM python:3.9
COPY run.py .
# 可选：在镜像中预设置默认变量值
# ENV INJECT_THIS=default_value
CMD ["python", "run.py"]

启动容器时执行：

docker run --env-file env.list your-built-image

此时脚本就能通过 os.environ["INJECT_THIS"] 读取到目标变量。

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