根证书(CA)是TLS握手时双方验证证书链完整性的共同信任锚点,必须由客户端和服务端显式加载同一份PEM格式文件;mongo shell需--tlsCAFile传入,Node.js需tls.ca传Buffer,Java需转JKS,Ops Manager Agent需UI上传或手动部署,路径、权限、编码、内容一致性均影响验证成败。

根证书(CA)必须由客户端和服务端共同信任
根证书不是“分发一次就完事”的静态文件,而是 TLS 握手时双方验证链完整性的锚点。mongod/mongos 用 --tlsCAFile 或 net.tls.CAFile 加载它来校验客户端证书;客户端驱动(如 Node.js、Java、mongo shell)也必须显式提供同一份 CA 文件,否则会报 unable to verify the first certificate 或连接被拒绝。
不同客户端对 CA 文件的加载方式差异大
同一份 ca.pem 在不同场景下不能简单拷贝了事,路径、格式、加载时机都影响成败:
- mongo shell:必须用
--tlsCAFile /path/to/ca.pem显式传入,不识别环境变量或默认路径 - Node.js 驱动:需在
tls.ca选项中传入Buffer或 PEM 字符串,fs.readFileSync('ca.pem')是常见写法;若用连接字符串参数tlsCAFile=,必须encodeURIComponent()编码路径,否则空格或特殊字符导致解析失败 - Java 驱动:不直接接受 PEM,需先转成 JKS 或 PKCS#12(如用
keytool -importcert导入ca.crt),且 JVM 启动时可能还需指定-Djavax.net.ssl.trustStore= - Ops Manager Agent:若托管代理,CA 文件需通过 UI 或 Atlas CLI 上传至项目级配置;若自管代理,则必须手动部署到每个 agent 主机的本地路径,并在 agent 配置中指向该路径
常见错误:CA 文件内容不一致或被意外修改
看似相同的 ca.pem,实际可能因以下原因失效:
- 文本编辑器保存时添加了 BOM 或换行符(尤其 Windows 编辑器),导致 OpenSSL 验证失败或驱动解析出错
- 误将
ca.crt和ca.key拼接成ca.pem(正确做法仅含证书,不含私钥) - 多个环境(dev/staging/prod)共用一个 CA 目录但未隔离,更新 CA 后部分服务仍读取旧缓存文件
- 容器化部署中,CA 文件挂载为只读卷但路径权限错误(如
0640),非 root 用户进程无法读取
生产环境中 CA 分发必须可审计、可回滚
手动 scp 或 rsync 复制 ca.pem 到几十台 mongod 节点或客户端机器,极易遗漏或版本错乱。更可靠的做法是:
- 把 CA 文件纳入配置管理(Ansible playbook 中用
copy模块 +checksum校验) - 使用服务发现工具(如 Consul Template)动态注入 CA 内容到容器环境变量或临时文件
- 对关键集群,把 CA 文件哈希值写入 MongoDB 的
admin.system.version或独立 collection,供客户端启动时比对
最易被忽略的一点:CA 文件本身没有有效期检查机制,但一旦过期,所有基于它的证书都会验证失败——而错误日志里往往只显示“certificate verify failed”,不会明确指出是根证书过期。务必定期用 openssl x509 -in ca.pem -noout -dates 扫描所有环境中的 CA 文件。











