Django本地运行报Invalid HTTP_HOST header错，配置ALLOWED_HOSTS仍不生效

核心问题诱因 #

• 配置格式不符合Django校验规则：ALLOWED_HOSTS的匹配逻辑不支持携带端口号。Django接收到HTTP_HOST请求头后，会自动拆分出纯主机名做匹配，端口部分不属于校验范围。你配置里写的'127.0.0.1:8000'属于无效条目，完全无法通过校验。
• 环境变量覆盖导致默认值失效：env.list是环境变量加载库的标准写法，只要运行Django进程的系统环境变量中已经存在ALLOWED_HOSTS键值，代码里写的default默认参数会被直接跳过，根本不会被加载。很多人误以为写了默认值就一定会生效，忽略了环境变量的优先级高于代码内的默认配置。

对应修复步骤 #

• 修正ALLOWED_HOSTS的条目格式：删掉所有条目中的端口部分，纯主机名才是有效配置。比如把'127.0.0.1:8000'改成'127.0.0.1'，把'localhost:8000'改成'localhost'即可。
• 验证实际加载的配置值：在settings.py的ALLOWED_HOSTS配置行后面加一行临时打印代码：
  print("当前生效的ALLOWED_HOSTS：", ALLOWED_HOSTS)
  启动服务时看控制台输出的实际内容，如果列表里没有本地调试需要的主机名，说明环境变量的值已经覆盖了代码里的默认配置，这时候要么修改对应环境变量的取值，要么临时清除环境变量里的ALLOWED_HOSTS配置，让代码里的默认值正常加载。
• 本地调试的推荐配置：纯本地开发场景下，把默认值配置为ALLOWED_HOSTS = env.list("ALLOWED_HOSTS", default=["127.0.0.1", "localhost"])即可，不需要特意写通配符*（注意通配符配置有安全风险，不要直接用到生产环境）。

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