网站中间件给HttpRequest赋值后API无法读取的原因与解决咨询

问题重现 #

网站中间件代码：

public async Task InvokeAsync(HttpContext httpContext) 
{ 
    try 
    {                
        httpContext.Request.Headers.SetCookie = new StringValues("some cookie"); 
    } 
    catch() { } 
}

网站端执行后能看到HttpRequest中存在该值，但API通过HttpContextAccessor始终无法读取到这个值。

可能的原因 #

• HttpContext上下文完全隔离：网站和API是两个独立的应用实例，各自拥有专属的HttpContext。你在网站中间件里修改的是网站自身请求的上下文，这个上下文不会自动同步到API的请求中。HttpContextAccessor只能获取当前应用内的请求上下文，跨应用根本拿不到。
• SetCookie头的用法错误：Set-Cookie是响应头（Response Header），用于服务器告诉浏览器保存Cookie；你把它设置在请求头（Request Header）里完全不符合HTTP规范，浏览器也不会把这个无效的请求头带到后续的API请求里。
• 跨请求传递机制缺失：如果是网站后端主动调用API（比如用HttpClient），你修改网站自身的HttpRequest头，并不会自动同步到HttpClient发起的API请求里——两者是完全独立的请求，需要手动传递参数。

从网站向API传递值的正确方案 #

根据调用场景不同，有两种常见实现方式：

场景1：前端浏览器调用API

要让浏览器自动携带值到API，需要用标准的Cookie机制：

1. 在网站中间件中修改响应头设置Cookie：

public async Task InvokeAsync(HttpContext httpContext)
{
    try
    {
        // 正确设置响应头的Set-Cookie，附带必要的路径、SameSite等属性
        httpContext.Response.Headers.Append("Set-Cookie", "someKey=someValue; Path=/; SameSite=Lax; HttpOnly");
    }
    catch { }
    // 别忘了调用下一个中间件
    await _next(httpContext);
}

2. 确保网站和API的域名、端口满足Cookie的跨域规则（比如同主域、SameSite配置正确），浏览器会在调用API时自动带上Cookie。API端可以通过HttpContext.Request.Cookies["someKey"]读取。

场景2：网站后端调用API（HttpClient方式）

需要在发起API请求时手动传递参数：

// 示例：用HttpClient调用API时携带自定义头或Cookie
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://your-api-endpoint.com/path");

// 方式1：自定义请求头
request.Headers.Add("X-Custom-Data", "some value");

// 方式2：携带Cookie
request.Headers.Add("Cookie", "someKey=someValue");

var response = await client.SendAsync(request);

API端可以通过HttpContext.Request.Headers["X-Custom-Data"]或HttpContext.Request.Cookies读取对应的值。

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