Delphi RAD Studio 10.3 TRESTClient添加请求头阻止值URL编码的解决方法
Delphi REST客户端HTTP头值自动URL编码的解决方法
核心原因
RAD Studio 10.3内置的TRESTRequest/TRESTClient组件默认对所有通过Params集合添加的参数执行自动URL编码,该逻辑不区分参数是路径参数、查询参数还是HTTP头参数,会导致包含/、+、=这类Base64特殊字符的签名字段被转义,最终和服务端预期的原始签名值不匹配。
优先尝试的配置方法
在添加头参数时,直接修改参数的选项标记,关闭自动编码逻辑:
- 调用
AddHeader方法获取返回的参数实例 - 移除默认的编码标记
poEncode,追加不自动编码的标记poDoNotEncode
示例代码:
var LSignatureParam: TRESTRequestParameter; begin LSignatureParam := RESTRequest1.Params.AddHeader('SIGNATURE', FSignature); // 关闭参数的自动URL编码,保留原始值 LSignatureParam.Options := LSignatureParam.Options - [poEncode] + [poDoNotEncode]; end;
说明:poDoNotEncode为组件内置的控制标记,对所有类型的参数生效,并非仅作用于查询/路径参数。只要添加该标记,组件在拼接原始HTTP报文时就会跳过值的转义流程,直接原样输出头值。
兜底适配方案(应对10.3早期版本Bug)
10.3 Release 1版本曾存在poDoNotEncode对HTTP头参数不生效的已知问题,这种情况下可直接绕过REST组件的上层参数处理逻辑,在请求执行前操作底层Indy HTTP组件的自定义头集合:
- 为
TRESTClient绑定OnBeforeExecute事件 - 在事件中先删除组件自动生成的、经过编码的SIGNATURE头
- 直接将原始未编码的签名字符串添加到底层HTTP组件的自定义头列表
示例代码:
procedure TMainForm.RESTClient1BeforeExecute(Sender: TObject; ARequest: TIdHTTPRequest); begin ARequest.CustomHeaders.Remove('SIGNATURE'); // 直接写入原始未编码的签名值,完全绕过上层编码逻辑 ARequest.CustomHeaders.Add('SIGNATURE: ' + FSignature); end;
该方法生成的原始报文与可正常运行的C#类库发出的报文完全一致,不会对值做任何转义处理。
验证方式
调整完成后再次用Wireshark捕获请求报文,可看到SIGNATURE头的值为原始Base64字符串:
SIGNATURE: 8A1BgACL9kB6P/kXuPdm99s05whfkrOUnEziEtU+0OY=
不存在%2F、%2B、%3D这类转义字符,即可正常通过服务端的HMAC签名校验。
内容的提问来源于stack exchange,提问作者MiGz
相关产品推荐
相关产品推荐

