硬编码密码极不安全,应使用环境变量配合os.getenv()校验;本地用python-dotenv加载.gitignore保护的.env文件,生产环境由系统或密钥管理器注入;Docker和CI/CD需避免明文传递,改用运行时注入或secrets机制。

为什么不能把密码写死在Python脚本里
硬编码密码(比如 PASSWORD = "123456")是高危操作:代码一旦提交到 Git、分享给同事、或被反编译,密码就彻底暴露。哪怕加了注释“请勿提交”,也拦不住误提交、IDE 自动上传、或 CI/CD 流水线缓存残留。环境变量本身不进代码仓库,且可按环境(dev/staging/prod)差异化配置,是事实标准的轻量级密钥隔离手段。
用 os.getenv() 读取环境变量并做必要校验
直接调用 os.getenv("DB_PASSWORD") 很常见,但容易忽略两点:变量不存在时返回 None,以及空字符串也被当作有效值。这会导致连接失败却报错模糊(比如数据库报“认证失败”而非“密码未提供”)。
os.getenv() 读取环境变量并做必要校验
直接调用 os.getenv("DB_PASSWORD") 很常见,但容易忽略两点:变量不存在时返回 None,以及空字符串也被当作有效值。这会导致连接失败却报错模糊(比如数据库报“认证失败”而非“密码未提供”)。
建议始终搭配默认值和显式检查:
import os
password = os.getenv("DB_PASSWORD")
if not password:
raise ValueError("环境变量 DB_PASSWORD 未设置或为空")
不推荐用 os.environ["DB_PASSWORD"] —— 它在变量缺失时抛 KeyError,不如主动判断清晰可控。
本地开发时如何安全注入环境变量
.env 文件方便,但 Python 默认不加载它。必须用第三方库(如 python-dotenv)显式加载,且要确保该文件**不在版本控制中**:
-
.gitignore 里必须包含 .env
- 安装后,在脚本开头加
from dotenv import load_dotenv; load_dotenv()
- 不要在生产环境(如服务器、Docker)也依赖
.env —— 生产应由运维通过系统级环境变量或 secrets 管理器注入
Docker 和 GitHub Actions 中的环境变量传递陷阱
Dockerfile 里用 ENV 指令设密码?危险——镜像层会固化该值,任何人拉取镜像都能 docker history 看到。正确做法是运行时传入:
.gitignore 里必须包含 .env
from dotenv import load_dotenv; load_dotenv()
.env —— 生产应由运维通过系统级环境变量或 secrets 管理器注入ENV 指令设密码?危险——镜像层会固化该值,任何人拉取镜像都能 docker history 看到。正确做法是运行时传入:
启动容器时用:
将测试、lint、构建和文档流程编码为命名的Python会话,以便人类和代理每次运行相同的workflow。
docker run -e DB_PASSWORD="$DB_PASSWORD" myapp
GitHub Actions 中,别把密码写在 env: 下明文字段里。必须用 secrets: 并显式映射:
env:
DB_PASSWORD: ${{ secrets.DB_PASSWORD }}
注意:secrets 只能在 job 级别注入,不能用于 workflow 名称、if 条件表达式等元信息位置,否则会静默为空。
环境变量不是银弹——它解决的是“密码不进代码”,但没解决“谁有权限改环境变量”“变量是否被进程列表泄露”等问题。真正在意安全的场景,得上 Vault 或 AWS Secrets Manager,不过对多数自动化脚本来说,规范使用 os.getenv() + 严格管控注入路径,已经拦住了 90% 的低级泄漏风险。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










