WSO2 APIM Pattern 3部署问题：网关URL无效、控制平面连接失败

[2024-03-08 05:36:39,176]  WARN - InboundHttpServerWorker Could not get tenant configuration context for tenant jivatest.com. Tenant may not exist. Message will be dispatched to super tenant.
[2024-03-08 05:36:39,201]  INFO - LogMediator {inboundendpoint:SecureWebhookServer} STATUS = Message dispatched to the main sequence. Invalid URL., RESOURCE = /t/jivatest.com/v1.1/activities/v1.1/123, HEALTH CHECK URL = /t/jivatest.com/v1.1/activities/v1.1/123
[2024-03-08 05:36:41,390]  WARN - MiscellaneousUtil Error loading properties from a file at from the System defined location: access-log.properties

• 控制平面与网关连接校验

  • 核对网关节点deployment.toml的[apim.gateway.environment]配置项，确保control_plane_url、username、password与控制平面的真实地址、管理员账号一致
  • 检查控制平面deployment.toml的[apim.gateway]配置，确认gateway_environments已正确添加目标网关的信息，type设为hybrid（符合Pattern3分布式部署要求）
  • 排查网络连通性：在控制平面和网关节点分别执行telnet/ping命令，确认9443（HTTPS）、8280（HTTP）端口可双向访问，无防火墙或安全组拦截

• 租户与URL路径匹配修正

  • 日志提示jivatest.com租户不存在，若测试无租户API，需移除URL中的/t/jivatest.com/前缀，使用超级租户格式访问（如/activities/v1.1/123）；若需使用该租户，先在控制平面的租户管理界面创建jivatest.com租户
  • 检查网关API同步状态：查看网关节点repository/deployment/server/synapse-configs/default/api/目录，确认是否存在目标OOB API的XML文件；若缺失，重启网关或在APIM管理控制台的网关页面触发同步

• 无效URL问题定位

  • 确认OOB API的配置：检查API的上下文、版本、资源路径是否与访问URL匹配，正确的无租户API访问格式应为https://<网关IP>:8243/<API上下文>/<版本>/<资源路径>
  • 检查SecureWebhookServer入站端点配置：确认该端点的路径匹配规则是否覆盖了目标API的访问路径，无路径正则错误
  • 修复access-log.properties加载错误：从WSO2 APIM安装包的conf/目录复制该文件到网关节点的repository/conf/下，确保网关进程对文件有可读权限

• Token权限验证

  • 解码生成的Token，检查aud字段是否包含目标API的上下文，scope字段是否包含API允许的权限（如apim:api_view、apim:invoke）
  • 确认API已订阅到生成Token的应用，且应用状态为活跃，无订阅过期或权限限制

内容的提问来源于stack exchange，提问作者Ajith Nirmal