为何需对含特殊字符的REST路径参数进行两次编码？

为什么一次编码会失败？ #

当你仅执行一次encodeURIComponent（比如仅在Service层），生成的%2F会被浏览器或HTTP服务器自动解码为/。服务器最终收到的请求路径会变成/products/test/——这相当于把test识别成products下的子资源路径，而非完整的路径变量test/，因此服务器找不到对应资源，返回400错误。

两次编码为什么能生效？ #

第一次编码将原始的/转换为%2F，第二次编码把%2F中的%转换为%25，最终得到test%252F。浏览器发送请求时，会自动将%25解码回%，所以服务器收到的路径是/products/test%2F。此时服务器可以正确识别这是一个完整的路径变量，再解码一次就能得到原始的test/，从而返回正确数据。

更合理的解决方案 #

重复编码虽能解决问题，但不够直观，推荐两种更规范的处理方式：

1. 单次编码 + 服务器端适配 #

只在Controller层做一次编码，Service层直接拼接路径：

// ProductController.js
loadProduct = function() {
  const encodedName = encodeURIComponent(this.selectedProduct);
  this.productService.getProduct(encodedName).then(/* ... */);
}

// productService.js
getProduct: function(productName) {
  let fullPath = "products/" + productName;
  return $http.get(fullPath);
}

注意：部分服务器框架默认会自动解码路径中的%2F，需要在服务器端配置允许将编码后的斜杠视为路径变量的一部分（比如Spring Boot需设置spring.mvc.pathmatch.matching-strategy=ant_path_matcher并开启允许编码斜杠的配置）。

2. 使用查询参数传递产品名称 #

查询参数的编码规则与路径不同，%2F不会被自动解码为/，仅需一次编码即可：

// productService.js
getProduct: function(productName) {
  return $http.get("products", {
    params: {
      name: encodeURIComponent(productName)
    }
  });
}

请求会变为GET /products?name=test%2F，服务器可直接从查询参数中获取name并解码得到test/，这种方式通用性更强，无需调整服务器路径解码规则。

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