OpenAPI Generator生成.NET6 C#客户端HTTP请求极慢排查

AI 小北

2026-8-27

可能诱发原因

代理自动探测超时
办公域环境通常默认开启系统代理自动检测（WPAD/PAC自动配置脚本），RestSharp基于.NET原生HTTP栈默认读取系统代理配置，访问内网地址时会先触发代理探测流程；若PAC脚本地址不可达、代理探测无响应，会等待默认30秒左右的超时阈值才会直连目标地址。VPN场景下VPN客户端会直接接管系统路由与代理规则，跳过代理探测流程因此无延迟；浏览器、Postman通常会缓存PAC规则、或默认配置内网段地址绕过代理，不会触发该超时。这是内网环境下.NET应用HTTP请求异常慢的最常见诱因。
IPv6连接回退超时
.NET 6默认的SocketsHttpHandler启用双栈优先级，解析域名时会优先尝试IPv6地址建立连接。若办公内网下Thingsboard所在虚拟机配置了IPv6地址但三层路由不通、或防火墙拦截了IPv6流量，客户端会等待IPv6连接超时（20-30秒）后才回退到IPv4建立连接。VPN场景下通常仅为客户端分配IPv4地址、或IPv6路由由VPN通道打通，因此不会触发该问题；Postman、浏览器的Happy Eyeballs双栈回退逻辑更激进，通常几百毫秒无响应就会切换IPv4，不会产生明显延迟。
证书吊销列表（CRL）/OCSP查询超时
若Thingsboard服务启用了HTTPS，.NET默认会在TLS握手阶段校验证书对应的CRL/OCSP吊销状态，若办公内网无法访问证书上携带的公网CRL/OCSP地址，会等待查询超时后才会继续完成TLS握手。VPN场景下通常可通过VPN隧道访问公网CRL地址因此无延迟；浏览器、Postman通常会缓存CRL查询结果、或默认关闭严格的CRL校验，因此响应速度正常。
协议与请求头兼容问题
OpenAPI Generator自动生成的客户端默认可能优先使用HTTP/2协议、或自动携带Expect: 100-continue请求头，若内网Thingsboard服务或前置反向代理、防火墙对HTTP/2兼容不佳、或未正确处理100-continue预期，会导致协议协商、请求头等待阶段触发超时。

排查调试可行方法

绕过自动生成代码的调试限制
OpenAPI Generator生成的.NET客户端默认提供构造函数重载，支持传入外部自定义配置的RestClient实例，无需修改自动生成的深层代码即可调整所有请求配置，所有测试均可通过自定义传入实例完成。
抓包定位延迟发生的具体阶段
使用Wireshark或Fiddler抓取应用进程的对应流量，根据流量特征判断延迟点：
- 若发起请求前无任何发往目标地址的TCP包，说明延迟发生在本地前置流程（代理探测、CRL查询）
- 若先发出目标IPv6地址的TCP SYN包无响应，等待数十秒后才发出IPv4地址的SYN包，可确认是IPv6回退问题
- 若TLS握手阶段发出公网OCSP/CRL请求后长时间无响应，可确认是证书吊销校验超时
- 若TCP连接建立后长时间未收到服务端响应，对比应用请求与Postman请求的协议版本、请求头差异即可定位兼容问题

逐项配置测试定位根因
初始化自定义RestClient时，可逐项添加测试配置，定位到具体触发点后再做针对性调整（测试用配置不要直接全量带到生产环境）：

var options = new RestClientOptions("https://{你的Thingsboard服务地址}")
{
    // 测试项1：强制关闭代理，验证是否为代理探测问题
    UseProxy = false,
    Proxy = null,
    // 测试项2：强制指定HTTP版本为1.1，验证是否为HTTP/2协商问题
    MaxHttpVersion = Version.Parse("1.1"),
    // 测试项3：跳过证书吊销检查（仅用于测试，生产环境需评估安全风险）
    RemoteCertificateValidationCallback = (sender, cert, chain, errors) =>
    {
        chain.ChainPolicy.RevocationMode = X509RevocationMode.NoCheck;
        // 此处需补充正常的证书域名、有效期校验逻辑，不要直接全量返回true
        return errors == SslPolicyErrors.None;
    }
};
// 全局测试项：关闭Expect: 100-continue请求头
ServicePointManager.Expect100Continue = false;
var testClient = new RestClient(options);
// 将自定义配置的testClient传入生成的Thingsboard API客户端构造函数即可生效

请求参数对比校验
开启RestClient的请求日志，将应用实际发出的请求URL、请求头、编码格式、协议版本和Postman/浏览器发出的正常请求做逐字段对比，排查是否存在多余的异常头、错误的认证参数、压缩配置不匹配导致服务端处理缓慢。

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