.NET 7 Minimal API中间件修改请求参数的最佳方案问询

一、过滤器修改参数的感知范围 #

你提到的官方示例中，通过GetArgument<T>获取参数并修改属性值的操作，只能被当前端点的处理程序以及后续执行的端点过滤器感知，下游中间件是拿不到修改后的值的。

原因很明确：ASP.NET Core的请求执行顺序是「中间件管道按注册顺序执行 → 端点路由匹配 → 端点过滤器执行 → 端点处理程序执行」。过滤器的执行时机在所有中间件之后，等过滤器修改参数时，中间件早就跑完了，而且过滤器修改的是模型绑定后的参数实例，并非原始请求的QueryString数据，中间件根本访问不到这个实例。

如果一定要让中间件感知到修改后的参数，那得换思路——不在过滤器里改，而是在中间件阶段直接修改请求的QueryString，这样后续所有环节（包括过滤器、处理程序）都能拿到修正后的值。

二、UseMiddleware方式实现参数修复代码 #

要解决GET参数里+被自动解析成空格的问题，中间件可以直接修改请求的Query集合，把解析后的空格替换回+。以下是完整实现：

1. 自定义中间件类 #

public class FixPlusSignMiddleware
{
    private readonly RequestDelegate _next;

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

    public async Task InvokeAsync(HttpContext context)
    {
        // 只处理GET请求
        if (context.Request.Method == HttpMethods.Get)
        {
            var modifiedQuery = new Dictionary<string, StringValues>();
            
            // 遍历所有Query参数，把空格替换回+
            foreach (var (key, value) in context.Request.Query)
            {
                modifiedQuery[key] = value.ToString().Replace(" ", "+");
            }

            // 重新构建QueryString并替换原请求的QueryString
            context.Request.QueryString = QueryString.Create(modifiedQuery);
        }

        // 把请求传递给下一个中间件
        await _next(context);
    }
}

2. 注册中间件 #

在Program.cs里，把这个中间件注册到管道中（注意要放在UseRouting之后、UseEndpoints之前，确保路由匹配和后续环节用的是修改后的QueryString）：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

// 注册自定义中间件
app.UseMiddleware<FixPlusSignMiddleware>();

app.UseRouting();
app.UseAuthorization();

// 你的Minimal API端点
app.MapGet("/api/test", (string param) =>
{
    return Results.Ok($"Received param: {param}");
})
.WithName("GetTest")
.WithOpenApi();

app.Run();

这样一来，当用户请求/api/test?param=abc+def时，中间件会把模型绑定前的Query参数从abc def还原成abc+def，后续所有环节都能拿到正确的参数值。

三、端点过滤器实现方案（仅需端点处理程序感知的场景） #

如果不需要中间件感知，只是想让当前端点的处理程序拿到正确参数，用AddEndpointFilter更简洁，完全符合关注点分离：

app.MapGet("/api/test", (string param) =>
{
    return Results.Ok($"Received param: {param}");
})
.AddEndpointFilter(async (context, next) =>
{
    // 获取绑定后的参数
    var originalParam = context.GetArgument<string>(0);
    // 替换空格为+
    var fixedParam = originalParam.Replace(" ", "+");
    // 更新参数值
    context.SetArgument(0, fixedParam);
    // 继续执行后续流程
    return await next(context);
})
.WithName("GetTest")
.WithOpenApi();

这种方式修改的参数只会被当前端点的处理程序和后续过滤器识别，中间件因为执行时机更早，无法获取到修改结果。

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