GitLab CI使用Django与Postgres镜像测试时报SECRET_KEY为空如何解决

问题原因 #

• 参数顺序错误：docker run 命令中所有给docker的配置参数（比如--env-file、-e）必须放在镜像名称之前，你写在镜像名后的-e SECRET_KEY=1是作为参数传给启动命令的，没有实际注入环境变量的效果，同时额外添加的bash命令会干扰原有ENTRYPOINT的执行逻辑。
• 镜像内置了空值的.env文件：你在Dockerfile构建阶段执行了RUN bash /app/setup_env.sh，构建镜像时CI的敏感变量（比如SECRET_KEY）不会注入到构建环境中，这一步会生成一个内置的.env文件，其中SECRET_KEY等值为空。后续容器启动时，aws_start.sh又会再次执行setup_env.sh，会追加内容到原有.env文件，Django读取到先出现的空值SECRET_KEY就会报错。
• 可选问题：如果你的Django配置中没有使用python-dotenv等工具加载.env文件的逻辑，就算.env文件内容正确，Django也读不到对应的配置项。

解决方案 #

1. 修正docker run命令
   删掉镜像名后的错误参数，添加容器名和后台运行参数方便后续exec操作，参考命令如下：

docker run -d --name django --env-file .env registry.gitlab.com/domain/app/django:latest

如果需要临时覆盖SECRET_KEY，把-e参数放在镜像名之前：

docker run -d --name django --env-file .env -e SECRET_KEY=你的自定义密钥 registry.gitlab.com/domain/app/django:latest

2. 删除Dockerfile中冗余的构建逻辑
   删掉Dockerfile里的RUN bash /app/setup_env.sh这行，构建阶段不需要生成.env文件，所有环境变量统一在容器启动时注入即可。

3. 修正setup_env.sh的写入逻辑
   把setup_env.sh里所有的追加符>>改成覆盖符>，避免每次执行都追加内容导致旧的空值配置残留，示例修改如下：

# 第一行修改为覆盖写入
echo DEBUG=0 > .env
# 后续所有echo行同步修改为>即可

4. 可选配置：确认Django的环境变量加载逻辑
   在Django的settings.py开头加入dotenv加载代码，确保.env文件的配置能被正确读取：

from dotenv import load_dotenv
import os

load_dotenv()
SECRET_KEY = os.getenv('SECRET_KEY')

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