Kubernetes更新Secrets后服务未加载新环境变量问题排查

可能的原因 #

1. Django配置未正确读取环境变量 #

你的代码大概率存在硬编码DEBUG=True，或者配置读取逻辑优先加载了本地配置文件（比如local_settings.py、.env），完全没用到系统环境变量。常见错误写法：

DEBUG = True  # 硬编码值直接覆盖环境变量
# 或者
DEBUG = os.getenv('DEBUG', True)  # 默认值设为True，环境变量未被正确解析时会用默认值

2. 容器进程未完全重启 #

虽然执行了滚动发布，但如果Gunicorn等WSGI服务器的启动脚本存在缓存机制，或者镜像里的启动逻辑有问题，可能导致旧配置依然生效——说白了就是进程没真正重启，还在复用之前的配置。

3. Django环境变量解析逻辑错误 #

环境变量的取值是字符串类型，如果你在配置里直接把os.getenv('DEBUG')赋值给DEBUG，当环境变量是"False"时，Python会把非空字符串解析为True，这就会出现容器环境变量显示False但Django实际DEBUG=True的情况。

解决步骤 #

第一步：修正Django配置代码 #

打开settings.py，确保DEBUG的读取逻辑正确处理字符串转布尔值：

import os
# 严谨的写法，兼容大小写和字符串格式
DEBUG = bool(os.getenv('DEBUG', 'False').strip().lower() == 'true')

彻底移除硬编码的DEBUG=True，不要给默认值留后门。

第二步：检查容器内的本地配置文件 #

确认容器里没有能覆盖主配置的本地文件，执行以下命令排查：

kubectl exec -it my-container -- ls -la /path/to/your/django/project
# 如果存在local_settings.py，查看内容
kubectl exec -it my-container -- cat /path/to/your/django/project/local_settings.py

如果有这类文件，要么直接删除，要么修改其DEBUG配置为读取环境变量。

第三步：强制重启Deployment #

有时候用latest镜像标签会导致Kubernetes判断不需要更新Pod，执行强制滚动更新：

kubectl rollout restart deployment backend-app

然后验证新Pod是否完全替换旧Pod：

kubectl get pods -l app=backend

第四步：直接验证Django的实际配置 #

不要只看环境变量，直接在容器内打印Django的DEBUG值：

kubectl exec -it my-container -- python manage.py shell -c "from django.conf import settings; print(settings.DEBUG)"

这能直接确认Django是否真的读取到了环境变量。

第五步：调整envFrom加载顺序（可选） #

如果发现ConfigMap和Secret的变量存在覆盖冲突，记住后加载的配置会覆盖前面的。比如想让Secret的配置优先生效，就调整顺序：

envFrom:
- configMapRef:
    name: backend-config
- secretRef:
    name: backend-secret

不过根据你的情况，容器环境变量已经显示DEBUG=False，这一步大概率不需要。

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