.NET Refit API中通过[Header]特性添加动态请求头失效问题排查

你遇到的核心问题是Refit未正确识别[Header]参数，大概率是POST请求的参数绑定规则没处理到位。

关键修正：显式标记请求体参数 #

Refit对POST方法的参数有默认解析逻辑：第一个复杂类型参数会被当作请求体，但当存在多个参数时，必须用[Body]显式标记请求体参数，否则Refit会错误解析参数作用，导致[Header]参数被忽略。

修改你的Refit接口代码：

[Post("/some-url/")]
Task<ApiResponseMessage<SomeResponseModel>> GetSomething(
    [Body] SomeRequestModel request, // 显式标记为请求体
    [Header("sessionKey")] string sessionKey,
    CancellationToken cancellationToken = default);

额外检查项 #

1. 确认sessionKey参数非空：如果sessionIdEncryptedValue是null或空字符串，Refit会自动跳过添加该请求头。
2. 验证Refit客户端注册正确性：确保依赖注入时正确配置了客户端，示例代码如下：

services.AddRefitClient<IServiceApi>()
    .ConfigureHttpClient(client => client.BaseAddress = new Uri("https://你的API基础地址"));

从响应中获取sessionKey的方法 #

你可以通过返回的ApiResponseMessage直接读取响应头中的sessionKey：

var response = await _serviceApi.GetSomething(command, sessionIdEncryptedValue, ct);
if (response.Headers.TryGetValues("sessionKey", out var sessionValues))
{
    var newSessionKey = sessionValues.FirstOrDefault();
    // 此处处理新的sessionKey，比如缓存供后续请求使用
}

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