502 Bad Gateway - 响应 405（不允许标头）

API 监控

要使用 API Monitoring 诊断错误，请执行以下操作：

1. 以拥有 适当角色的用户身份登录 Edge 界面。

2. 切换到您要调查问题的组织。

   
3. 前往 Analyze > API Monitoring > Investigate 页面。
4. 选择您发现错误的具体时间范围。

5. 根据时间绘制故障代码。

6. 选择具有错误代码 protocol.http.Response405WithoutAllowHeader 的单元格，如下所示：

   

7. 错误代码 protocol.http.Response405WithoutAllowHeader 的相关信息如下所示：

   

8. 点击查看日志 ，然后展开其中一个失败的请求以查看更多信息。

   
9. 在日志窗口中，请注意以下详细信息：
   • 状态代码：502
   • 错误来源：target
   • 错误代码：protocol.http.Response405WithoutAllowHeader。
10. 如果故障来源为 target 且故障代码为 protocol.http.Response405WithoutAllowHeader，则表示后端服务器返回了 405 Method Not Allowed 状态代码，但没有 Allow 标头。

跟踪工具

如需使用跟踪工具诊断错误，请执行以下操作：

1. 启用 跟踪会话，并且
   • 等待 502 Bad Gateway 错误发生，或者
   • 如果您可以重现问题，请进行 API 调用以重现问题 - 502 Bad Gateway 错误

2. 确保已启用 Show all FlowInfos：

   
3. 选择其中一个失败的请求并检查跟踪记录。
4. 浏览跟踪记录的不同阶段，并找到失败的位置。

5. 通常情况下，您会在请求发送到目标服务器阶段之后的流程中发现此错误，如下所示：

   

6. 记下跟踪记录中的错误值。

   上面的示例轨迹将错误显示为 Received 405 Response without Allow Header。由于 Apigee 在请求发送到后端服务器后会引发此错误，因此表示后端服务器发送的 405 响应状态代码没有 Allow 标头。

7. 进入跟踪记录中的 AX（已记录 Google Analytics（分析）数据）阶段，然后点击该阶段。

8. 向下滚动到 Phase Details（阶段详细信息）面板中的 Error / Response Headers（错误/响应标头）部分，并确定 X-Apigee-fault-code 和 X-Apigee-fault-source 的值，如下所示：

   
9. 您会看到 X-Apigee-fault-code 和 X-Apigee-fault-source 的值分别是 protocol.http.Response405WithoutAllowHeader 和 target，这表明导致此错误的原因在于后端发送的 405 响应状态代码没有 Allow 标头。

   响应标头	值
   X-Apigee-fault-code	protocol.http.Response405WithoutAllowHeader
   X-Apigee-fault-source	target

NGINX

如需使用 NGINX 访问日志诊断错误，请执行以下操作：

1. 如果您是 Private Cloud 用户，则可以使用 NGINX 访问日志来确定有关 HTTP 502 错误的关键信息。

2. 检查 NGINX 访问日志：

   /opt/apigee/var/log/edge-router/nginx/ORG~ORG.PORT#_access_log
   

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

3. 搜索以查看在特定持续时间内是否存在任何错误代码为 protocol.http.Response405WithoutAllowHeader 的 502 错误（如果问题发生在过去），或者是否有任何请求仍然失败并显示 502。

4. 如果您确实发现任何 502 错误，且 X-Apigee-fault-code 与 protocol.http.Response405WithoutAllowHeader 的值匹配，请确定 X-Apigee-fault-code 的值。

   NGINX 访问日志中的 502 错误示例：

   

   NGINX 访问日志中的上述示例条目具有 X-Apigee-fault-code 和 X-Apigee-fault-source 的以下值：

   响应标头	值
   X-Apigee-fault-code	protocol.http.Response405WithoutAllowHeader
   X-Apigee-fault-source	target

后端服务器

方法 1：修复后端服务器，以发送带有允许标头的 405 状态代码：

1. 确保后端服务器始终遵循 RFC 7231 第 6.5.5 节：405 不允许的方法规范，并通过在 Allow 标头中添加允许的方法列表来发送 405 状态代码，如下所示：

   Allow: HTTP_METHODS
   

2. 例如，如果您的后端服务器允许使用 GET、POST 和 HEAD 方法，则需要确保 Allow 标头包含这些方法，如下所示：

   Allow: GET, POST, HEAD
   

故障处理

方法 2：使用故障处理功能从 API 代理发送包含“Allow”标头的 405 状态代码：

如果后端服务器返回的 405 状态代码没有 Allow 标头，您可以使用故障处理功能以来自 API 代理的 405 状态代码和 Allow 标头进行响应，如下所示：

1. 创建一项政策（如 assignMessage 政策或 RaiseFault 政策），然后将状态代码设置为 405，其中包含 Allow 标头和一条自定义消息。

   发送带有“Allow”标头的 405 消息的 AssignmentMessage 政策示例：

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-405WithAllowHeader">
       <DisplayName>AM-405WithAllowHeader</DisplayName>
       <Set>
           <Payload contentType="application/json">{"Specified method is not allowed. Please use one of the methods mentioned in the Allow header."}</Payload>
           <StatusCode>405</StatusCode>
           <ReasonPhrase>Method Not Allowed</ReasonPhrase>
       </Set>
       <Add>
           <Headers>
               <Header name="Allow">GET, POST, HEAD</Header>
           </Headers>
       </Add>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>
   

2. 在 TargetEndpoint 中创建 FaultRule，它在收到 502 错误并显示错误代码 protocol.http.Response405WithoutAllowHeader 时调用政策。

   显示 FaultRule 的 TargetEndpoint 配置示例：

   <TargetEndpoint name="default">
   ...
       <FaultRules>
          <FaultRule name="405WithoutAllowHeader">
               <Step>
                   <Name>AM-405WithAllowHeader</Name>
               </Step>
               <Condition>(fault.name = "Response405WithoutAllowHeader")</Condition>
           </FaultRule>
       </FaultRules>
   

3. 将这些更改保存到 API 代理的新修订版本中，然后部署该修订版本。
4. 进行 API 调用，并验证您是否收到带有 Allow 标头的 405 状态代码。

配置媒体资源

方法 3：在消息处理器中配置属性，以防止 Apigee Edge 返回 502 错误

1. 如果您是 私有云用户，则可以将属性 HTTP.ignore.allow_header.for.405 更新为 true，以防止 Apigee Edge 引发 502 错误，即使后端服务器返回不含 Allow 标头的 405 状态代码响应也是如此，具体操作指南如下： 在消息处理器中为 405 属性配置忽略允许标头。
2. 如果您是 公有云用户 ，请联系 Apigee Edge 支持团队