本地NopCommerce向自研REST API发请求遇SSL错误的解决方法

可行解决步骤 #

• 信任本地API的SSL证书
  本地开发的API默认使用自签名SSL证书，NopCommerce基于的.NET运行环境不会默认信任这类证书。你可以这么做：

  1. 用浏览器打开https://localhost:7521，点击地址栏的锁图标，查看并导出证书为CER格式；
  2. 双击导出的CER文件，选择“本地计算机”作为存储位置，后续步骤中选择“受信任的根证书颁发机构”完成导入；
  3. 如果自研API是基于.NET开发的，直接执行命令：dotnet dev-certs https --trust，一键信任本地开发证书。

• 临时跳过SSL验证（仅本地测试用）
  要是只是临时测试不想折腾证书，可在NopCommerce的请求客户端里禁用SSL校验。以HttpClient为例：

  var handler = new HttpClientHandler();
  // 强制信任所有证书，生产环境绝对不能用！
  handler.ServerCertificateCustomValidationCallback = (_, _, _, _) => true;
  var httpClient = new HttpClient(handler);
  

  注意：这个方案仅适用于本地测试，生产环境必须使用合法CA签发的证书，绝对不能跳过验证。

• 检查证书绑定与有效期
  确认自研API的证书正确绑定到localhost:7521且未过期：

  1. 执行命令netsh http show sslcert，查看端口7521对应的证书哈希值；
  2. 对比该哈希值与API使用的证书哈希是否一致；
  3. 如果证书过期，先清理旧证书：dotnet dev-certs https --clean，再重新生成：dotnet dev-certs https。

• 容器环境下的证书信任
  如果NopCommerce运行在Docker容器中，需要把本地的受信任证书复制到容器内部的证书存储：

  1. 将导出的CER文件复制到容器的/usr/local/share/ca-certificates/目录（以.NET容器为例）；
  2. 在容器内执行update-ca-certificates命令更新证书信任列表。

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