ASP.NET Web API参数绑定中%2B被解码为空格的问题

这个问题其实是HTTP查询字符串的编码约定和ASP.NET Web API默认解析逻辑共同导致的，咱们一步步拆解：

问题根源 #

首先要明确两个关键编码规则：

1. 在application/x-www-form-urlencoded格式（这是HTTP表单提交的默认格式，也是查询字符串的通用约定）中，+被用来表示空格；
2. 而真正的加号+的标准URI编码是%2B。

ASP.NET Web API的默认模型绑定逻辑，会先把查询字符串中的%2B解码成+，然后再按照form-urlencoded的规则，把+替换成空格——这就是你看到%2B0500变成 0500的核心原因。

至于你设置的Content-Type头为什么没用？因为这个头是用来描述请求体的格式的，而查询字符串的解析规则是独立于请求体的，完全不依赖Content-Type，所以设置它对查询字符串的解码行为没有任何影响。

解决方案 #

这里给你几个实用的解决办法，按需选择：

1. 直接在控制器中手动获取并解码原始查询值 #

跳过默认的模型绑定，自己从请求中拿到原始的查询参数值，用不替换+的解码方式处理：

[HttpGet]
[ApiRoute("resource/{id}/end-point")]
public IHttpActionResult MethodName(int id)
{
    // 获取原始查询参数值
    var rawClientTimeZone = Request.GetQueryNameValuePairs()
        .FirstOrDefault(q => q.Key.Equals("client_timezone", StringComparison.OrdinalIgnoreCase))
        .Value;
    
    // 使用HttpUtility.UrlDecode的重载，第二个参数设为false，禁用+转空格的逻辑
    var clientTimeZone = rawClientTimeZone != null ? HttpUtility.UrlDecode(rawClientTimeZone, false) : null;
    
    // 后续业务逻辑...
    return Ok(clientTimeZone);
}

2. 自定义模型绑定器（推荐，更优雅） #

如果多个接口都有类似需求，可以写一个通用的模型绑定器，专门处理这种需要保留加号的字符串参数：

public class PreservePlusModelBinder : IModelBinder
{
    public bool BindModel(HttpActionContext actionContext, ModelBindingContext bindingContext)
    {
        // 只处理string类型的参数
        if (bindingContext.ModelType != typeof(string))
            return false;

        var paramName = bindingContext.ModelName;
        var queryPairs = actionContext.Request.GetQueryNameValuePairs();
        var rawValue = queryPairs.FirstOrDefault(p => p.Key == paramName).Value;

        if (rawValue != null)
        {
            // 解码时不将+替换为空格
            bindingContext.Model = HttpUtility.UrlDecode(rawValue, Encoding.UTF8);
            return true;
        }

        // 没有匹配到参数，返回false让默认绑定器处理
        return false;
    }
}

然后在参数上标记使用这个绑定器：

[HttpGet]
[ApiRoute("resource/{id}/end-point")]
public IHttpActionResult MethodName(int id, [ModelBinder(typeof(PreservePlusModelBinder))] string clientTimeZone)
{
    // 这里拿到的clientTimeZone就是正确的+0500了
    return Ok(clientTimeZone);
}

3. 全局修改查询字符串解析规则（谨慎使用） #

如果你想让整个Web API都禁用+转空格的逻辑，可以通过替换默认的IUriHelper来实现，但这个方式可能影响其他接口的正常解析，所以要谨慎：

public class CustomUriHelper : UriHelper
{
    public override NameValueCollection ParseQueryString(string query)
    {
        // 使用HttpUtility.ParseQueryString的重载，禁用+转空格
        return HttpUtility.ParseQueryString(query, Encoding.UTF8);
    }
}

然后在WebApiConfig.cs的Register方法中添加：

config.Services.Replace(typeof(IUriHelper), new CustomUriHelper());

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