x.509不能直接替代keyfile，因二者用途不同：keyfile专用于节点间内部认证，x.509是tls层身份凭证；mongodb 5.0需通过tlsx509clusterauthdnoverride与clusterauthmode: x509严格对齐才能实现去keyfile化，否则启动报错或卡在startup2状态。
x.509 证书不能直接“替代” keyfile，因为二者用途完全不同：
keyfile 仅用于副本集/分片集群成员间的内部身份验证（即节点互信），而 x.509 是面向客户端或集群成员的 TLS 层身份凭证，需配合完整 PKI 体系使用。
MongoDB 5.0 不支持用 x.509 完全取代 keyfile 的功能，但可通过配置迁移实现“去 keyfile 化”的成员认证 —— 前提是所有节点启用 tlsX509ClusterAuthDNOverride 并统一约束 subject。
为什么不能直接删掉 keyfile？
副本集启动时若未提供 --keyFile 或 security.keyFile，且未启用基于证书的集群认证，则会拒绝加入集群，报错：Failed to load keyfile: No such file or directory 或更隐蔽的 not authorized on admin to execute command { replSetInitiate }。这是因为 5.0 默认仍依赖 keyfile 做初始握手，除非显式切换认证机制。
启用 tlsX509ClusterAuthDNOverride 启动集群
该参数告诉 mongod：“我允许用客户端证书 subject 的特定 DN 字段（O/OU/DC）来识别集群成员，而非 keyfile”。它必须在所有节点上一致配置，且只在 --tlsMode requireTLS 下生效。
- 确保所有节点的证书 subject 中
O（Organization）、OU（OrganizationalUnit）、DC（DomainComponent）三者组合完全相同，例如：O=MyOrg,OU=DB,DC=cluster - 启动时必须同时指定：
--tlsMode requireTLS --tlsCertificateKeyFile /path/to/node.pem --tlsCAFile /path/to/ca.pem --tlsX509ClusterAuthDNOverride "O=MyOrg,OU=DB,DC=cluster" - 配置文件写法：
net:<br> tls:<br> mode: requireTLS<br> certificateKeyFile: /path/to/node.pem<br> CAFile: /path/to/ca.pem<br>security:<br> clusterAuthMode: x509<br> tlsX509ClusterAuthDNOverride: "O=MyOrg,OU=DB,DC=cluster"
-
clusterAuthMode必须设为x509（不能是keyFile或sendKeyFile），否则tlsX509ClusterAuthDNOverride不生效
客户端证书 subject 不能和集群成员冲突
这是最容易踩的坑：如果你把客户端证书也签成 O=MyOrg,OU=DB,DC=cluster，mongod 会把它当成集群成员接受连接，并在日志里打警告：WARNING: x.509 client certificate matches cluster auth DN override，同时授予 full privileges —— 这属于权限越界。
- 客户端证书 subject 必须与
tlsX509ClusterAuthDNOverride的值**完全不同**（哪怕只差一个空格） - 推荐为客户端单独划出命名空间，例如：
O=MyOrg,OU=AppClient,CN=app-01 - 添加用户时，subject 字符串需严格按 RFC2253 格式传入：
db.getSiblingDB("$external").createUser({user: "O=MyOrg,OU=AppClient,CN=app-01", roles: [...]}) - 注意：MongoDB 5.0+ 对 subject 长度敏感，超过 10KB 会导致因果一致性会话失败，但不会报错，只会静默降级
5.0 中 keyfile 和 x.509 共存是否可行？
可以，但不推荐。MongoDB 5.0 支持 clusterAuthMode: preferX509，表示优先尝试 x.509 认证，失败则回落到 keyfile —— 这常用于灰度迁移。但要注意：
- 一旦任一节点启用了
tlsX509ClusterAuthDNOverride，整个副本集就必须全部启用，否则其他节点无法识别其身份 -
preferX509模式下，keyfile仍需存在且可读，否则节点启动失败 - 5.0 已删除
rs.addArbiter()等旧命令，添加新节点时若用 mongosh，必须显式传入{host: "...", priority: 0}，否则可能因认证方式不匹配被拒绝
keyfile 的关键不在证书本身，而在所有节点对 clusterAuthMode 和 tlsX509ClusterAuthDNOverride 的严格对齐；任何节点漏配、subject 写错、CA 文件路径不一致，都会导致集群卡在 STARTUP2 状态，且错误日志里往往只显示模糊的 TLS handshake failure。
