使用X509Certificate2读PFX必须显式传密码（无密码时传""），优先调用GetRSAPrivateKey()而非PrivateKey，检查HasPrivateKey和KeyUsage/ExtendedKeyUsage，并注意跨平台密码编码差异及多证书链问题。
用 X509Certificate2 读 PFX 文件，必须提供密码
不给密码会直接抛 CryptographicException，错误信息通常是“无法解密 PKCS#8 私钥”或“找不到有效证书”。PFX 是加密容器，即使你确认文件没设密码，也得显式传空字符串 ""，不能传 null —— 否则在 .NET Core / .NET 5+ 上会直接报错，而旧版 .NET Framework 可能静默失败或行为不一致。
实操建议：
- 始终把密码作为参数传入构造函数：
new X509Certificate2("cert.pfx", "myPass123") - 若 PFX 无密码，用
new X509Certificate2("cert.pfx", "")，别省略第二个参数 - 避免从配置文件硬编码密码；生产环境优先用
SecureString（注意：.NET 6+ 中X509Certificate2构造函数已不支持SecureString，只能退回到明文string） - 读取后检查
HasPrivateKey属性，确认私钥是否成功加载 —— 有些导出时勾选了“不导出私钥”，文件虽是 .pfx 后缀，但实际不含私钥
GetRSAPrivateKey() 和 PrivateKey 别混用
PrivateKey 是老接口，返回 AsymmetricAlgorithm 抽象基类，在 .NET Core 之后已被标记为过时（obsolete），且在某些运行时（如 Linux 上的 OpenSSL 后端）可能返回 null 或抛异常。真正该用的是 GetRSAPrivateKey()（或 GetECDsaPrivateKey()），它们返回具体实现类型，能安全调用签名/解密方法。
实操建议：
- 优先用
cert.GetRSAPrivateKey()获取 RSA 私钥；如果是 ECC 证书，用cert.GetECDsaPrivateKey() - 不要依赖
cert.PrivateKey as RSACryptoServiceProvider—— 在非 Windows 平台大概率为空 - 调用前加判空：
if (rsa != null) { rsa.SignData(...); }，因为即使 PFX 加载成功，私钥也可能因策略被禁用（比如证书标记为“仅用于密钥交换”）
公钥提取别只看 PublicKey.Key，要分清用途
证书里的公钥本身不带用途约束，但实际使用时（比如 JWT 验签、TLS 握手），验证方会检查证书扩展字段 Key Usage 和 Extended Key Usage。如果证书只允许“数字签名”，你却拿它去加密数据，运行时不会报错，但对方验证会失败。
实操建议：
- 获取公钥对象用
cert.GetRSAPublicKey()（推荐）或cert.PublicKey.Key（兼容旧代码） - 检查关键用途：
cert.HasPrivateKey（私钥是否存在）、cert.GetKeyUsage()（返回位标志）、cert.Extensions["2.5.29.37"]（EKU OID 列表） - 常见 EKU 错误：用客户端认证证书（OID
1.3.6.1.5.5.7.3.2）去做服务器 TLS 签名（需要1.3.6.1.5.5.7.3.1），握手会失败但错误日志里往往只显示“证书不受信任”
跨平台读 PFX 的坑：Windows 和 Linux 对密码处理不一致
同一份 PFX 文件，在 Windows 上用密码 "abc" 能成功加载，放到 Linux 容器里却报“密码错误”，大概率是 PFX 导出时用了 Unicode 密码但未指定编码，而 OpenSSL（.NET 的 Linux 后端）默认按 UTF-8 解码，Windows CryptoAPI 却按 UTF-16 处理。
实操建议：
- 导出 PFX 时，用 PowerShell 的
Export-PfxCertificate -Password (ConvertTo-SecureString "abc" -AsPlainText -Force)，它默认走 Unicode；或者用openssl pkcs12命令时加-CSP "Microsoft Enhanced Cryptographic Provider v1.0"（仅限 Windows） - 开发阶段就在 Linux 容器里测试读取逻辑，别等上线才发现密码不匹配
- 如果必须兼容旧 PFX，可尝试用
Encoding.UTF8.GetBytes(password)手动构造字节数组再喂给底层 API（需反射调用内部方法，不推荐）—— 更稳妥的做法是重新导出一份明确指定 UTF-8 密码的 PFX
最常被忽略的一点：PFX 文件本身可能包含多个证书（比如带中间 CA），X509Certificate2 默认只加载第一个。如果业务依赖链中某个中间证书，得手动用 X509Certificate2Collection 解析并构建完整链。
