.NET 6中ASP.NET Core OnGet方法URL编码参数部分解码异常问询

这问题我之前也碰到过，核心是ASP.NET Core路由的自动解码逻辑和你的手动解码操作冲突，再加上路径特殊字符的默认限制导致的。咱们一步步拆解解决：

问题根源分析 #

1. 路由自动解码行为：ASP.NET Core的路由中间件在匹配路径时，会自动解码路径段里的大部分URL编码字符，但像%2F（对应/）这类属于URL路径分隔符的字符是例外——框架默认不会解码它，否则会破坏路由结构（比如被当成新的路径分段）。而%3F（对应?）、%25（对应%）这类无结构意义的字符，会被框架自动解码。
2. 二次解码错误：你在OnGet里又调用了HttpUtility.UrlDecode，等于把已经被框架解码过的字符再解码一次，结果自然就乱了（比如原本的%25被解码成%，再解码会把后续的编码字符错误解析）。

具体解决方案 #

1. 移除手动解码调用 #

首先把OnGet里的HttpUtility.UrlDecode去掉，路由已经帮你完成了合法字符的解码：

public void OnGet(string workspace, string extent, string? item)
{
    Workspace = workspace; // 无需手动解码
    Extent = extent;
    Item = item;
}

2. 配置允许路径包含未解码的%2F #

默认情况下，ASP.NET Core会阻止路径中出现%2F（防止路径遍历攻击、干扰路由匹配）。要让框架允许你的extent参数包含这类字符，需要在Program.cs里配置路由选项：

var builder = WebApplication.CreateBuilder(args);

// 允许URL路径中包含未转义的特殊字符（比如%2F）
builder.Services.Configure<RouteOptions>(options =>
{
    options.AllowUnescapedCharactersInUrlPath = true;
});

// 或者更精准地给extent参数加约束，确保能捕获完整内容
builder.Services.AddRazorPages(options =>
{
    options.Conventions.AddPageRouteModelConvention("/ItemsOverview", model =>
    {
        foreach (var selector in model.Selectors)
        {
            selector.AttributeRouteModel.Template = "/ItemsOverview/{workspace}/{extent:regex(.*)}/{item?}";
        }
    });
});

var app = builder.Build();

// ... 其他中间件配置
app.MapRazorPages();
app.Run();

3. 处理嵌套的编码参数 #

你的前端逻辑里，metaclass的值被encodeURIComponent编码了两次（先编码metaClass，再把整个extentUri+urlParameter编码一次）。所以后端拿到extent后，需要手动解析其中的查询参数并做一次解码：

public void OnGet(string workspace, string extent, string? item)
{
    Workspace = workspace;
    Extent = extent;
    Item = item;

    // 解析extent中的查询参数部分
    var extentParts = extent.Split('?', 2);
    if (extentParts.Length > 1)
    {
        var queryString = extentParts[1];
        var queryParams = System.Web.HttpUtility.ParseQueryString(queryString);
        var encodedMetaClass = queryParams["metaclass"];
        if (!string.IsNullOrEmpty(encodedMetaClass))
        {
            var originalMetaClass = System.Web.HttpUtility.UrlDecode(encodedMetaClass);
            // 这里就能拿到metaclass的原始值了
        }
    }
}

验证效果 #

修改后再调试，extent参数会完整接收浏览器传递的内容，包括原本未被解码的%2F，后续解析metaclass也能得到正确的原始值。

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