Linux环境运行wso2am 3.2.0提示qpid-config.xml不存在如何解决

异常说明 #

启动报错信息如下：

Caused by: java.io.FileNotFoundException: /wso2am-3.2.0/repository\conf\advanced\qpid-config.xml (No such file or directory)

根因分析 #

异常路径中混合了Linux标准的正斜杠路径分隔符/和Windows专属的反斜杠分隔符\，Linux系统无法识别反斜杠作为路径分隔符，因此即使文件实际存在也会提示找不到。

排查步骤 #

• 首先验证目标文件是否真实存在，执行命令：
  ls /wso2am-3.2.0/repository/conf/advanced/ | grep qpid-config.xml
  若返回对应文件名，即可确认是路径分隔符配置错误导致的问题。
• 确认安装包来源：是否是将Windows环境下解压、修改过的安装包直接上传到Linux运行，Windows环境下修改的配置可能默认写入反斜杠作为路径分隔符。
• 全局搜索配置文件中引用qpid-config.xml的位置，执行命令：
  grep -r "qpid-config.xml" /wso2am-3.2.0/
  检查对应配置项中的路径是否使用了反斜杠。

解决方法 #

• 优先方案：在Linux环境下重新下载官方WSO2 API Manager 3.2.0安装包，解压后重新部署，避免Windows环境修改带来的路径兼容问题。
• 快速修复方案：根据全局搜索结果，将所有配置文件中引用qpid-config.xml路径里的反斜杠\全部替换为正斜杠/。
• 修复后校验：执行命令cat /wso2am-3.2.0/repository/conf/advanced/qpid-config.xml，确认文件可以正常读取后，再重新启动APIM服务即可。

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