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

API 监控

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

1. 使用 适当的角色。

2. 切换到您要在其中调查问题的单位。

   
3. 导航至分析 >API 监控 >调查页面。
4. 选择您观察到错误的具体时间范围。

5. 根据时间绘制错误代码。

   <ph type="x-smartling-placeholder">

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

   

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

   

8. 点击查看日志 并展开某个失败的请求以查看更多信息。

   
9. 在日志窗口中，请注意以下详细信息： <ph type="x-smartling-placeholder">
   </ph>
   • 状态代码：502
   • 故障来源：target
   • 错误代码：protocol.http.Response405WithoutAllowHeader。
10. 如果故障来源为 target 且错误代码为 protocol.http.Response405WithoutAllowHeader，则表示后端 服务器响应了 405 Method Not Allowed 状态代码，但不包含 Allow 标头。

跟踪工具

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

1. 启用 跟踪会话，以及 <ph type="x-smartling-placeholder">
   </ph>
   • 等待发生 502 Bad Gateway 错误，或者
   • 如果您可以重现问题，请进行 API 调用以重现问题。 502 Bad Gateway 个错误

2. 确保已启用 Show all FlowInfos：

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

5. 该错误通常在 Request sent to target server（发送到目标服务器）之后的流中显示。 阶段，如下所示：

   

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 指示此错误是因为后端发送了 不带 Allow 标头的 405 响应状态代码。

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

NGINX

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

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

2. 查看 NGINX 访问日志：

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

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

3. 搜索是否存在任何带有错误代码的 502 错误 protocol.http.Response405WithoutAllowHeader（如果 过去出现的问题），或者是否有任何请求仍以失败告终， 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：修复后端服务器，以发送带有“Allow”标头的 405 状态代码：

1. 确保后端服务器始终遵循规范 <ph type="x-smartling-placeholder"></ph> RFC 7231，第 6.5.5 节：405 Method Not Allowed，并以 405 状态发送 方法是在 Allow 标头中添加允许的方法列表 如下所示：

   Allow: HTTP_METHODS

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

   Allow: GET, POST, HEAD

故障处理

方法 2：使用故障处理功能，通过 API 中的“Allow”标头发送 405 状态代码 代理：

如果后端服务器返回 405 状态代码，但没有 Allow 标头，您可以使用故障处理功能使用 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，以调用政策 收到包含错误代码的 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 调用并验证您是否收到了 405 状态代码以及 Allow 标头。

配置媒体资源

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

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