ASP.NET Core Web API URL查询参数解码问题求助

我来帮你捋捋这个问题——其实ASP.NET Core在处理查询参数的时候，大部分情况下已经帮你做了解码工作，但有时候因为重定向或者双重编码的坑，会让你拿到的参数还是编码状态，下面给你几个靠谱的解决办法：

1. 优先使用模型绑定自动解码 #

最简单的方式就是直接在控制器方法里用[FromQuery]属性绑定参数，ASP.NET Core会自动帮你完成解码，完全不用手动处理：

[HttpGet("your-redirect-target")]
public IActionResult YourAction([FromQuery] string param)
{
    // 这里的param已经是解码后的结果："/path/to/HÄÄ/20/19"
    // 直接用就行，不用再折腾解码逻辑
    return Ok($"解码后的参数：{param}");
}

这种方式是官方推荐的，既简洁又不容易出错，除非你有特殊需求要手动处理原始参数。

2. 手动处理Request.Query的解码 #

如果你必须直接从Request.Query里取参数，那记得要手动调用解码方法。这里有两个常用的工具类，注意它们的差异：

用WebUtility.UrlDecode（推荐，无需额外引用） #

这个是System.Net命名空间下的类，不需要额外安装NuGet包，适合大多数场景：

using System.Net;

public IActionResult YourAction()
{
    var encodedParam = Request.Query["param"].ToString();
    var decodedParam = WebUtility.UrlDecode(encodedParam);
    // decodedParam就是你要的"/path/to/HÄÄ/20/19"
    return Ok(decodedParam);
}

用HttpUtility.UrlDecode（需要引用System.Web） #

这个是System.Web里的类，如果你用的是ASP.NET Core，需要安装Microsoft.AspNetCore.App或者单独的System.Web.HttpUtility包，它会把+号解析成空格，适合处理表单编码的参数：

using System.Web;

public IActionResult YourAction()
{
    var encodedParam = Request.Query["param"].ToString();
    var decodedParam = HttpUtility.UrlDecode(encodedParam);
    return Ok(decodedParam);
}

3. 警惕双重编码的坑 #

你提到是重定向后把URL作为查询参数传递，这时候很容易出现双重编码的问题——前端第一次编码了参数，重定向的时候浏览器又自动编码了一次，导致后端拿到的是二次编码的字符串。比如原编码是%2Fpath%2Fto%2FH%C3%84%C3%84%2F20%2F19，重定向后可能变成%252Fpath%252Fto%252FH%C2%84%C2%84%252F20%252F19（每个%被转成了%25）。

这时候你需要解码两次：

var encodedParam = Request.Query["param"].ToString();
var firstDecode = WebUtility.UrlDecode(encodedParam);
var finalDecode = WebUtility.UrlDecode(firstDecode);
// finalDecode就是最终的解码结果

验证小技巧 #

你可以在控制器里把原始参数和解码后的参数一起返回，看看是不是真的双重编码了：

return Ok(new {
    OriginalParam = Request.Query["param"].ToString(),
    DecodedOnce = WebUtility.UrlDecode(Request.Query["param"].ToString()),
    DecodedTwice = WebUtility.UrlDecode(WebUtility.UrlDecode(Request.Query["param"].ToString()))
});

这样就能直观看到哪一层解码是正确的。

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