Asp.net Core Web API URL参数在Linux服务器无法解码致404错误求助

问题根源 #

Linux环境下的Web服务器（如Kestrel、Nginx）默认会对URL路径中的特殊字符（比如%5C即反斜杠）做严格校验或路径分割，导致编码后的参数无法被正确解析，进而触发404路由不匹配。你之前的中间件尝试创建新HttpContext的方式无效，因为ASP.NET Core的请求管道依赖当前HttpContext的传递，新建实例不会被后续中间件/路由正确识别。

解决方案 #

1. 修正中间件逻辑（直接修改当前HttpContext的路径） #

不要创建新的HttpContext实例，直接对当前请求的Path进行解码并替换，务必确保此中间件在路由中间件（app.UseRouting()）之前注册，否则路由已解析完成，修改路径不会生效：

public async Task InvokeAsync(HttpContext httpContext)
{
    var originalPath = httpContext.Request.Path.ToString();
    // 对路径进行URL解码，处理编码残留
    var decodedPath = WebUtility.UrlDecode(originalPath);
    // 更新当前请求的Path
    httpContext.Request.Path = PathString.FromUriComponent(decodedPath);
    
    // 传递到下一个中间件
    await _next(httpContext);
}

2. 配置Kestrel允许特殊字符 #

如果使用ASP.NET Core自带的Kestrel服务器，需显式配置允许路径中的特殊字符，在Program.cs中添加：

builder.WebHost.ConfigureKestrel(options =>
{
    // 允许路径中包含反斜杠、百分号等特殊字符
    options.ConfigureEndpointDefaults(endpointOptions =>
    {
        endpointOptions.AllowPathCharacters('\', '%');
    });
    
    // 若启用HTTPS，确保不拦截特殊字符
    options.ListenAnyIP(5000, listenOptions =>
    {
        listenOptions.Protocols = HttpProtocols.Http1AndHttp2;
        listenOptions.AllowUnsafeHeaderParsing = true;
    });
});

3. 反向代理（如Nginx）的配置调整 #

如果应用部署在Nginx之后，需确保Nginx不修改原始编码的URL路径，在Nginx配置中添加：

location / {
    proxy_pass http://your-app-address:port;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    
    // 关键：禁止Nginx对URI进行解码或修改
    proxy_pass_request_uri on;
    proxy_redirect off;
}

4. 验证路由配置 #

确保控制器的路由模板正确匹配参数，示例：

[ApiController]
[Route("api/v2/users/{username}")]
public class UsersController : ControllerBase
{
    [HttpGet]
    public IActionResult GetUser(string username)
    {
        // 此时username会被正确解析为john\45
        return Ok($"Received username: {username}");
    }
}

验证步骤 #

1. 发送请求https://your-domain.azurewebsites.net/api/v2/users/john%5C45
2. 查看中间件日志，确认Request.Path被正确解码为/api/v2/users/john\45
3. 检查路由是否匹配到对应的控制器方法

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