WSO2 API Manager 4.1.0中已弃用API无法访问及操作求助

绕开UI直接操作API的方法 #

1. 使用REST API执行操作 #

WSO2 APIM自带的Publisher REST API可直接跳过UI完成API管理：

• 查看API概览：发送GET请求到 https://<APIM_HOST>:<PORT>/api/am/publisher/v1.0/apis，通过查询参数?name=Pizzashack过滤出目标API，拿到其UUID后，再请求https://<APIM_HOST>:<PORT>/api/am/publisher/v1.0/apis/<API_UUID>即可获取完整概览信息。
• 修改API状态：发送PUT请求到https://<APIM_HOST>:<PORT>/api/am/publisher/v1.0/apis/<API_UUID>/status，请求体传入{"status":"PUBLISHED"}（或其他合法状态），先将API从Deprecated状态切换回可用状态，后续UI操作即可恢复正常。
• 删除API：直接发送DELETE请求到https://<APIM_HOST>:<PORT>/api/am/publisher/v1.0/apis/<API_UUID>即可删除目标API。
  注意：请求需携带有效的Publisher身份认证信息，比如Basic Auth或OAuth2 Token。

2. 修改注册表工件修复NPE #

利用已有的API注册表XML工件，按以下步骤修复：

• 定位APIM服务器的注册表存储路径（默认是<APIM_HOME>/repository/deployment/server/runtime-data/registry），找到对应Pizzashack API的注册表条目文件。
• 打开XML文件，排查可能引发NPE的空值或格式错误：
  • 检查<status>节点值为DEPRECATED时，<deprecatedDate>等关联字段是否有合法的ISO 8601格式日期（如2024-05-20T12:00:00Z），为空则手动补充。
  • 核对<endpointConfig>、<subscriptionAvailability>等节点，确保必填字段均有有效值，避免空节点。
• 修改后保存XML文件，重启WSO2 APIM服务器，再尝试UI操作即可。

排查NPE根源 #

• 从wso2carbon.log中提取完整的NPE堆栈跟踪，定位抛出异常的具体类和方法——若异常来自APIDetailsView.java或状态处理相关类，通常是Deprecated状态下部分元数据未正确初始化导致。
• 将目标API的注册表XML与正常状态的API XML对比，找出缺失字段或格式差异，针对性修复即可。

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