Docker与.env联动异常：Dockerfile读取.env变量失败求助

问题根源 #

Docker Compose的env_file仅作用于容器运行阶段，构建Docker镜像时（Dockerfile执行过程）无法直接读取.env里的变量；同时多阶段构建中，每个FROM指令会创建独立的构建上下文，前一阶段的ENV变量不会传递到后续阶段，导致Dockerfile中${LANGUAGE}:${LANGUAGE_VERSION}-${WEB_SERVER}这类变量无法解析，依赖.env的逻辑执行失败。

具体修复步骤 #

1. 在Docker Compose中传递构建参数

修改docker-compose.yml的build区块，新增args配置，把.env中的变量传递给Docker构建阶段：

version: '3.8'

services:
  web:
    stdin_open: true
    tty: true
    build:
      context: .
      dockerfile: Dockerfile
      args:
        - LANGUAGE=${LANGUAGE}
        - LANGUAGE_VERSION=${LANGUAGE_VERSION}
        - WEB_SERVER=${WEB_SERVER}
    ports:
      - ${WEB_SERVER_PORT}:${WEB_SERVER_PORT}
    volumes:
      - ${APP_SOURCE_CODE_PATH}:${CONTAINER_WORKDIR}
    environment:
      - APP_ENV=${APP_ENV}
    networks:
        - mynetwork
    init: true

注：原配置中的env_file可移除，因为构建阶段不需要它，容器运行阶段的环境变量已通过environment传递。

2. 简化Dockerfile的多阶段逻辑

原有的dummy镜像阶段完全冗余，直接在主构建阶段定义ARG并使用：

# 定义构建参数，给LANGUAGE设置默认值匹配团队需求
ARG LANGUAGE=php
ARG LANGUAGE_VERSION
ARG WEB_SERVER

# 直接使用构建参数指定基础镜像
FROM ${LANGUAGE}:${LANGUAGE_VERSION}-${WEB_SERVER}

# 校验必填构建参数
RUN if [ -z "${LANGUAGE}" ] || [ -z "${LANGUAGE_VERSION}" ] || [ -z "${WEB_SERVER}" ]; then \
        echo "Error: Missing required build arguments (LANGUAGE, LANGUAGE_VERSION, WEB_SERVER)"; \
        exit 1; \
    fi

# 后续安装依赖、配置环境的步骤...

3. 补全.env文件的变量

确保.env里包含所有构建所需的变量，示例：

# --------------------------------------------------------
#           Docker Compose Configuration
# --------------------------------------------------------

# Programming Language Configuration
# --------------------------------------------------------
LANGUAGE=php
LANGUAGE_VERSION=8.2
WEB_SERVER=apache

# 其他运行时变量
WEB_SERVER_PORT=80
APP_SOURCE_CODE_PATH=./src
CONTAINER_WORKDIR=/var/www/html
APP_ENV=development

验证修复 #

执行构建命令测试：

docker-compose build web

构建成功后启动容器：

docker-compose up -d

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