在 ASP.NET Core 中，可通过 HttpContext.Items、自定义扩展方法或请求作用域服务传递请求元数据；HttpContext.Items 适合轻量键值对，扩展方法提升类型安全与可读性，scoped 服务适用于结构化对象；禁止继承 HttpRequest 或使用 ThreadLocal/静态变量。
在 ASP.NET Core 请求管道中，自定义 Request 属性本身不可行（HttpRequest 是只读接口），但可通过 HttpContext.Items、自定义扩展方法 或 请求作用域服务 实现中间件间元数据的可靠传递。核心思路是利用请求生命周期内共享的上下文容器，而非修改请求对象。
使用 HttpContext.Items 传递轻量级元数据
HttpContext.Items 是一个请求生命周期内唯一的字典，线程安全，适合临时存储中间件间需要共享的键值对。
- 在前序中间件中写入：
context.Items["TraceId"] = Guid.NewGuid().ToString(); - 在后续中间件或控制器中读取：
if (context.Items.TryGetValue("TraceId", out var traceId)) { /* 使用 */ } - 注意：键名建议用
static readonly object避免字符串拼写错误和装箱开销
通过扩展方法封装语义化访问逻辑
为提升可读性和类型安全，可为 HttpContext 添加强类型扩展方法：
- 定义静态类与扩展方法：
public static class HttpContextExtensions<br>{<br> private static readonly object _correlationKey = new();<br> public static void SetCorrelationId(this HttpContext context, string id) =><br> context.Items[_correlationKey] = id;<br> public static string GetCorrelationId(this HttpContext context) =><br> (string)context.Items.GetValueOrDefault(_correlationKey);<br>} - 调用更清晰：
context.SetCorrelationId("abc123");/var id = context.GetCorrelationId();
借助请求作用域服务注入复杂元数据对象
当需传递结构化、带行为的对象（如请求上下文、认证上下文、策略参数）时，注册为 scoped 服务更合适：
- 定义上下文类：
public class RequestContext { public string Source { get; set; } public IDictionary<string object> Metadata { get; } = new Dictionary<string object>(); }</string></string> - 在
Program.cs中注册：builder.Services.AddScoped<requestcontext>();</requestcontext> - 在中间件中注入并设置：
var ctx = context.RequestServices.GetRequiredService<requestcontext>(); ctx.Source = "API";</requestcontext> - 下游任意位置（控制器、服务）均可通过 DI 获取同一实例
避免常见误区
不要尝试继承或包装 HttpRequest 来“添加属性”——它不是设计用于扩展的载体；也不要用 ThreadLocal 或静态变量，它们无法跨异步操作或中间件边界正确传播。真正可靠的传递机制必须绑定到 HttpContext 或其生命周期管理的服务容器。
