如何移除AWS API Gateway集成响应添加的转义字符\"

问题详情 #

我使用Velocity模板配置响应头：

#set($context.responseOverride.header.A = 'ab "cd"')

在Postman中，响应头A的实际显示值为"ab \"cd\""，但期望的显示值是ab "cd"。类似地，响应头Link当前显示为"<https://example.com?offset=0&limit=0>; rel=\"next\""，希望能显示为<https://example.com?offset=0&limit=0>; rel="next"。

解决方案 #

1. 调整Velocity模板中的字符串转义方式 #

问题根源在于Velocity中的转义字符与服务器/网关的响应头自动编码发生冲突。你在模板中使用"手动转义引号，导致后续处理时被再次包裹和转义。

修改模板为直接使用未转义的引号（Velocity中双引号字符串内的引号需要用反斜杠转义）：

#set($context.responseOverride.header.A = "ab \"cd\"")

或者使用单引号包裹原始字符串（Velocity中单引号字符串不会解析内部转义，直接保留原始内容）：

#set($context.responseOverride.header.A = 'ab "cd"')

2. 排查后端/网关的响应头自动处理逻辑 #

部分后端框架或API网关会对包含特殊字符的响应头值自动进行引号包裹和转义。需要检查是否有中间件或配置在处理响应头时额外执行了编码操作。

如果存在这类自动处理，可通过以下方式解决：

• 关闭响应头的自动引号包裹配置
• 调整模板中的值，使其匹配最终期望的输出格式（即不需要提前转义特殊字符）

3. 验证原始响应头内容 #

使用curl等工具直接请求接口，查看原始响应头，确认问题出在服务器发送环节还是Postman显示环节：

curl -I https://your-api-endpoint.com

如果curl返回的响应头值是正确的，说明是Postman的显示设置问题；如果curl也返回错误值，则需要聚焦后端的响应头处理逻辑。

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