You need to enable JavaScript to run this app. Delphi RAD Studio 10.3 TRESTClient添加请求头阻止值URL编码的解决方法
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.24 16:06:04