Delphi 11中TRestRequest/TRestClient Unicode编码映射错误求助

1. 确认响应的实际编码 #

先在Postman里查看响应的Content-Type头部，明确服务器返回的编码格式（比如是否是UTF-8、GBK或其他）。TRestClient有时会错误识别响应编码，导致用不匹配的编码解析内容，触发字符映射错误。

2. 强制指定编码读取响应 #

绕开自动编码检测逻辑，直接用确认的编码解析响应字节：

var
  LTargetEncoding: TEncoding;
  LResponseContent: string;
begin
  // 假设服务器返回UTF-8编码，直接指定
  LTargetEncoding := TEncoding.UTF8;
  // 通过字节数组直接转换，避免自动编码推断问题
  LResponseContent := LTargetEncoding.GetString(FClient.HTTPClient.Response.ContentBytes);
end;

3. 检查FallbackCharsetEncoding的设置时机 #

确保这个配置是在发送请求前设置的，请求完成后再设置不会生效：

// 先配置编码，再执行请求
FClient.HTTPClient.FallbackCharsetEncoding := TEncoding.UTF8;
FRequest.Execute;
// 之后读取响应内容

4. 排查响应中的无效字符 #

部分服务器返回的JSON可能包含超出目标编码范围的异常字符，Postman会自动兼容，但Delphi的编码转换会严格校验。可以先把响应字节转成十六进制排查：

var
  LResponseBytes: TBytes;
  LHexStr: string;
begin
  LResponseBytes := FClient.HTTPClient.Response.ContentBytes;
  LHexStr := BytesToHex(LResponseBytes);
  // 查看十六进制字符串，确认是否存在不符合UTF-8规范的字节序列
end;

如果发现无效字节，可先清理后再解析。

5. 调整HTTPClient的编码检测设置 #

尝试关闭自动编码检测，强制使用指定编码：

FClient.HTTPClient.AutoDetectEncoding := False;
FClient.HTTPClient.FallbackCharsetEncoding := TEncoding.UTF8;

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