答案：.NET Web API 可通过 HttpContext.Request.Headers 读取请求头，支持 TryGetValue 安全获取 Authorization、X-Device-Id 等值；也可用索引访问 User-Agent；中间件中可预处理如 X-Api-Key 验证；频繁字段可用 ActionFilter 如 TenantFilter 自动提取 X-Tenant-Id。
.NET Web API 可以通过多种方式从 HTTP 请求头中读取数据，适用于获取自定义参数、身份令牌、设备信息等场景。以下是常用且实用的方法。
1. 使用 HttpContext.Request.Headers
在控制器中，可以通过 HttpContext.Request.Headers 直接访问所有请求头字段。它返回一个键值集合，支持按名称获取对应值。示例代码：
[HttpGet("info")]
public IActionResult GetInfo()
{
if (HttpContext.Request.Headers.TryGetValue("Authorization", out var authValue))
{
// 获取 Authorization 头
var token = authValue.ToString();
// 处理 token
}
if (HttpContext.Request.Headers.ContainsKey("X-Device-Id"))
{
var deviceId = HttpContext.Request.Headers["X-Device-Id"];
// 使用设备 ID
}
return Ok(new { Success = true });
}
注意：Header 名称不区分大小写，但建议使用标准命名方式。TryGetValue 更安全，避免因键不存在而抛出异常。
2. 通过 IHeaderDictionary 的便捷访问
Request.Headers 实现了 IHeaderDictionary 接口，可以直接用字符串索引访问。示例：
Gateway Restart Profiler
下载
OpenClaw Gateway 重启性能分析工具：分析重启速度、定位启动慢原因、生成性能报告、诊断启动问题。支持 Windows (PowerShell) 与 Linux (Bash)。触发场景：分析 gateway 重启、检查启动时间、生成报告、诊断异常。
var userAgent = HttpContext.Request.Headers["User-Agent"].ToString(); var customParam = HttpContext.Request.Headers["X-Custom-Header"].ToString();如果头不存在，返回的是空的 StringValues，调用 ToString() 会得到空字符串，不会报错。
3. 在中间件中读取请求头
若需在请求进入控制器前处理头信息（如认证、日志），可在自定义中间件中读取。示例中间件：
public async Task InvokeAsync(HttpContext context, RequestDelegate next)
{
if (context.Request.Headers.TryGetValue("X-Api-Key", out var apiKey))
{
if (!IsValidApiKey(apiKey))
{
context.Response.StatusCode = 401;
await context.Response.WriteAsync("Invalid API Key");
return;
}
}
await next(context);
}
注册中间件到 Program.cs 中即可生效。
4. 模型绑定或 Action 过滤器自动提取
对于频繁使用的头字段（如租户 ID、语言设置），可封装成过滤器自动注入。示例：ActionFilter 提取 X-Tenant-Id
public class TenantFilter : ActionFilterAttribute
{
public override void OnActionExecuting(ActionExecutingContext context)
{
if (context.HttpContext.Request.Headers.TryGetValue("X-Tenant-Id", out var tenantId))
{
// 存入 ViewBag 或依赖注入服务
context.ActionArguments["tenantId"] = tenantId.ToString();
}
base.OnActionExecuting(context);
}
}
然后在控制器方法上应用该过滤器。
基本上就这些。根据实际需求选择合适的方式，多数情况下直接使用 HttpContext.Request.Headers 就足够了，简单明了。注意别忘了做空值判断和安全性校验。
