必须将 load_dotenv() 放在 manage.py 或 app.py 入口顶部，用显式路径加载 .env，并用 os.environ['db_password'] 强制报错，配合 .gitignore、chmod 600 和 ci secrets 实现三重防护。
直接把 DB_PASSWORD 写进代码或配置文件里，等于把数据库大门钥匙钉在门口——只要代码被看到、仓库被 clone、CI 日志被泄露，就全完了。必须用 .env 隔离，但光放进去还不够，加载方式、路径、fallback 逻辑稍有偏差，就会在生产环境静默失效。
load_dotenv() 必须在 Django/Flask 初始化前调用
很多人把 load_dotenv() 放在 settings.py 底部，或者塞进某个 views 文件里——这会导致 Django 启动时 os.environ 还没被填充，SECRET_KEY 或 DB_PASSWORD 取不到值，但框架可能用默认 fallback（比如空字符串）继续启动，结果是连接拒绝却无报错。
- 正确位置：在
manage.py最顶部（Django）或app.py入口处（Flask），确保所有配置读取前环境变量已就位 - 加显式路径更稳：
load_dotenv(Path(__file__).parent / ".env")，避免多层目录下找不到.env - 别依赖自动搜索：
load_dotenv()默认只找当前工作目录下的.env，而部署时工作目录可能是/var/www，不是项目根目录
os.getenv() 和 os.environ[] 的行为差异很关键
os.getenv('DB_PASSWORD') 返回 None；os.environ['DB_PASSWORD'] 直接抛 KeyError。后者才是你想要的——尤其在生产环境。
- 开发阶段可用
os.getenv('DB_PASSWORD', 'dev-password')，但必须加注释说明仅限本地 - 生产环境必须用
os.environ['DB_PASSWORD']，强制缺失时报错退出，不给“带病运行”的机会 - 别混用：如果用了
getenv且没设 default，它返回None，而某些 ORM（如 SQLAlchemy）会把None当作字面字符串传给连接池，导致认证失败但错误信息是“Access denied for user 'root'@'%'”，根本看不出是密码为空
.env 文件本身不是保险柜，得配合三道防线
.env 文件只是个普通文本，内容明文存储，它唯一的作用是把密钥从代码里挪出来，并靠 .gitignore 防误提交。但它自己没有任何加密或访问控制。
- 必须加入
.gitignore：确认文件里有.env这一行，且没被其他规则覆盖（比如写了**/.env却又被!config/.env反向排除） - 禁止在 CI/CD 中 commit 或上传
.env：GitHub Actions、GitLab CI 等应通过 secrets 注入变量，而不是把.env丢进 runner - 权限要收紧：Linux 下运行
chmod 600 .env，防止同服务器其他用户读取；Docker 中不要用COPY .env .，改用--secret或环境变量注入
Django settings.py 里数据库配置的典型坑
很多模板里写 DATABASES = {'default': {... 'PASSWORD': os.getenv('DB_PASSWORD') ...}}，看着没问题，但实际容易出问题。
-
os.getenv()返回的是字符串，但某些数据库驱动（如 psycopg2）对空字符串敏感，会尝试用空密码连接，而非跳过认证字段 - 推荐写法：
'PASSWORD': os.environ.get('DB_PASSWORD', '') or None，让 ORM 明确知道该字段不存在时跳过传参 - 更稳妥的做法是拆开构造连接串：
os.environ['DB_URL']（用postgresql://user:pass@host/db格式），由dj-database-url解析，它会自动处理空字段和编码问题 - 别在
.env里写注释行含等号：# DB_PASSWORD=xxx会被python-dotenv当成键名# DB_PASSWORD，值为空，导致取不到真实值
真正麻烦的不是怎么写 .env，而是当它在某台服务器上莫名失效时——可能是因为 systemd 服务没继承用户环境、容器挂载路径错了、甚至 shell 启动脚本里执行了 unset DB_PASSWORD。每次排查都要先验证 print(os.environ.get('DB_PASSWORD')) 是否真被加载，而不是直接猜 ORM 配置。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
