400 Bad Request - 解压缩失败的 Request

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

问题

客户端应用收到 HTTP 状态代码 400 Bad Request（错误代码为 messaging.adaptors.http.flow.DecompressionFailureAtRequest ），以此响应 API 调用。

出错提示

客户端应用获取以下响应代码：

HTTP/1.1 400 Bad Request

此外，您可能会看到类似如下所示的错误消息：

{
   "fault":{
      "faultstring":"Decompression failure at request",
      "detail":{
         "errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtRequest"
      }
   }
}

可能的原因

仅在以下情况下，会发生此错误：

• HTTP 请求标头 Content-Encoding 中指定的编码有效且 受 Apigee Edge 支持，

但是

• 客户端作为 HTTP 请求的一部分发送的载荷格式与 Content-Encoding 标头中指定的编码格式不匹配

这是因为 Apigee Edge 无法使用指定的编码对载荷进行解码，因为载荷的格式与 Content-Encoding 标头中指定的编码格式不一致。

以下是一些受支持的 Content-Encoding 值示例，以及 Apigee Edge 在这些情况下对载荷格式的要求：

造成此错误的可能原因如下：

常见诊断步骤

您可以使用以下工具/方法来诊断此错误：

原因：请求载荷格式与 Content-Encoding 标头中指定的编码不匹配

默认情况下，如果请求标头 Content-Encoding 包含有效且受支持的编码，Apigee Edge 会始终解压缩载荷。因此，请求载荷的格式应与请求标头 Content-Encoding 中指定的编码相匹配。 如果存在不匹配，您会收到此错误。

诊断

1. 使用 API 监控、Trace 工具或 NGINX 访问日志（如常见诊断步骤中所述）确定所观测到的错误的故障代码和故障来源。
2. 如果故障代码为 messaging.adaptors.http.flow.DecompressionFailureAtRequest，且故障来源的值为 policy 或 proxy，则表示客户端应用发送的请求具有与请求标头 Content-Encoding 中指定的 支持的编码不匹配的载荷。

3. 您可以使用以下任一方法在 HTTP 请求中确定不匹配情况：

   出错提示

   使用错误消息进行验证：

   1. 如果您有权访问从 Apigee Edge 收到的完整错误消息，请参阅 faultstring。

      示例错误消息：

      "faultstring":"Decompression failure at request"

   2. 在上述错误消息中，系统显示了 "Decompression failure at request"，这表示无法使用 Content-Encoding 标头中指定的编码来解压缩请求。

   跟踪记录

   如需使用 Trace 进行验证，请执行以下操作：

   1. 使用 Trace 确定请求标头 Content-Encoding 和属性 error.cause 的值，如常见诊断步骤中所述。

   2. 示例轨迹中的值如下所示：

      • Content-Encoding： gzip
      • error.cause:： Not in GZIP format

      请求标头 Content-Encoding 中的值为 gzip；但是，请求载荷不是 GZIP 格式（如 error.cause 所示）。因此，Apigee Edge 会返回 400 Bad Request 和错误代码 messaging.adaptors.http.flow.DecompressionFailureAtRequest。

   实际请求

   如需使用实际请求进行验证，请执行以下操作：

   如果您有权访问客户端应用发出的实际请求，请执行以下步骤：

   1. 确定传递给请求标头 Content-Encoding 的值。
   2. 确定作为请求的一部分发送的载荷的格式。

   3. 如果 Content-Encoding 标头的值在 支持的编码列表中，但请求载荷的格式与 Content-Encoding 标头中指定的编码不匹配，则这是问题的原因。

      示例请求：

      curl -v "http://HOSTALIAS/v1/testgzip" -H "Content-Encoding: gzip" -X POST -d @request_payload.zip
      

      上述示例请求将值 gzip 发送到 Content-Encoding 标头，该标头是 Apigee Edge 中 支持的编码。不过，请求载荷 request_payload.zip 采用 ZIP 格式。因此，此请求失败，并返回 400 Bad Request 状态代码和错误代码：messaging.adaptors.http.flow.DecompressionFailureAtRequest。

   消息处理器日志

   如需使用消息处理器日志进行验证，请执行以下操作：

   如果您是私有云用户，则可以使用消息处理器日志来确定有关 HTTP 400 错误的关键信息。

   1. 使用 API 监控、Trace 工具或 NGINX 访问日志确定失败请求的消息 ID，如常见诊断步骤中所述。

   2. 在消息处理器日志中搜索消息 ID：

      /opt/apigee/var/log/edge-message-processor/logs/system.log

   3. 您会看到以下某一种异常：

      情景 #1

      情形 1：当 API 请求具有标头 Content-Encoding: gzip 时

      2021-07-28 10:21:16,861  NIOThread@0 ERROR HTTP.SERVER -
      HTTPServer$Context.onInputException() : Message id:rt-57-1
      SSLClientChannel[Accepted: Remote:192.168.199.8:8443
      Local:192.168.80.234:44284]@28469 useCount=1 bytesRead=0
      bytesWritten=28764 age=2739893ms  lastIO=0ms
      isOpen=true.onExceptionRead exception: {}
      java.util.zip.ZipException: Not in GZIP format
      
      2021-07-28 10:21:16,862  NIOThread@0 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() : Request:POST, uri:/test,
      message Id:rt-57-1, exception:java.util.zip.ZipException: Not in GZIP format,
      context:Context@71ea5ac input=ClientInputChannel(SSLClientChannel[Accepted:
      Remote:192.168.199.8:8443 Local:192.168.80.234:44284]@28469 useCount=1
      bytesRead=0 bytesWritten=28764 age=2739894ms  lastIO=0ms  isOpen=true)
      2021-07-28 10:21:16,862  NIOThread@0 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() :
      Exception java.util.zip.ZipException: Not in GZIP format occurred while writing
      to channel null
      2021-07-28 10:21:16,863  NIOThread@0 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception trace:
      java.util.zip.ZipException: Not in GZIP format
      

      上述错误消息中的 java.util.zip.ZipException: Not in GZIP format 行表明，虽然 Content-Encoding 指定为 gzip，但请求载荷并未以 GZIP 格式发送。因此，Apigee Edge 会抛出异常，并向客户端应用返回 400 状态代码和故障代码 messaging.adaptors.http.flow.DecompressionFailureAtRequest。

      情景 #2

      情形 2：当 API 请求具有标头 Content-Encoding: deflate 时

      2021-07-28 15:26:31,893  NIOThread@1 ERROR HTTP.SERVER -
      HTTPServer$Context.onInputException() : Message id:rt-47875-1
      SSLClientChannel[Accepted: Remote:192.168.199.8:8443
      Local:192.168.81.72:45954]@29276 useCount=1 bytesRead=0
      bytesWritten=37230 age=3498856ms  lastIO=1ms
      isOpen=true.onExceptionRead exception: {}
      java.util.zip.ZipException: incorrect header check
                        ….
      Caused by: java.util.zip.DataFormatException: incorrect header check
             ..
      2021-07-28 15:26:31,894  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() : Request:POST, uri:/test,
      message Id:rrt-47875-1, exception:java.util.zip.ZipException:
      incorrect header check, context:Context@69b3ac45
      input=ClientInputChannel(SSLClientChannel[Accepted:
      Remote:192.168.199.8:8443 Local:192.168.81.72:45954]@29276
      useCount=1 byt	esRead=0 bytesWritten=37230 age=3498856ms
      lastIO=1ms  isOpen=true)
      

      上述错误消息中的 java.util.zip.ZipException: incorrect header check 和 Caused by: java.util.zip.DataFormatException: incorrect header check 行表示请求载荷未以 deflate 格式发送，并且与 deflate 的 Content-Encoding 标头中指定的编码不匹配。因此，Apigee Edge 会抛出异常，并向客户端应用返回 400 状态代码和故障代码 messaging.adaptors.http.flow.DecompressionFailureAtRequest。

分辨率

1. 如果 Apigee Edge 中的 API 代理流程和后端服务器不需要压缩的请求载荷，则不要传递标头 Content-Encoding。如果需要压缩请求载荷，请前往第 2 步。
2. 确保客户端应用始终发送以下内容：
   • 将任何 支持的编码作为请求中 Content-Encoding 标头的值
   • 发送到 Apigee Edge 的请求载荷采用受支持的格式，并且与 Content-Encoding 标头中指定的编码格式相匹配
3. 在上述示例中，请求载荷采用 ZIP 格式，但请求标头指定了 Content-Encoding: gzip。您可以通过以下方式解决此问题：将请求标头作为 Content-Encoding: gzip 发送，并将请求载荷也采用 gzip 格式：

   curl -v "https://HOSTALIAS/v1/testgzip" -H "Content-Encoding: gzip" -X POST -d @request_payload.gz
   

规范

根据以下 RFC 规范，Apigee Edge 会返回状态代码 400 Bad Request 和错误代码 messaging.adaptors.http.flow.DecompressionFailureAtRequest：

如果您仍然需要 Apigee 支持团队的任何帮助，请参阅 必须收集诊断信息。

必须收集的诊断信息

收集以下诊断信息，然后与 Apigee Edge 支持团队联系：

如果您是公共云用户，请提供以下信息：

• 组织名称
• 环境名称
• API 代理名称
• 用于重现 400 错误的完整 curl 命令
• API 请求的轨迹文件

如果您是私有云用户，请提供以下信息：

• 失败请求的完整错误消息
• 环境名称
• API 代理软件包
• API 请求的轨迹文件

• NGINX 访问日志 /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  其中： ORG、ENV 和 PORT# 会替换为实际值。

• 消息处理器系统日志 /opt/apigee/var/log/edge-message-processor/logs/system.log