本地运行Google Cloud Run的Docker化GeoDjango项目遇配置异常

问题根源 #

项目的settings.py启动逻辑要求必须满足以下任一条件：

• 本地存在.env配置文件
• 处于TRAMPOLINE_CI测试环境
• 配置了GOOGLE_CLOUD_PROJECT环境变量并能访问GCP Secret Manager

本地运行时以上条件均未满足，因此抛出Exception: No local .env or GOOGLE_CLOUD_PROJECT detected. No secrets were found.错误。

解决方案 #

方案1：创建本地.env配置文件（推荐本地开发用） #

1. 在项目根目录新建.env文件，填入必要的配置项，至少包含：

SECRET_KEY=your-django-secret-key
DATABASE_URL=sqlite:///db.sqlite3  # 本地用SQLite，或填写你本地的数据库链接
GS_BUCKET_NAME=your-bucket-name  # 不需要的话可设为None

2. 直接运行项目：执行python manage.py runserver，程序会自动读取本地.env启动服务。
3. Docker运行：构建镜像后，运行时挂载本地.env文件到容器内对应路径：

docker run -p 9090:8080 -e PORT=8080 -v $(pwd)/.env:/app/.env my_image_name

注意：/app是容器内项目的根目录，需和Dockerfile中WORKDIR指定的路径一致，若路径不同需对应修改挂载目标路径。

方案2：通过环境变量传入GOOGLE_CLOUD_PROJECT（需能访问GCP Secret Manager） #

若本地已配置GCP认证（比如执行过gcloud auth application-default login），可在运行时传入项目ID：

1. 直接运行：

export GOOGLE_CLOUD_PROJECT=your-gcp-project-id
python manage.py runserver

2. Docker运行：

docker run -p 9090:8080 -e PORT=8080 -e GOOGLE_CLOUD_PROJECT=your-gcp-project-id -v ~/.config/gcloud:/root/.config/gcloud my_image_name

挂载gcloud配置目录是为了让容器内程序获取本地GCP认证信息，从而读取Secret Manager中的配置。

方案3：临时修改settings.py（仅用于快速测试） #

若只是临时测试，可在settings.py的else分支前添加本地开发兜底配置：

elif os.getenv("LOCAL_DEV", None):
    # 本地开发临时兜底配置
    placeholder = (
        f"SECRET_KEY=local-dev-secret-key\n"
        "GS_BUCKET_NAME=None\n"
        f"DATABASE_URL=sqlite://{os.path.join(BASE_DIR, 'db.sqlite3')}"
    )
    env.read_env(io.StringIO(placeholder))

然后运行时传入LOCAL_DEV环境变量：

# 直接运行
export LOCAL_DEV=1
python manage.py runserver

# Docker运行
docker run -p 9090:8080 -e PORT=8080 -e LOCAL_DEV=1 my_image_name

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