GCP Cloud Build中Docker COPY .env文件失败问题求助

问题场景 #

本地环境中.env与Dockerfile同目录，未在.dockerignore中排除该文件，但GCP Cloud Build执行COPY .env .env时提示：

COPY failed: file not found in build context or excluded by .dockerignore: stat .env: file does not exist

构建直接失败。

关键构建日志片段 #

Step #0: Step 5/8 : COPY . /app/
Step #0:  ---> bbd7f8e842ba
Step #0: Step 6/8 : COPY .env .env
Step #0: COPY failed: file not found in build context or excluded by .dockerignore: stat .env: file does not exist
Finished Step #0
ERROR
ERROR: build step 0 "gcr.io/cloud-builders/docker" failed: step exited with non-zero status: 1

涉及的Dockerfile内容 #

# 基础镜像设置
FROM python:3.10-slim

# 工作目录设置
WORKDIR /app

# 将所需文件复制到工作目录
COPY requirements.txt /app/
RUN pip install -r requirements.txt

COPY . /app/

COPY .env .env

# 收集Django的静态文件
RUN python manage.py collectstatic --noinput

# 启动Django应用
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "config.wsgi:application"]

解决方案 #

1. 确认GCP Cloud Build的构建上下文包含.env文件 #

• 若使用Cloud Source Repository作为构建源：检查.env文件是否已提交到仓库，未被.gitignore规则排除。
• 若使用本地目录提交构建：执行gcloud builds submit时，确保当前工作目录包含.env，且命令未限制上下文范围（如仅提交部分文件）。

2. 移除Dockerfile中冗余的COPY指令 #

观察Dockerfile可知，COPY . /app/已将当前目录下所有未被.dockerignore排除的文件复制到/app/，后续的COPY .env .env完全冗余，且会因构建上下文缺失.env报错。直接删除该行即可解决错误，同时优化构建步骤。

修改后的Dockerfile：

# 基础镜像设置
FROM python:3.10-slim

# 工作目录设置
WORKDIR /app

# 将所需文件复制到工作目录
COPY requirements.txt /app/
RUN pip install -r requirements.txt

COPY . /app/

# 收集Django的静态文件
RUN python manage.py collectstatic --noinput

# 启动Django应用
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "config.wsgi:application"]

3. 再次验证.dockerignore规则 #

检查项目根目录的.dockerignore文件，确保没有以下规则：

• 直接排除.env
• 使用通配符如*.env排除所有环境文件
• 父级目录的.dockerignore间接影响构建上下文（Cloud Build默认使用构建上下文根目录的.dockerignore，此情况较少见）

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