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

API 监控

如需使用 API 监控诊断错误，请执行以下操作：

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

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

   
3. 依次前往分析 > API 监控 > 调查 页面。
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. 确保显示所有 FlowInfo 处于启用状态：

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

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

   

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

   上面的示例跟踪记录显示错误为 Received 405 Response without Allow Header。由于该错误是在请求发送到后端 服务器后由 Apigee 引发的，因此表示后端服务器返回 405 响应状态代码 但不使用 Allow 标头。

7. 在跟踪记录中前往 AX （已记录分析数据）阶段，然后点击该阶段。

8. 在阶段详情 面板中向下滚动到错误 / 响应标头 部分，然后确定 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-source 的值。

   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 状态代码，并使用 Allow 标头：

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

   Allow: HTTP_METHODS

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

   Allow: GET, POST, HEAD

故障处理

方法 2：使用故障处理从 API 代理返回 405 状态代码，并使用 Allow 标头：

如果后端服务器返回 405 状态代码，但不使用 Allow 标头，您可以使用故障处理从 API 代理返回 405 状态代码和 Allow 标头，如下所示：

1. 创建政策（例如 AssignMessage 政策 或 RaiseFault 政策 ），并将状态代码设置为 405，并使用 Allow 标头和自定义 消息。

   使用 Allow 标头返回 405 的 AssignMessage 政策示例：

   <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，该规则会在收到错误代码为 protocol.http.Response405WithoutAllowHeader 的 502 错误时调用该政策。

   显示 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 调用，并验证您是否收到了 405 状态代码和 Allow 标头。

配置属性

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

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