如何将本地创建的WSO2 API发布到远程服务器WSO2 API Manager

核心问题说明 #

Add new server菜单下的WSO2 Remote Server选项，仅用于连接远程WSO2 Micro Integrator实例部署集成流，不支持对接WSO2 API Manager完成API发布，选错功能入口是该类发布失败的核心原因。

前置检查项 #

• 保证本地WSO2 Integration Studio大版本和远程服务器部署的WSO2 API Manager版本一致，跨大版本（如本地8.x、远程4.1.x）会存在REST API兼容问题，直接导致连接失败
• 提前放开远程服务器防火墙、安全组规则，允许你本地IP访问APIM默认管理端口9443，后续如果要测试API调用还需要放开网关端口8243
• 确认远程APIM的可用管理员账号密码，默认初始账号密码均为admin，生产环境请使用实际分配的、具备API发布权限的账号

分步操作流程 #

1. 打开Integration Studio进入对应工作区，在左侧项目资源管理器中定位到你本地创建好的API项目
2. 无需新增WSO2 Remote Server，直接右键点击目标API项目，选择菜单中的Push to API Manager选项（新版本Studio也可以在顶部WSO2主菜单找到同名入口）
3. 在弹出的服务器配置弹窗中，按实际环境填写参数：
   • APIM Version：下拉选择和远程服务器部署版本完全匹配的APIM版本号
   • Publisher URL：格式为https://<远程服务器公网IP/绑定域名>:9443/api/am/publisher/<版本路径>，4.x系列版本对应路径后缀为v4，3.x系列版本对应后缀为v1
   • Registration Endpoint：格式为https://<远程服务器公网IP/绑定域名>:9443/client-registration/<对应版本路径>/register，4.2版本对应路径版本为v0.17，其他小版本可通过浏览器直接访问该地址确认路径有效性
   • Username/Password：填入提前准备好的、具备发布权限的APIM账号密码
   • 勾选Trust SSL Certificates选项：远程服务器使用自签名SSL证书时必须勾选，否则会触发SSL握手失败错误
4. 参数填写完成后点击Validate Connection按钮，提示连接校验通过后点击Next
5. 在后续页面选择要发布的API版本、目标部署网关环境，确认配置后点击Finish即可完成API自动上传
6. 上传完成后登录远程APIM的Publisher控制台，在API列表中即可找到刚上传的API，补全剩余配置（如流控策略、订阅策略、后端地址校验）后点击发布即可。

常见故障排查 #

• 连接校验不通过：先在本地浏览器直接访问填写的Publisher URL、Registration Endpoint地址，确认页面可正常加载，排除端口未开放、IP被拦截的问题；如果是证书问题，除了勾选信任证书选项，也可以提前将远程服务器的SSL证书导入Integration Studio内置JDK的cacerts信任库中
• 上传完成后Publisher控制台看不到API：确认登录控制台使用的账号和上传时填写的账号一致，检查是否切换到了错误的租户/组织目录
• 上传时报权限不足错误：给使用的账号分配APIM的Internal/publisher角色，或确认账号已被授予API创建、发布的对应操作权限

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