密钥严禁硬编码或提交至代码库，须用平台原生环境变量管理；连接时应分离认证凭据、禁用明文拼接URI；轮换需完整重启应用并验证健康度；强制TLS加密传输且禁用旧协议。
密钥绝不能硬编码在应用配置里
硬编码 MONGODB_URI 或把密钥写死在 .env 文件里，等于把保险柜钥匙贴在锁面上。PaaS 环境（如 Heroku、Vercel、阿里云函数计算）的构建日志、环境快照、CI/CD 缓存都可能意外泄露这些内容。
- 必须用平台原生的环境变量管理功能：Heroku 用
heroku config:set MONGODB_PASSWORD=xxx，Vercel 在 Settings → Environment Variables 页面添加，阿里云函数在「函数配置」→「环境变量」中设置 - 禁止在 Git 仓库中提交含密钥的
.env、config.js或secrets.yml；可在.gitignore中显式加入.env.local、secrets.* - Node.js 应用读取时只认
process.env.MONGODB_PASSWORD，不要从文件同步加载
连接字符串里别暴露明文密码
即使密钥存在环境变量中，拼接连接字符串时仍可能暴露风险。比如 `mongodb://user:${password}@host:27017/db` 这种写法，一旦 password 变量被误打日志（如 console.log(uri)），就全完了。
- 改用 MongoDB 官方驱动推荐的 URI 构造方式：用
MongoClient的auth选项分离凭据，例如：new MongoClient('mongodb://host:27017', { auth: { username: process.env.MONGODB_USER, password: process.env.MONGODB_PASSWORD }, useNewUrlParser: true, useUnifiedTopology: true }) - 避免使用
encodeURIComponent手动转义密码——某些特殊字符（如+、/）在 Base64 密钥中常见，手动处理极易出错且不可靠 - 如果必须用连接字符串，确保
password已经经过 URL 编码，并且整个字符串绝不进入任何日志、监控或错误堆栈（尤其注意catch块里的console.error(err)）
密钥轮换时要避免连接中断
PaaS 应用重启是瞬时的，但 MongoDB 驱动不会自动重连新凭据。直接改环境变量再重启，旧连接池仍持旧密钥，新连接用新密钥，中间可能出现认证失败或双密钥混用。
- 轮换前先在 MongoDB Atlas 或自建集群中启用新密钥并赋权，确认新凭据可独立登录
- 更新 PaaS 环境变量后，必须触发应用**完整重启**（不是热重载或配置重载），确保所有工作进程加载新变量
- Node.js 中检查
MongoClient实例是否复用：全局单例初始化一次，不要在每次请求时新建 client；否则新请求可能拿不到新环境变量值 - 上线后立刻验证连接健康度，比如执行
db.runCommand({ping: 1})，而不是等业务报错才发现
别忽略 TLS 和网络层加密的依赖关系
加密密钥安全 ≠ 数据传输安全。如果 MongoDB 连接没走 TLS（即连接字符串里没 ?ssl=true 或没配 tls: true），密钥本身再强，密码和数据也会以明文跑在公网或云内网中。
- 强制开启 TLS：Atlas 默认要求，自建集群需确认
net.tls.mode设为requireTLS，且客户端加tls: true和tlsCAFile（若用自签名证书） - PaaS 网络出口可能不支持 SNI 或拦截 TLS 握手（如某些企业代理环境），测试时用
mongo --tls --tlsCAFile ./ca.pem "mongodb+srv://..."验证底层连通性 - 禁用旧协议：MongoDB 4.4+ 应设
tlsMinVersion: "TLS-1.2"，避免降级到不安全的 TLS 1.0
