运行时错误目录

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息

Apigee Edge 中的错误

通过 Apigee Edge 发出 API 请求时，Apigee Edge 组件路由器和消息处理器，或者后端服务器可能会将错误返回给客户端应用。

消息处理器中的错误

消息处理器是 Apigee Edge 的核心组件，用于处理政策并与后端服务器进行交互。如果它检测到任何问题，就会返回错误，例如：

  • 网络连接问题、TLS 握手失败、后端服务器不可用、与后端服务器通信期间无响应
  • 政策执行期间失败
  • HTTP 标头/编码/路径无效、不遵循 HTTP 规范、超出产品限制等：
    • 由客户端应用发送的 HTTP 请求

      • 或

    • 由后端服务器发送的 HTTP 响应
  • 其他

消息处理器中的错误示例

消息处理器始终返回 HTTP 状态代码，后跟错误消息以及 JSON 格式的错误代码，如下所示：

客户端应用获取如下所示的响应代码：

HTTP/1.1 414 Request-URI Too Long

消息处理器的错误响应采用以下格式：

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

错误响应中的字段说明：

字段 说明
faultstring 包含描述错误消息可能原因的错误消息
errorcode 与错误关联的错误代码（也称为故障代码）

运行时错误目录

此错误目录提供了您需要了解的有关 Apigee Edge Message Processor 组件返回的运行时错误代码（适用于非政策错误）的所有信息。对于每个错误代码，它包含以下信息：

  • HTTP 状态代码
  • 错误消息
  • 错误的可能原因
  • 任何相关的 HTTP 规范和/或产品限制
  • 手册和视频，其中包含诊断错误原因的说明以及可用于自行解决错误的有效解决方案（如果有）
  • 可以用来自行解决错误的修复

涵盖以下错误代码类别：

使用下面的搜索框过滤表格，以显示特定错误代码的上述信息。您可以搜索状态代码或表内任意字段中的任何内容。

错误代码 说明 修复

flow.*

flow.APITimedOut
  • HTTP 状态代码：
 504 Gateway Timeout
  • 错误消息：
 API timed out
  • 可能的原因：

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

  • 后端服务器在特定 API 代理的属性 api.timeout 配置的超时期限内不会做出响应。
  • 由于计算密集型操作、高负载或性能不佳，政策需要很长时间。

注意：本 playbook 提供了有关如何排查错误代码 messaging.adaptors.http.flow.GatewayTimeout 的问题；不过，您可以使用相同的 playbook 对 flow.APITimedOut 错误代码进行问题排查。

使用指南

flow.SharedFlowNotFound
  • HTTP 状态代码：
 500 Internal Server Error
  • 错误消息：
 Shared Flow {shared_flow_name} Not Found
  • 可能的原因：

如果特定的共享流存在以下情况，则会出现此错误：

  • 不存在

    • OR

  • 已存在，但未部署
使用指南

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • HTTP 状态代码：
 404 Not Found
  • 错误消息：
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • 可能的原因：

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

  1. 具体的 API 代理为：
    1. 未配置为接受特定虚拟主机上的请求
    2. 未配置为接受请求中所用的特定路径上的请求
    3. 未部署在您尝试发出 API 请求的特定环境中
    4. 未部署在一个或多个消息处理器上
  2. 一个或多个消息处理器未加载您尝试发出 API 请求的特定环境
 使用指南
如果多个虚拟主机具有相同的主机别名和端口号，也可能会发生此错误。 使用指南

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • HTTP 状态代码：
 400 Bad Request
  • 错误消息：
 Decompression failure at request
  • 可能的原因：

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

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

    • 但是

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

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • HTTP 状态代码：
 502 Bad Gateway
  • 错误消息：
 Decompression failure at response
  • 可能的原因：

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

  • 后端/目标服务器的 HTTP 响应标头 Content-Encoding 中指定的编码有效且 Apigee Edge 支持，

    • 但是

  • 后端/目标服务器在 HTTP 响应中发送的载荷格式与 Content-Encoding 标头中指定的编码格式不匹配
使用指南

messaging.adaptors.http.flow.ErrorResponseCode
  • HTTP 状态代码：
 500

使用指南

视频

  • 错误消息：
 错误消息和格式可能因后端服务器实现而异。
  • 可能的原因：
 如果后端服务器向 Apigee Edge 响应状态代码 500，就会出现此错误。
  • HTTP 状态代码：
 503

使用指南

视频

  • 错误消息：
 错误消息和格式可能因后端服务器实现而异。
  • 可能的原因：
 如果后端服务器向 Apigee Edge 响应状态代码 503，就会出现此错误。
  • HTTP 状态代码：
 504 使用指南
  • 错误消息：
 错误消息和格式可能因后端服务器实现而异。
  • 可能的原因：
 如果后端服务器向 Apigee Edge 响应状态代码 504，就会出现此错误。

注意：在发送到客户端应用的错误消息中，系统不会返回错误代码 messaging.adaptors.http.flow.ErrorResponseCode。这是因为每当后端服务器做出错误响应以及任何 4XX 或 5XX 状态代码时，Apigee Edge 都会设置此错误代码。您可以在 API Monitoring、NGINX 访问日志或分析数据库中查看此错误代码。

messaging.adaptors.http.flow.GatewayTimeout
  • HTTP 状态代码：
 504 Gateway Timeout
  • 错误消息：
 Gateway Timeout
  • 可能的原因：
 如果后端服务器在消息处理器上配置的 I/O 超时期限内没有响应 Apigee Edge Message Processor，就会发生此错误。
使用指南

messaging.adaptors.http.flow.LengthRequired
  • HTTP 状态代码：
 411 Length Required
  • 错误消息：
 'Content-Length' is missing
  • 可能的原因：

如果客户端应用未在发送到 Apigee Edge 的 HTTP POST 和 PUT 请求中传递 Content-Length 标头，则会出现此错误。

注意：无法在跟踪工具中捕获因此错误而失败的请求，因为消息处理器在非常早的阶段（远早于处理请求并在 API 代理中执行任何政策之前）执行此验证。
  • HTTP 规范：
 RFC 第 3.3.2 节：内容长度

修复

要解决此错误，请执行以下步骤：

  1. 确保客户端应用始终在发送到 Apigee Edge 的 HTTP POST 和 PUT 请求中传递标头 Content-Length。例如：

    curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"

  2. 即使您使用 POST 和 PUT 请求传递空载荷，请确保传递标头 Content-Length: 0。例如：

    curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"

messaging.adaptors.http.flow.NoActiveTargets
  • HTTP 状态代码：
 503 Service Unavailable
  • 错误消息：
 The Service is temporarily unavailable
  • 可能的原因：

如果您在 Apigee Edge 中使用 TargetServer，如果出现以下任何一种情况，则会出现此错误：

  1. 自定义授权服务器对后端服务器主机的 DNS 解析不正确，导致 IP 地址错误，进而导致连接错误。
  2. 连接超时错误原因如下：
    1. 后端服务器的防火墙限制会阻止 Apigee Edge 连接到后端服务器。
    2. Apigee Edge 与后端服务器之间的网络连接问题。
  3. TargetServer 中指定的主机不正确或包含不需要的字符（例如空格）。

使用指南

视频
如果配置为监控目标服务器的健康检查的健康检查失败，也可能会发生此错误。

使用指南

视频

messaging.adaptors.http.flow.RequestTimeOut
  • HTTP 状态代码：
 408 Request Timeout
  • 错误消息：
 Request timed out
  • 可能的原因：
 如果 Apigee Edge Message Processor 在消息处理器组件上配置的 I/O 超时期限内，未收到客户端应用发送的请求载荷，就会出现此错误。

修复

确保客户端应用在 Apigee Edge 的消息处理器组件上配置的 I/O 超时期限内发送请求载荷。

messaging.adaptors.http.flow.ServiceUnavailable
  • HTTP 状态代码：
 503 Service Unavailable
  • 错误消息：
 The Service is temporarily unavailable
  • 可能的原因：

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

  1. 自定义授权服务器对后端服务器主机的 DNS 解析不正确，导致 IP 地址错误，进而导致连接错误。
  2. 连接超时错误原因如下：
    1. 后端服务器的防火墙限制会阻止 Apigee Edge 连接到后端服务器。
    2. Apigee Edge 与后端服务器之间的网络连接问题。
  3. 目标端点中指定的目标服务器主机不正确或包含不需要的字符（例如空格）。

使用指南

DNS 故障：

视频

网络连接：

视频
如果后端服务器在请求处理器仍在向后端服务器发送请求载荷时过早关闭连接，也可能会出现此错误。 使用指南

messaging.adaptors.http.flow.SslHandshakeFailed
  • HTTP 状态代码：
 503 Service Unavailable
  • 错误消息：
 SSL Handshake failed {error_message}
  • 可能的原因：

如果出现以下情况，则在 Apigee Edge 的消息处理器和后端服务器之间的 SSL 握手过程中会出现此错误：

  1. Apigee Edge 消息处理器的信任库：
    • 包含与后端服务器的完整证书链不匹配的证书链

      • 或

    • 不包含后端服务器的完整证书链
  2. 后端服务器提供的证书链：
    • 包含与目标端点中指定的主机名不匹配的完全限定域名 (FQDN)

      • 或

    • 包含的证书链不正确/不完整

使用指南

视频

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • HTTP 状态代码：
 502 Bad Gateway
  • 错误消息：
 Unexpected EOF at target
  • 可能的原因：

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

  1. TargetServer 未正确配置为在 Apigee Edge 中支持 TLS/SSL 连接。
  2. 在 Apigee Edge 等待后端服务器响应时，后端服务器可能会突然关闭连接。
  3. Apigee 和后端服务器上的 keep-alive 超时配置不正确。
使用指南

messaging.runtime.*

messaging.runtime.RouteFailed
  • HTTP 状态代码：
 500 Internal Server Error
  • 错误消息：
 Unable to route the message to a TargetEndpoint
  • 可能的原因：

如果 Apigee Edge 无法将请求路由到任何 TargetEndpoint，则会出现此错误：

  • 代理中没有与请求匹配的路由规则 (<RouteRule>) 条件

    • 且

  • ProxyEndpoint 中没有定义默认路由规则（即没有任何条件的 <RouteRule>）

修复

要解决此错误，请按照以下说明操作：

  1. 查看 ProxyEndpoint 中定义的路由规则并进行修改，以确保至少有一个路由规则条件与您的请求相匹配。
  2. 如果存在多个 RouteRule，则建议您定义一个不带任何条件的默认路由规则。
  3. 确保默认路由规则始终在条件路由列表中最后定义，因为规则是在 ProxyEndpoint 中自上而下进行评估的。

如需详细了解如何在 ProxyEndpoint 中定义 <RouteRule> 条件，请参阅条件目标。

messaging.runtime.SenseRaiseFault
  • HTTP 状态代码：
 403 Forbidden
  • 错误消息：
 Sense Fault
  • 可能的原因：
 如果 API 请求来自特定客户端 IP 地址，而该 IP 地址在 Apigee Sense 规则中被屏蔽，则会出现此错误。

修复

要解决此错误，请按照以下说明操作：

  1. 检查 Apigee Sense 中配置的规则，确认您是否已阻止特定的客户端 IP 地址。如果被屏蔽，则表示其按预期运行。
  2. 如果未阻止特定的客户端 IP 地址，但您仍收到此错误，请与 Apigee Edge 支持团队联系。

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • HTTP 状态代码：
 500 Internal Server Error
  • 错误消息：
 Bad Form Data
  • 可能的原因：

当且仅当满足以下所有条件时，会出现此错误：

  1. 客户端发送给 Apigee Edge 的 HTTP 请求包含：
    • Content-Type: application/x-www-form-urlencoded 和
    • 带有百分号 (%) 或百分号 (%) 后跟无效的十六进制字符的表单数据，这些字符根据表单 - 第 17.13.4.1 节是不允许的。
  2. Apigee Edge 中的 API 代理会读取特定表单参数，其中包含使用请求流中的 ExtractVariables 或 AllocationMessage 政策不允许使用的任何字符。
使用指南

protocol.http.DuplicateHeader
  • HTTP 状态代码：
 400 Bad Request
  • 错误消息：
 Duplicate Header "{header_name}"
  • 可能的原因：
 如果在客户端应用向 Apigee Edge 发送的 HTTP 请求中多次出现具有相同或不同值的 HTTP 标头，则会出现此错误。
  • HTTP 规范：
 RFC 7230 第 3.2.2 节：字段顺序
使用指南

protocol.http.EmptyHeaderName
  • HTTP 状态代码：
 400 Bad Request
  • 错误消息：
 Header name cannot be empty
  • 可能的原因：
 如果客户端应用作为 HTTP 请求的一部分发送到 Apigee Edge 的标头名称为空，则会出现此错误。
  • HTTP 规范：
 RFC 7230 第 3.2 节：标头字段

修复

确保客户端应用向 Apigee Edge 发送的 HTTP 请求始终包含符合 RFC 7230 第 3.2 节：标头字段的有效标头名称。

protocol.http.HeaderNameWithNonAsciiChar
  • HTTP 状态代码：
 400 Bad Request
  • 错误消息：
 Header {header_name} contains non ascii character {character}
  • 可能的原因：
 如果客户端应用作为 HTTP 请求的一部分发送到 Apigee Edge 的标头名称包含非 ASCII 字符，则会出现此错误。
  • HTTP 规范：

“RFC 7230 第 3.2 节：标头字段”和“RFC 7230 第 3.2.6 节：字段值组成部分”

修复

根据 RFC 7230 第 3.2.6 节：字段值组件，确保发送到 Apigee Edge 的客户端 HTTP 请求在标头名称中不包含非 ASCII 字符。

protocol.http.HeaderWithInvalidChar
  • HTTP 状态代码：
 400 Bad Request
  • 错误消息：
 Header {header_name} contains invalid character {character}
  • 可能的原因：
 如果客户端应用作为 HTTP 请求的一部分发送到 Apigee Edge 的标头名称包含无效字符，例如等于 (=)、英文逗号 (,)、分号 (;)、制表符、CRLF 和换行符。
  • HTTP 规范：

“RFC 7230 第 3.2 节：标头字段”和“RFC 7230 第 3.2.6 节：字段值组成部分”

修复

根据 RFC 7230 第 3.2.6 节：字段值组件，确保客户端应用向 Apigee Edge 发送的 HTTP 请求在标头名称中不包含任何无效字符

protocol.http.InvalidPath
  • HTTP 状态代码：
 400 Bad Request
  • 错误消息：
 Invalid path {path}
  • 可能的原因：
 如果客户端应用向 Apigee Edge 发送的 HTTP 请求网址中的路径包含不符合规范 RFC 3986 第 3.3 节“路径”的字符，则会出现此错误。
  • HTTP 规范：

RFC 3986 第 3 节：语法组成部分和 RFC 3986，第 3.3 节：路径

修复

确保客户端应用向 Apigee Edge 发送的 HTTP 请求网址中的路径不包含任何 RFC 3986 第 3.3 节：路径所不允许的字符。

protocol.http.TooBigBody
  • HTTP 状态代码：
 413 Request Entity Too Large
  • 错误消息：
 Body buffer overflow
  • 可能的原因：
 如果客户端应用作为 HTTP 请求的一部分发送到 Apigee Edge 的载荷大小超过 Apigee Edge 中的允许限制，则会出现此错误。
  • 此政策具有以下限制：
 Apigee Edge 限额
使用指南

protocol.http.TooBigHeaders
  • HTTP 状态代码：
 431 Request Header Fields Too Large
  • 错误消息：
 request headers size exceeding {limit}
  • 可能的原因：
 客户端应用作为 HTTP 请求的一部分发送到 Apigee Edge 的所有请求标头的总大小超过 Apigee Edge 中允许的限制。
  • HTTP 规范：
 RFC 6585 第 5 节：431 请求标头字段过大
  • 此政策具有以下限制：
 Apigee Edge 限额
使用指南

protocol.http.TooBigLine
  • HTTP 状态代码：
 414 Request-URI Too Long
  • 错误消息：
 request line size exceeding {limit}
  • 可能的原因：
 如果客户端应用在 HTTP 请求中向 Apigee Edge 发送的请求行大小超过 Apigee Edge 中的允许限制，则会出现此错误。
  • 此政策具有以下限制：
 Apigee Edge 限额
使用指南

protocol.http.UnsupportedEncoding
  • HTTP 状态代码：
 415 Unsupported Media
  • 错误消息：
 Unsupported Encoding "{encoding}"
  • 可能的原因：
 如果客户端作为 HTTP 响应的一部分发送的 Content-Encoding 标头包含 Apigee Edge 不支持的编码/载荷格式，则会出现此错误。
  • HTTP 规范：
 RFC 7231 第 6.5.13 节：415 不支持的媒体类型
使用指南

protocol.http.* - Caused by target

protocol.http.BadPath
  • HTTP 状态代码：
 500 Internal Server Error
  • 错误消息：
 Invalid request path
  • 可能的原因：
 如果后端服务器的请求网址（由流变量 target.url 表示）包含以问号 (?) 开头（而非转发斜杠 (/)）的路径（这种情况无效），就会出现此错误。
  • HTTP 规范：

RFC 3986 第 3 节：语法组成部分和 RFC 3986，第 3.3 节：路径
使用指南

protocol.http.DuplicateHeader
  • HTTP 状态代码：
 502 Bad Gateway
  • 错误消息：
 Duplicate Header "{header_name}"
  • 可能的原因：
 如果在后端服务器发送到 Apigee Edge 的 HTTP 响应中多次出现具有相同或不同值的 HTTP 标头，则会出现此错误。
  • HTTP 规范：
 RFC 7230 第 3.2.2 节：字段顺序
使用指南

protocol.http.EmptyHeaderName
  • HTTP 状态代码：
 502 Bad Gateway
  • 错误消息：
 Header name cannot be empty
  • 可能的原因：
 如果后端服务器在 HTTP 响应中向 Apigee Edge 发送的标头名称为空，则会出现此错误。
  • HTTP 规范：
 RFC 7230 第 3.2 节：标头字段

修复

确保后端服务器发送到 Apigee Edge 的 HTTP 响应始终包含符合 RFC 7230 第 3.2 节：标头字段的有效标头名称。

protocol.http.EmptyPath
  • HTTP 状态代码：
 500 Internal Server Error
  • 错误消息：
 Request path cannot be empty
  • 可能的原因：
 如果后端服务器的 HTTP 请求网址（由流变量 target.url 表示）包含空路径，则会发生此错误。
  • HTTP 规范：

RFC 3986 第 3 节：语法组成部分和 RFC 3986，第 3.3 节：路径
使用指南

protocol.http.HeaderNameWithNonAsciiChar
  • HTTP 状态代码：
 502 Bad Gateway
  • 错误消息：
 Header {header_name} contains non ascii character {character}
  • 可能的原因：
 如果后端服务器作为 HTTP 响应的一部分发送到 Apigee Edge 的标头名称包含非 ASCII 字符，则会发生此错误。
  • HTTP 规范：

“RFC 7230 第 3.2 节：标头字段”和“RFC 7230 第 3.2.6 节：字段值组成部分”

修复

根据 RFC 7230 第 3.2.6 节：字段值组件，确保后端服务器发送到 Apigee Edge 的 HTTP 响应不包含标头名称中的非 ASCII 字符。

protocol.http.HeaderWithInvalidChar
  • HTTP 状态代码：
 502 Bad Gateway
  • 错误消息：
 Header {header_name} contains invalid character {character}
  • 可能的原因：
 如果后端服务器在 HTTP 响应中发送的标头名称包含等号 (=)、英文逗号 (,)、分号 (;)、制表符、CRLF 和换行符等字符，则会出现此错误。
  • HTTP 规范：

“RFC 7230 第 3.2 节：标头字段”和“RFC 7230 第 3.2.6 节：字段值组成部分”

修复

根据 RFC 7230 第 3.2.6 节：字段值组件，确保后端服务器发送到 Apigee Edge 的 HTTP 响应在标头名称中不包含任何无效字符

protocol.http.ProxyTunnelCreationFailed
  • HTTP 状态代码：
 503 Service Unavailable
  • 错误消息：
 Proxy refused to create tunnel with response status {status code}
  • 可能的原因：

由于防火墙、ACL（访问控制列表）、DNS 问题、后端服务器的可用性等原因，代理服务器在 Apigee Edge 与后端服务器之间创建隧道时会发生此错误。

注意：错误消息 (faultstring) 中的状态代码提供了导致此问题的简要原因。
使用指南

protocol.http.Response306Reserved
  • HTTP 状态代码：
 502 Bad Gateway
  • 错误消息：
 Response Status code 306 is reserved, so can't be used.
  • 可能的原因：

如果后端服务器向 Apigee Edge 返回 306 状态代码，就会出现此错误。

306 状态代码是在旧版 HTTP 规范中定义的。根据当前的 HTTP 规范，此代码已预留，不应使用。
  • HTTP 规范：
 RFC 7231 第 6.3.5 节：预留 306

修复

由于状态代码 306 已预留，因此请确保您的后端服务器在向 Apigee Edge 发送响应时不使用此状态代码。

protocol.http.Response405WithoutAllowHeader
  • HTTP 状态代码：
 502 Bad Gateway
  • 错误消息：
 Received 405 Response without Allow Header
  • 可能的原因：
 后端服务器返回 405 Method Not Allowed 状态代码，而不使用“允许”标头。
  • HTTP 规范：

RFC 7231，第 6.5.5 节：405 不允许的方法和 RFC 7231，第 7.4.1 节：允许
使用指南

protocol.http.ResponseWithBody
  • HTTP 状态代码：
 502 Bad Gateway
  • 错误消息：
 Received {status_code} Response with message body
  • 可能的原因：

如果从后端服务器到 Apigee Edge 的 HTTP 响应为 204 No Content 或 205 Reset Content，但其中包含响应正文和/或以下一个或多个标头，则会出现此错误：

  • Content-Length
  • Content-Encoding
  • Transfer-Encoding
  • HTTP 规范：

RFC 7231 第 6.3.5 节：204 无内容和 RFC 7231 第 6.3.6 节：205 重置内容
使用指南

protocol.http.TooBigBody
  • HTTP 状态代码：
 502 Bad Gateway
  • 错误消息：
 Body buffer overflow
  • 可能的原因：
 如果客户端应用作为 HTTP 请求的一部分发送到 Apigee Edge 的载荷大小超过 Apigee Edge 中的允许限制，则会出现此错误。
  • 此政策具有以下限制：
 Apigee Edge 限额
使用指南

protocol.http.TooBigHeaders
  • HTTP 状态代码：
 502 Bad Gateway
  • 错误消息：
 response headers size exceeding {limit}
  • 可能的原因：
 如果后端服务器在向 Apigee Edge 发出的 HTTP 响应中发送的所有响应标头的总大小超过 Apigee Edge 中允许的限制，就会发生此错误。
  • 此政策具有以下限制：
 Apigee Edge 限额
使用指南

protocol.http.TooBigLine
  • HTTP 状态代码：
 502 Bad Gateway
  • 错误消息：
 response line size exceeding {limit}
  • 可能的原因：
 如果后端服务器在 HTTP 响应中向 Apigee Edge 发送的响应行大小超过 Apigee Edge 中允许的限制，就会发生此错误。
  • 此政策具有以下限制：
 Apigee Edge 限额
使用指南

protocol.http.UnsupportedEncoding
  • HTTP 状态代码：
 415 Unsupported Media
  • 错误消息：
 Unsupported Encoding "{encoding}"
  • 可能的原因：
 如果后端服务器作为 HTTP 响应的一部分发送的 Content-Encoding 标头包含 Apigee Edge 不支持的编码/载荷格式，则会出现此错误。
  • HTTP 规范：
 RFC 7231 第 6.5.13 节：415 不支持的媒体类型
使用指南

security.util.*

security.util.KeyAliasNotFound
  • HTTP 状态代码：
 500 Internal Server Error
  • 错误消息：
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • 可能的原因：

如果 TargetEndpoint 或 TargetServer 中引用的特定 KeyAlias 在特定密钥库中找不到，则会发生此错误。

修复

确保 TargetEndpoint 或 TargetServer 中指定的 KeyAlias 存在且属于特定密钥库。

security.util.TrustStoreWithNoCertificates
  • HTTP 状态代码：
 500 Internal Server Error
  • 错误消息：
 TrustStore {truststore_name} has no certificates
  • 可能的原因：

如果 TargetEndpoint 或 TargetServer 中引用的特定信任库不包含任何证书，则会发生此错误。

修复

如果您要验证后端服务器的证书，并且希望在 TargetEndpoint 或 TargetServer 中使用信任库，请确保信任库包含后端服务器的有效证书。