C#使用SSL证书调用第三方SOAP WebService及报错解决

核心错误修复 #

你遇到的PlatformNotSupportedException是因为在.NET Core/.NET 5+等跨平台环境下，X509Certificate2的无参构造+Import方法已被弃用，必须使用直接传入证书路径和密码的构造函数替代。

替换原证书加载代码：

// 原错误代码
X509Certificate2 cert = new X509Certificate2();
cert.Import("PATH_TO_CERT", "password", X509KeyStorageFlags.DefaultKeySet);

// 修复后的代码
var cert = new X509Certificate2("PATH_TO_CONVERTED_CERT", "password", X509KeyStorageFlags.DefaultKeySet);

不同证书格式处理方案 #

你持有.crt、.jks、.pem格式证书，需要先转换成C#兼容的格式（优先PFX/P12，或直接加载PEM）：

1. .crt格式（公钥证书） #

.crt仅包含公钥，需搭配对应的私钥文件（如.key），用OpenSSL转换成PFX：

openssl pkcs12 -export -in your_cert.crt -inkey your_private.key -out converted_cert.pfx

执行时设置PFX文件的密码，后续代码中使用该密码加载证书。

2. .jks格式（Java密钥库） #

用Java的keytool工具将JKS转换为PFX：

keytool -importkeystore -srckeystore your_keystore.jks -destkeystore converted_cert.pfx -srcstoretype JKS -deststoretype PKCS12

输入JKS的源密码和PFX的目标密码即可。

3. .pem格式 #

如果是包含私钥和证书的PEM文件，.NET Core 3.0+支持直接加载：

// 未加密的PEM
var cert = X509Certificate2.CreateFromPemFile("cert.pem", "private_key.pem");

// 加密的PEM（带密码）
var cert = X509Certificate2.CreateFromEncryptedPemFile("cert.pem", "private_key.pem", "pem_password");

完整调用代码示例 #

整合证书加载和HTTP头设置的完整代码：

SOAPServiceClient client = new SOAPServiceClient();

// 设置HTTP请求头
using (new OperationContextScope(client.InnerChannel))
{
    HttpRequestMessageProperty requestMessage = new HttpRequestMessageProperty();
    requestMessage.Headers["TrustedUser"] = "abc";
    requestMessage.Headers["Account"] = "def";
    OperationContext.Current.OutgoingMessageProperties[HttpRequestMessageProperty.Name] = requestMessage;
}

// 加载证书（以PFX为例）
var cert = new X509Certificate2("converted_cert.pfx", "your_password", X509KeyStorageFlags.DefaultKeySet);
client.ClientCredentials.ClientCertificate.Certificate = cert;

// 调用接口
var result = await client.FetchDetailsAsync(filterType.CUSTOMER, "1234");

额外注意事项 #

• 确保证书文件路径正确，且应用程序有读取权限；
• 若在Linux/macOS环境，X509KeyStorageFlags可使用X509KeyStorageFlags.MachineKeySet | X509KeyStorageFlags.PersistKeySet避免权限问题；
• 验证证书链完整性，避免因证书信任问题导致调用失败。

内容的提问来源于stack exchange，提问作者VSRD