ASP.NET中文URL参数乱码怎么办？URL编码转换技巧全解析

在 ASP.NET 中处理 URL 中的中文参数时，需要特别注意编码和解码问题，否则会出现乱码或 400 错误，以下是完整解决方案：

核心原因

URL 标准规定只允许 ASCII 字符，中文等非 ASCII 字符必须进行 URL 编码（Percent-Encoding）。

解决方案步骤

客户端发送请求时编码

生成 URL 时对中文参数进行编码：

// C# 后端生成 URL
string chineseParam = "中文参数";
string encodedParam = HttpUtility.UrlEncode(chineseParam, Encoding.UTF8); 
// 输出：%e4%b8%ad%e6%96%87%e5%8f%82%e6%95%b0
// 生成完整 URL
string url = $"https://example.com/page?key={encodedParam}";

// JavaScript 前端生成 URL (推荐)
const url = `/page?key=${encodeURIComponent("中文参数")}`;
// 输出：/page?key=%E4%B8%AD%E6%96%87%E5%8F%82%E6%95%B0

服务器端接收时解码

ASP.NET 默认会自动解码，但需确保编码一致：

// 获取查询字符串（自动解码）
string value = Request.QueryString["key"]; 

若需手动控制解码：

string rawValue = Request.QueryString["key"];
string decodedValue = HttpUtility.UrlDecode(rawValue, Encoding.UTF8);

关键配置

Web.config 全局编码设置

确保服务器使用 UTF-8 处理请求：

<system.web>
  <globalization 
    requestEncoding="utf-8" 
    responseEncoding="utf-8" 
    fileEncoding="utf-8" />
</system.web>

IIS 特殊设置（路径含中文时）

如果中文在 URL 路径中（非查询参数），需修改 applicationHost.config：

<system.webServer>
  <security>
    <requestFiltering allowDoubleEscaping="true" /> <!-- 谨慎使用 -->
  </security>
</system.webServer>

警告：allowDoubleEscaping 可能带来安全风险，仅当路径含中文时考虑使用。

常见问题排查

1. 乱码问题

   • 检查客户端编码是否使用 UTF-8
   • 确保服务器 globalization 配置为 UTF-8
   • 避免混合使用 UrlEncode 和 UrlDecode 多次调用

2. 400 Bad Request 错误

   • 检查 IIS 是否拒绝非 ASCII 字符
   • 尝试在 web.config 中添加：

     <system.web>
       <httpRuntime requestPathInvalidCharacters="" /> 
     </system.web>

最佳实践

1. 始终在前端使用 encodeURIComponent()

   // 正确
   fetch(`/api/data?query=${encodeURIComponent("中文")}`)

2. 避免在路径中使用中文

   - /产品/详情/手机   (不推荐)
   + /product/detail?id=手机 (推荐用参数)

3. 统一编码标准

   

   • 全站强制使用 UTF-8
   • 数据库、HTML Meta、HTTP Headers 保持编码一致

补充说明

• HttpUtility.UrlEncode vs Uri.EscapeDataString

  // 更严格的 RFC 3986 标准
  string encoded = Uri.EscapeDataString("中文"); 

• ASP.NET Core 注意
  默认已支持 Unicode，无需特殊配置：

  // 直接获取即可
  var value = HttpContext.Request.Query["key"].ToString();

通过以上步骤,可彻底解决 ASP.NET 中 URL 中文参数的乱码和访问错误问题，重点在于 客户端正确编码 + 服务端统一 UTF-8 环境。