Go-Resty路径参数编码问题分析与修复

在HTTP客户端库Go-Resty的最新版本v2.10.0-rc.1中，开发者发现了一个影响路径参数处理的严重问题。当使用SetPathParam方法设置路径参数并发送请求时，原本应该被替换的占位符未被正确解析，导致最终URL中出现编码后的占位符文本。

问题现象

通过以下典型用例可以清晰重现该问题：

c.SetBaseURL("https://example.com/prefix")
r.SetPathParam("first", "1").
  SetPathParam("second", "2")
r.Get("{first}/{second}")

预期行为是生成请求URL：https://example.com/prefix/1/2 但实际输出却是：https://example.com/prefix/%7Bfirst%7D/%7Bsecond%7D

这里的%7B和%7D分别是字符{和}的URL编码形式，表明路径参数占位符未被正确替换。

技术分析

这个问题本质上属于URI模板处理机制的缺陷。在HTTP客户端库中，路径参数替换通常发生在以下环节：

1. 用户设置路径参数键值对
2. 库内部维护参数映射表
3. 在构建最终请求时进行模板替换
4. 对生成的完整URL进行编码处理

在v2.10.0-rc.1版本中，替换步骤可能发生在URL编码之后，或者替换逻辑被意外绕过，导致占位符直接进入编码阶段。这种执行顺序的错误使得参数替换功能完全失效。

影响范围

该缺陷会影响所有使用以下特性的场景：

• 使用花括号{}作为占位符的路径参数
• 同时设置基础URL和路径参数的请求
• 任何包含动态路径的RESTful API调用

解决方案

修复方案需要确保：

1. 路径参数替换优先于URL编码执行
2. 替换过程正确处理各种边界情况
3. 保持与历史版本的兼容性

核心修复逻辑应聚焦于请求构建器(request builder)的路径处理模块，确保模板替换在正确的处理阶段执行。同时需要添加完善的测试用例，覆盖单参数、多参数、特殊字符参数等各种场景。

最佳实践建议

开发者在使用路径参数时应注意：

1. 明确区分路径参数和查询参数的使用场景
2. 对动态参数值进行必要的验证和清理
3. 在升级HTTP客户端库时，特别注意路径处理相关的变更说明
4. 对于关键业务接口，建议添加针对URL生成的单元测试

该问题的及时修复体现了开源社区对代码质量的重视，也提醒我们在使用模板化URL时需要关注底层库的具体实现机制。