settings.py无法服务端读取Django-Environ配置问题求助

核心问题分析 #

从现象来看，部分环境变量（如DB_USER、DB_NAME）能正常读取，但DEBUG和DB_PASS出现异常：DEBUG=0未生效、Postgres密码认证失败。硬编码配置可正常运行，说明问题集中在django-environ的环境文件加载逻辑或变量类型解析上。

排查修复步骤 #

1. 修正环境文件路径 #

当前env.read_env的路径写法存在多余斜杠，服务器文件系统对路径分隔符更敏感，可能导致文件加载失败：

# 原代码
env.read_env(os.path.join(BASE_DIR, '.djenv/', '.host'))
# 修正后
env.read_env(os.path.join(BASE_DIR, '.djenv', '.host'))

os.path.join会自动处理路径分隔符，无需手动添加尾部斜杠。

2. 显式指定变量类型 #

django-environ默认将DEBUG=0解析为字符串"0"，但Django的DEBUG需要布尔值，类型不匹配会导致配置失效。显式指定变量类型：

# 修正DEBUG变量解析
DEBUG = env.bool("DEBUG", default=False)
# 数据库端口建议指定为整数
'PORT': env.int('DB_PORT', default=5432),

3. 验证环境文件加载状态 #

在settings.py中添加临时调试代码（部署前务必移除），确认环境文件是否被正确读取：

import environ
import os
from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

env = environ.Env()
env_path = os.path.join(BASE_DIR, '.djenv', '.host')
# 打印路径与文件存在状态
print(f"环境文件路径: {env_path}")
print(f"文件是否存在: {os.path.exists(env_path)}")
# 加载后打印关键变量
env.read_env(env_path)
print(f"DEBUG值: {env('DEBUG')}, 类型: {type(env('DEBUG'))}")
print(f"数据库密码: {env('DB_PASS')}")

执行python manage.py check查看输出，确认路径正确、变量值符合预期。

4. 检查服务器文件权限 #

确保运行Gunicorn的用户拥有.djenv/.host文件的读取权限：

# 调整文件权限示例
chmod 640 /path/to/your/project/.djenv/.host
chown web_user:web_group /path/to/your/project/.djenv/.host

权限过高或过低都会导致无法读取环境文件。

5. 排查系统环境变量冲突 #

服务器上的同名系统环境变量会覆盖.env文件中的值，执行以下命令检查：

echo $DEBUG
echo $DB_PASS

若输出与.env文件内容不符，需修改系统环境变量或调整django-environ的加载优先级。

额外提示 #

硬编码配置可正常运行，说明Django与Postgres的核心配置逻辑无问题，无需怀疑数据库连接本身。部署完成后记得移除调试代码，避免敏感信息泄露。

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