必须设ClientAuth: tls.RequireAndVerifyClientCert，否则看似双向实为单向；服务端需同时配置ClientAuth和ClientCAs，客户端须同时提供Certificates和RootCAs，私钥权限必须≤0600，且不可使用InsecureSkipVerify。
必须设 ClientAuth: tls.RequireAndVerifyClientCert，否则看似配了证书，实际仍是单向通信。
服务端配置：ClientAuth 和 ClientCAs 缺一不可
Go 的 tls.Config 默认不验证客户端证书，哪怕你传了 ClientCAs，只要 ClientAuth 没显式设对，连接就静默通过——你以为是 mTLS，其实是裸连。
-
ClientAuth必须为tls.RequireAndVerifyClientCert；tls.VerifyClientCertIfGiven或tls.RequireAnyClientCert都不可靠，前者允许无证书请求通过，后者不校验签名有效性 -
ClientCAs必须是已加载 PEM 内容的*x509.CertPool，不能是文件路径字符串，也不能是空池；可用x509.NewCertPool()+AppendCertsFromPEM()构建 - 服务端自己的证书仍走
Certificates字段（由tls.LoadX509KeyPair()加载），别和ClientCAs混在一起 - 私钥文件权限必须 ≤
0600，否则crypto/tls会静默拒绝加载，日志里看不到错误
客户端配置：Certificates + RootCAs 分工明确
客户端不是“带上 crt/key 就能双向”，它要同时做两件事：向服务端出示身份（用 Certificates），并验证服务端是否可信（用 RootCAs）。填反或漏填，连接直接失败。
-
Certificates是tls.Certificate类型，由tls.LoadX509KeyPair("client.crt", "client.key")加载；私钥同样需chmod 0600 client.key -
RootCAs必须加载服务端所用 CA 的根证书（如内网私有 CA 的ca.crt），不是客户端自己的证书，也不是中间证书 - 若服务端证书 SAN 不含访问目标（比如用
https://localhost访问但证书没写DNS:localhost），客户端需手动设置ServerName字段，否则报x509: certificate is valid for xxx, not yyy - HTTP 客户端要用自定义
http.Transport注入tls.Config；gRPC 客户端要用grpc.WithTransportCredentials(credentials.NewTLS(cfg))
常见 panic 和 handshake failed 的真实原因
很多 “启动就 panic” 或 “连接失败” 表面是证书问题，实则是配置逻辑错位。下面这些错误现象对应明确的修复点：
-
tls: failed to find any PEM data in certificate input→key.pem含密码（有DEK-Info头），必须用openssl rsa -in key.pem.enc -out key.pem解密 -
x509: certificate signed by unknown authority→ 客户端RootCAs没加载服务端 CA，或服务端cert.pem漏了中间证书链（应等价于 Let’s Encrypt 的fullchain.pem） -
remote error: tls: bad certificate→ 服务端ClientCAs加载的是错的 CA，或客户端证书不是该 CA 签发 - 服务端日志无报错、客户端卡住或返回 400 → 很可能是
ClientAuth没设对，降级成单向后因协议不匹配被拒绝
安全加固：别跳过 MinVersion 和 CipherSuites
只配证书不等于安全。TLS 1.0/1.1 已被禁用，弱密码套件可被降级攻击利用。生产环境必须显式收紧：
-
MinVersion: tls.VersionTLS12（MaxVersion可设为tls.VersionTLS13，但注意旧客户端兼容性） -
PreferServerCipherSuites: true防止客户端控制加密套件选择 -
CipherSuites推荐只留 AEAD 类：如tls.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384、tls.TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305等 -
InsecureSkipVerify: true是调试开关，CI/CD 流水线应扫描拦截该字段，正式环境绝不能存在
真正难的不是生成证书，而是让服务端强制验、客户端主动交、双方都按同一套 CA 和策略走通链路。任何一环用默认值、抄错字段名、或把证书塞错位置，mTLS 就形同虚设。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
