Django项目迁移至Docker Compose后模板debug变量未生效问题咨询

问题根因排查 #

最核心原因：django.template.context_processors.debug 注入debug变量有前置条件 #

该上下文处理器并不是只要添加到配置列表就一定会注入debug变量，必须同时满足两个条件：

• 全局DEBUG = True
• 当前请求的客户端IP在settings.INTERNAL_IPS配置项中

Docker Compose环境下，请求Django服务的客户端IP属于Docker网桥分配的内部网段（通常为172.17.0.0/16、172.18.0.0/16这类），默认没有加入INTERNAL_IPS，因此触发不了debug变量的注入逻辑；Vagrant环境因为端口映射后请求IP是本地127.0.0.1，默认在INTERNAL_IPS中，所以表现正常。

解决方案 #

1. 先确认Docker环境下请求的客户端IP，在任意视图中添加打印逻辑：

print(request.META.get('REMOTE_ADDR'))

2. 将得到的IP或者对应网段添加到settings.INTERNAL_IPS中，示例配置：

INTERNAL_IPS = [
    "127.0.0.1",
    "172.17.0.0/16",
    "172.18.0.0/16"
]
# 调试阶段也可以临时写成通配形式，生产环境禁止这么配置
# INTERNAL_IPS = ["*"]

其他可排查点 #

• 确认Docker环境是否开启了模板缓存：如果TEMPLATES.OPTIONS.loaders配置了cached.Loader，清空模板缓存后重启服务再验证
• 确认不存在多配置覆盖：检查是否有生产环境配置项覆盖了context_processors列表，移除了debug上下文处理器

关于Pycharm的疑问 #

该问题和Pycharm无关，不需要提交官方工单，按上述步骤排查即可解决。

内容的提问来源于stack exchange，提问作者Antonio Gamiz Delgado