.NET Core 2.1为GET请求添加证书时触发manifestmodule自引用循环错误

• 你看到的Self Referencing loop报错并非业务代码直接抛出的原生错误，是异常对象被日志组件、调试工具内置的JSON序列化逻辑处理时触发的次生错误：当底层证书操作触发原生异常后，日志框架默认会序列化整个Exception对象输出，而Exception的TargetSite.Module.Assembly属性存在循环引用结构，JSON序列化器未开启循环引用处理时就会抛出该错误，原生的证书操作异常被该次生错误覆盖，因此你会在无显式JSON操作的场景下看到这类报错。
• 触发原生异常的核心原因和.NET Core 2.1版本特性、证书本身状态有关，常见场景包括：
  • 证书文件损坏、路径无效、密码错误导致X509Certificate2初始化失败
  • 证书无对应私钥，或当前程序运行用户没有私钥的读取权限
  • .NET Core 2.1 对HttpWebRequest.ClientCertificates的兼容实现存在已知缺陷，跨平台场景下证书挂载容易触发内部未处理异常

• 第一步：先获取原生异常信息，排除次生错误干扰
  将证书相关代码包裹try-catch，直接输出异常的基础属性，避免日志框架序列化整个Exception对象，示例代码：

try
{
    X509Certificate2 certificate= new X509Certificate2(path,password);
    request.ClientCertificates.Add(certificate);
}
catch (Exception ex)
{
    // 直接输出原生异常核心信息，不要序列化整个异常对象
    Console.WriteLine($"原生错误信息：{ex.Message}");
    Console.WriteLine($"错误堆栈：{ex.StackTrace}");
}

• 第二步：根据原生异常信息针对性处理，常见场景解决方案如下：
  • 若为证书加载失败：验证证书路径是否正确、密码是否匹配、证书文件完整性，可先通过本地证书管理器导入pfx文件验证证书有效性
  • 若为权限问题：Windows环境下给程序运行用户分配证书私钥的读取权限，Linux环境下调整证书文件的访问权限为当前运行用户可读
  • 若为HttpWebRequest版本缺陷：建议替换为.NET Core更推荐的HttpClient实现证书挂载，示例代码：

var handler = new HttpClientHandler();
handler.ClientCertificates.Add(new X509Certificate2(path, password));
var client = new HttpClient(handler);
client.Timeout = TimeSpan.FromMilliseconds(300000);
var response = await client.GetAsync(url);

• 若必须使用HttpWebRequest：可在初始化证书时添加存储标识参数，指定证书加载到公共存储区规避权限问题，示例代码：

X509Certificate2 certificate = new X509Certificate2(path, password, 
    X509KeyStorageFlags.MachineKeySet | X509KeyStorageFlags.PersistKeySet | X509KeyStorageFlags.Exportable);

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