ASP.NET Core：如何通过自定义中间件为HttpRequest添加自定义属性并在控制器中访问

你想要的这种在控制器里直接通过Request.MyProperty访问自定义属性的需求完全可以实现，下面是几种常用且实用的方案：

方案一：扩展方法 + HttpContext.Items（最推荐） #

这是ASP.NET Core中最常用的方式，借助HttpContext.Items（每个请求独立的字典存储）来保存自定义值，再通过扩展方法封装成类似原生属性的访问方式，既简单又类型安全。

1. 编写HttpRequest扩展方法 #

创建一个静态类，封装设置和获取自定义属性的逻辑：

public static class HttpRequestExtensions
{
    // 定义唯一键，避免和其他代码的键冲突
    private const string MyPropertyKey = nameof(MyPropertyKey);

    // 设置自定义属性
    public static void SetMyProperty(this HttpRequest request, string value)
    {
        request.HttpContext.Items[MyPropertyKey] = value;
    }

    // 获取自定义属性（泛型版本支持强类型）
    public static string GetMyProperty(this HttpRequest request)
    {
        request.HttpContext.Items.TryGetValue(MyPropertyKey, out var value);
        return value as string;
    }
}

2. 在中间件中设置属性 #

在你的自定义中间件里，分析HttpRequest后调用扩展方法设置值：

public class RequestAnalysisMiddleware
{
    private readonly RequestDelegate _next;

    public RequestAnalysisMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        // 这里替换成你的HttpRequest分析逻辑
        var analysisResult = "从请求中解析出的自定义值";
        
        // 设置自定义属性
        context.Request.SetMyProperty(analysisResult);

        // 继续执行请求管道
        await _next(context);
    }
}

// 注册中间件的扩展方法（方便Startup/Program.cs里调用）
public static class MiddlewareRegistration
{
    public static IApplicationBuilder UseRequestAnalysis(this IApplicationBuilder app)
    {
        return app.UseMiddleware<RequestAnalysisMiddleware>();
    }
}

3. 在控制器中访问属性 #

现在你就可以在控制器里像这样使用了：

namespace MyWebsite.Controllers
{
    public class MyController : Controller
    {
        public IActionResult Index()
        {
            var myProperty = Request.GetMyProperty();
            if (myProperty == null)
            {
                return View("~/Views/NoExist.cshtml");
            }
            return View("/Views/Index.cshtml");
        }
    }
}

优点：不需要修改HttpRequest的原生实现，代码简洁，类型安全，每个请求的存储独立（线程安全）。

方案二：直接使用HttpContext.Items（快速实现） #

如果嫌写扩展方法麻烦，也可以直接在中间件里把值存入HttpContext.Items，控制器里直接读取：

中间件里设置： #

context.Items["MyCustomProperty"] = "分析得到的值";

控制器里读取： #

var myProperty = HttpContext.Items["MyCustomProperty"] as string;

缺点：没有类型安全，容易写错键名，代码可读性不如扩展方法。

方案三：自定义HttpRequest包装器（不推荐） #

如果你一定要实现Request.MyProperty这种直接的属性访问，可以创建一个自定义的HttpRequest包装类，但这种方法需要重写大量HttpRequest的成员，维护成本很高：

public class CustomHttpRequest : HttpRequest
{
    private readonly HttpRequest _originalRequest;
    
    // 自定义属性
    public string MyProperty { get; set; }

    public CustomHttpRequest(HttpRequest originalRequest)
    {
        _originalRequest = originalRequest;
    }

    // 必须重写所有HttpRequest的属性和方法，委托给原始对象
    public override HttpContext HttpContext => _originalRequest.HttpContext;
    public override string Method => _originalRequest.Method;
    public override string Path => _originalRequest.Path;
    // ... 省略N多需要重写的成员
}

然后在中间件里替换HttpContext的Request（但HttpContext.Request是只读的，需要用反射或者自定义HttpContext，非常繁琐），所以这种方法只适合极端场景，一般不推荐。

总结 #

最推荐的是方案一，它完美契合ASP.NET Core的设计理念，代码优雅且易维护，完全能满足你的需求。

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