WSO2 API Manager 4.1.0中convert.xml重启后丢失问题求助

问题原因 #

WSO2 API Manager 4.1.0的网关错误处理配置受内部注册表（Registry）管控，服务器启动时会自动从注册表同步配置到文件系统的repository/deployment/server/synapse-configs/default/errors/目录。如果只是在服务器运行时直接向该目录添加convert.xml，这个文件不会被写入注册表，重启服务器时，注册表的配置会覆盖文件系统目录，导致新增的文件被删除。

解决方案 #

1. 通过APIM管理控制台上传配置（推荐） #

• 登录APIM管理控制台
• 进入API Gateway -> Error Handling模块
• 点击上传按钮，选择你的convert.xml文件完成上传
• 上传的配置会自动存入注册表，后续重启服务器时会同步到文件系统，不会丢失

2. 通过Carbon控制台手动写入注册表 #

• 登录Carbon控制台（端口9443）
• 进入Resources -> Browse，导航到路径/_system/governance/apimgt/applicationdata/errors/
• 上传convert.xml到该路径并保存
• 重启服务器，配置会自动同步到网关的错误处理目录

3. 辅助检查：目录权限 #

确保运行WSO2 APIM的系统用户对repository/deployment/server/synapse-configs/default/errors/目录拥有读写权限，避免因权限问题导致文件被意外清理（此为辅助步骤，核心解决方式仍需将配置存入注册表）

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