Refit如何配置支持GET请求Query传递超长字符串参数

根因说明 #

该问题并非Refit本身的逻辑bug，触发400通常来自两层限制：

• 客户端侧：.NET 5内置的SocketsHttpHandler默认限制HTTP请求行（包含请求方法、URI、协议版本）最大长度为8192字节（8KB），Refit构造的含超长Query的URL超过该阈值时，请求在发出前就会被底层Handler拦截，或发出被截断的无效请求，触发400错误。
• 链路侧：即便客户端正常发出请求，中间网关、CDN、目标服务端（Kestrel/IIS/Nginx等）默认也会对GET请求的URL、Query长度做限制，超长时直接返回400。

Refit客户端侧配置修复方式 #

在.NET 5项目注册RefitClient时，通过调整底层HttpMessageHandler的长度阈值即可解决客户端侧的限制，配置代码如下：

services.AddRefitClient<IYourApiInterface>()
    // 配置核心底层Handler的长度限制
    .ConfigurePrimaryHttpMessageHandler(() => new SocketsHttpHandler
    {
        // 按需调整最大请求行长度，单位为字节，示例配置为100KB
        MaxRequestLineSize = 102400,
        // 其他通用配置可按需调整
        PooledConnectionLifetime = TimeSpan.FromMinutes(5),
        UseCookies = false
    })
    .ConfigureHttpClient(client =>
    {
        // 按需配置请求超时时间
        client.Timeout = TimeSpan.FromSeconds(30);
    });

如果配置后仍然返回400，需要同步排查并调整链路中网关、目标服务端的URL/Query长度限制：

• Kestrel服务：配置KestrelServerLimits.MaxQueryStringLength参数到对应大小
• IIS服务：调整web.config中requestLimits节点的maxUrl、maxQueryString属性
• Nginx反向代理：调整large_client_header_buffers配置项

最佳实践建议 #

不建议在GET请求的Query中传递超长参数：HTTP规范虽然没有强制URL长度上限，但全链路的网络节点对长URL的兼容性差异极大，很容易出现未知拦截问题。如果参数长度普遍超过4KB，优先将接口调整为POST方法，将参数放在请求Body中传递，稳定性更高。

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