WSO2 API Manager 4.0.0（Windows x64）重启后API失效，重部署恢复

针对Windows x64环境下APIM 4.0.0重启后API无法工作、重新部署即可恢复的问题，可按以下步骤排查解决：

• 检查API元数据持久化
  查看<APIM_HOME>/repository/deployment/server/synapse-configs/default/api目录，确认重启后对应API的.xml配置文件是否存在。若文件缺失或损坏，说明元数据未正确持久化：

  • 验证deployment.toml中的数据库配置，确保注册表、API管理相关数据源连接正常，数据库驱动已放置在<APIM_HOME>/repository/components/lib目录。
  • 检查数据库中AM_API、AM_API_VERSION等表的数据是否完整，重启后是否能被APIM正常读取。

• 清理本地缓存
  重启前手动清理缓存文件：

  • 删除<APIM_HOME>/repository/tenants目录下所有内容，执行Windows命令：

    rmdir /s /q <APIM_HOME>\repository\tenants
    

  • 删除<APIM_HOME>/repository/carbonapps中的临时部署文件，再重启APIM。

• 检查部署同步配置
  确认deployment.toml中的部署同步设置：

  [deployment.sync]
  enable = true
  type = "file" # 或svn，根据实际配置
  

  若使用文件系统同步，确保APIM运行用户对同步目录有完整读写权限（Windows下避免权限不足导致元数据无法同步）。

• 分析日志定位错误
  重启时实时查看<APIM_HOME>/repository/logs/wso2carbon.log，搜索API deployment、Failed等关键字，定位具体失败原因：

  • 若日志提示注册表读取异常，检查注册表数据源配置或数据一致性；
  • 若提示权限错误，调整APIM运行用户的目录权限。

• 确认API状态与版本
  重启后登录Publisher控制台，检查API状态是否为Published，版本是否匹配。部分场景下重启会导致API状态异常，重新发布（无需修改内容）即可恢复。

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