第 12 章 对 API 基础架构进行故障排除

测试请求失败：执行过期

检查您的 API 是否可从公共互联网访问。APIcast Hosted 无法与私有 API 一起使用。如果您不想使 API 公开可用于与 APIcast Hosted 集成，您可以在 APIcast Hosted 和 API 之间设置一个私有 secret，以拒绝任何来自 API 网关的调用。

可接受的格式是 protocol://address(:port)

删除 API 专用基础 URL 末尾的所有路径。您可以在"映射规则"模式或 API test GET request 的开头添加它们。

使用 HTTP 代码 XXX 测试请求失败

upstream timed out (110:Connection timed out) while connecting to upstream

检查 API 网关和公共 Internet 之间没有防火墙或代理，从而妨碍您自我管理的网关到达 3scale。

failed to get list of services: invalid status:403 (Forbidden)

  2018/06/04 08:04:49 [emerg] 14#14: [lua] configuration_loader.lua:134: init(): failed to load configuration,   exiting (code 1)
  2018/06/04 08:04:49 [warn] 22#22: *2 [lua] remote_v2.lua:163: call(): failed to get list of services:   invalid status: 403 (Forbidden) url: https://example-admin.3scale.net/admin/api/services.json , context:   ngx.timer
  ERROR: /opt/app-root/src/src/apicast/configuration_loader.lua:57: missing configuration

检查您在 THREESCALE_PORTAL_ENDOINT 值中使用的访问令牌是否正确，以及帐户管理 API 范围。使用 curl 命令验证它： curl -v "https://example-admin.3scale.net/admin/api/services.json?access_token=<YOUR_ACCESS_TOKEN>"

它应当通过 JSON 正文返回 200 响应。如果返回错误状态代码，请检查响应正文以了解详细信息。

主机 apicast.example.com 没有找到服务

  2018/06/04 11:06:15 [warn] 23#23: *495 [lua] find_service.lua:24: find_service(): service not found for host apicast.example.com, client: 172.17.0.1, server: _, request: "GET / HTTP/1.1", host: "apicast.example.com"

此错误表示公共基本 URL 尚未正确配置。您应该确保配置的 Public Base URL 与用于自助管理的 APIcast 请求的相同。配置正确的公共基本 URL 后：

您解析了不再使用的旧 3scale IP。

最新版本的 API 网关配置文件将 3scale 定义为每次强制 IP 解析的变量。为获得快速修复，重新加载您的 NGINX 实例。对于长期修复，请确保将其定义为每个服务器块中的变量，而不是在上游块中定义 3scale 后端；例如：

server {
  # Enabling the Lua code cache is strongly encouraged for production use. Here it is enabled
  .
  .
  .
  set $threescale_backend "https://su1.3scale.net:443";

引用它时：

location = /threescale_authrep {
  internal;
  set $provider_key "YOUR_PROVIDER_KEY";

  proxy_pass $threescale_backend/transactions/authrep.xml?provider_key=$provider_key&service_id=$service_id&$usage&$credentials&log%5Bcode%5D=$arg_code&log%5Brequest%5D=$arg_req&log%5Bresponse%5D=$arg_resp;
}

您缺少白名单中的一些 3scale IP。以下是 3scale 解析到的 IP 的当前列表：