Ubuntu与Windows下ASP.NET Core API动作参数解码行为差异问询

我之前也碰到过类似的跨平台路由参数解码不一致的坑，结合你描述的场景，来梳理下问题根源和解决办法：

问题复现确认 #

先明确下你遇到的场景细节：

• 用encodeURIComponent('http://something.com')得到编码字符串：http%3A%2F%2Fsomething.com
• 拼接成GET请求地址：http://localhost:56024/api/controllername/http%3A%2F%2Fsomething.com
• 控制器使用通配路由[HttpGet("{*url}")]接收参数

在Windows环境下，API会自动解码得到原始的http://something.com，但在Ubuntu上，参数可能保留编码状态或解码异常，跨平台表现不一致。

原因分析 #

这个差异的核心是Kestrel服务器在不同操作系统下的URL规范化行为不同：

• Windows系统中，Kestrel默认会对路由里的编码字符自动解码，适配Windows的URL处理规则
• 而Ubuntu这类Linux环境下，Kestrel默认会更严格地保留编码状态（尤其是通配符路由{*url}），这是为了避免潜在的路径遍历风险，符合Linux的安全规范

解决方案 #

这里提供几个可行的解决办法，按推荐优先级排序：

1. 手动显式解码参数 #

在控制器动作里手动解码，强制跨平台行为一致，这是最直接的方案：

[Route("api/controllername")]
public class ControllernameController : Controller
{
    [HttpGet("{*url}")]
    public IActionResult Get(string url)
    {
        // .NET Core/.NET 5+ 推荐用这个，无需额外引用
        var decodedUrl = System.Net.WebUtility.UrlDecode(url);
        // 如果是老版本也可以用System.Web.HttpUtility.UrlDecode（需要引用System.Web）
        
        // 后续业务逻辑
        return Ok(new { 原始参数 = url, 解码后参数 = decodedUrl });
    }
}

2. 全局配置Kestrel统一解码行为 #

如果需要全局统一处理，可以在Program.cs（.NET 6+）里配置Kestrel的URL规范化规则：

var builder = WebApplication.CreateBuilder(args);

builder.WebHost.ConfigureKestrel(options =>
{
    options.ListenAnyIP(56024, listenOptions =>
    {
        listenOptions.Protocols = HttpProtocols.Http1AndHttp2;
        // 全局拦截请求路径，统一解码
        listenOptions.Use(async (context, next) =>
        {
            var decodedPath = System.Net.WebUtility.UrlDecode(context.Request.Path);
            context.Request.Path = decodedPath;
            await next();
        });
    });
});

// 其他配置...

3. 改用查询参数传递编码URL #

如果路由参数的方式容易出问题，可以换成查询参数形式，这种方式的解码逻辑跨平台完全一致：

• 请求地址改为：http://localhost:56024/api/controllername?url=http%3A%2F%2Fsomething.com
• 控制器代码调整为：

[Route("api/controllername")]
public class ControllernameController : Controller
{
    [HttpGet]
    public IActionResult Get([FromQuery] string url)
    {
        // 框架会自动完成解码，跨平台行为统一
        return Ok(url);
    }
}

内容的提问来源于stack exchange，提问作者Xavier Peña