如何将WSO2 API Manager 4.2.0社区版升级至4.3.0？

以下是从4.2.0升级到4.3.0的实操步骤，覆盖核心环节：

1. 前置准备 #

• 全量备份现有环境：
  • 备份所有节点的配置文件（<APIM_4.2.0_HOME>/repository/conf下的所有文件）
  • 备份所有关联数据库（AM_DB、REG_DB、USER_DB等）
  • 备份文件系统中的部署内容（比如<APIM_4.2.0_HOME>/repository/deployment/server下的API、序列等）
• 下载并解压WSO2 APIM 4.3.0社区版到新目录，记为<APIM_4.3.0_HOME>
• 确认JDK版本符合要求：4.3.0支持OpenJDK 11/17，提前检查现有环境的JDK是否兼容，不兼容则先升级

2. 配置迁移 #

• 手动合并自定义配置：把4.2.0中修改过的deployment.toml、api-manager.xml、identity.xml等配置文件，和4.3.0的默认配置逐一对比，将自定义内容合并到新配置里不要直接覆盖——4.3.0可能新增或调整了配置项，直接覆盖会导致功能异常
• 迁移密钥库/信任库：把4.2.0里的密钥库文件（比如<APIM_4.2.0_HOME>/repository/resources/security/wso2carbon.jks）复制到4.3.0对应目录，同时在deployment.toml中确认密钥库密码配置正确
• 迁移第三方依赖：如果有自定义的jar包放在<APIM_4.2.0_HOME>/repository/components/lib或dropins目录，复制到4.3.0的对应位置，注意检查依赖兼容性

3. 数据库升级 #

• 先停掉所有4.2.0节点
• 针对每个关联数据库，执行4.3.0自带的升级脚本：脚本在<APIM_4.3.0_HOME>/dbscripts/apim/下，根据你用的数据库类型（MySQL、PostgreSQL等）选对应子目录，按顺序执行脚本
• 划重点：执行脚本前一定要确认数据库备份完成，避免数据丢失

4. 部署内容迁移 #

• 迁移API与应用：
  • 复制4.2.0中<APIM_4.2.0_HOME>/repository/deployment/server/synapse-configs/default/api下的API同步文件到4.3.0对应目录
  • 批量内容可以通过管理控制台导出4.2.0的API、应用、订阅数据，再导入到4.3.0控制台
• 迁移网关配置：把自定义的序列、本地条目、网关策略等，从4.2.0的<APIM_4.2.0_HOME>/repository/deployment/server/synapse-configs/default/sequences、local-entries等目录复制到4.3.0对应位置

5. 启动验证与流量切换 #

• 按依赖顺序启动4.3.0的核心节点（比如先启动身份服务器相关节点，再启动Publisher、Portal、Gateway）
• 查看启动日志<APIM_4.3.0_HOME>/repository/logs/wso2carbon.log，确认无致命错误或关键警告
• 验证核心功能：发布测试API、订阅调用、检查现有API可用性、验证用户登录与权限控制
• 集群环境的话，先升级一个节点验证没问题后，再逐步替换其他节点，避免业务中断

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