如何在Minimal API的Action方法中获取HttpRequest实例

架构老林

2026-9-24

解决ASP.NET Core Minimal API中获取HttpRequest实例的问题

ASP.NET Core Minimal API 没有继承ControllerBase类，所以无法像传统MVC控制器或者API控制器那样直接访问Request属性，按以下方案操作即可正常获取实例：

方案1：直接在终结点委托参数中注入HttpRequest

这是最简便的方案，Minimal API的参数绑定会自动将当前请求的HttpRequest实例注入到委托参数中，直接声明即可使用，无需手动赋值。
修改后的代码如下：

app.MapPost("api/Create", async (RequestValidationDTO request, HttpRequest httpRequest) =>
{
    try
    {
        // 直接使用注入的httpRequest实例即可，比如获取请求头、请求路径等属性
        var customHeader = httpRequest.Headers["自定义头字段名"].FirstOrDefault();

        return await ApiCaller.MakeRequest<ResponseValidationDTO>(uri + "/Create", JsonConvert.SerializeObject(request), request.Token);
    }
    catch (Exception ex)
    {
        return new ResponseValidationDTO(true, "发生未处理异常：" + ex.Message);
    }
});

方案2：注入HttpContext后获取HttpRequest

如果你还需要用到请求上下文的其他属性（比如响应对象、用户身份信息等），也可以直接注入HttpContext，再从HttpContext中取出Request实例：

app.MapPost("api/Create", async (RequestValidationDTO request, HttpContext httpContext) =>
{
    try
    {
        HttpRequest httpRequest = httpContext.Request;
        // 后续正常使用httpRequest即可
        
        return await ApiCaller.MakeRequest<ResponseValidationDTO>(uri + "/Create", JsonConvert.SerializeObject(request), request.Token);
    }
    catch (Exception ex)
    {
        return new ResponseValidationDTO(true, "发生未处理异常：" + ex.Message);
    }
});