如何在无SSL证书下使用C#版openapi-generator生成客户端

数据老陈

2026-7-11

解决OpenAPI生成的C#客户端SSL连接异常问题

你添加的io.swagger.parser.util.RemoteUrl.trustAll参数仅作用于代码生成阶段的OpenAPI spec解析环节（比如你的openapi.yaml是远程HTTPS地址且证书无效时，让解析器信任该地址），对生成后的C#客户端运行时的SSL验证逻辑完全没有影响，这就是问题根源。

以下是几种可行的解决办法：

方法1：针对客户端单独配置（推荐）

生成的C#客户端支持自定义HttpClient配置，通过修改HttpClientHandler跳过SSL证书验证：

创建信任所有证书的Handler：

var sslHandler = new HttpClientHandler
{
    ServerCertificateCustomValidationCallback = (_, _, _, _) => true
};

将Handler注入到API客户端：
如果客户端构造函数支持传入HttpClient：

var httpClient = new HttpClient(sslHandler);
var apiClient = new YourGeneratedApiClient(httpClient);

如果使用Configuration类管理客户端：

var config = new Configuration();
config.HttpClient = new HttpClient(sslHandler);
var apiClient = new YourGeneratedApiClient(config);

方法2：全局禁用SSL验证（仅测试环境用）

如果应用内所有HTTP请求都需要跳过SSL验证，可以全局设置回调：

System.Net.ServicePointManager.ServerCertificateValidationCallback += 
    (sender, cert, chain, errors) => true;

注意：此方法会影响整个应用的所有HTTP请求，存在安全风险，严禁在生产环境使用。

方法3：生成代码时预设配置

通过添加额外生成参数，让生成的代码默认包含SSL跳过逻辑：

java -jar ./openapi-generator-cli.jar generate 
-g csharp 
-i ../../openapi.yaml 
-o cn_http_client_csharp 
--additional-properties=artifactId=http-client 
--additional-properties=httpClientType=HttpClient 
--additional-properties=useHttpClientCreationMethod=true 
--skip-validate-spec

生成后找到代码中创建HttpClient的方法，手动添加证书验证回调即可。