Mule应用部署standalone服务器报APIKit版本不匹配如何解决

java.lang.IllegalStateException: Incompatible version of plugin 'APIKit' (org.mule.modules:mule-apikit-module) found. Artifact requires version '1.6.0' but context provides version '1.5.5'

这个问题核心是Mule standalone的类加载器优先加载了公共目录下的1.5.5版本APIKit，没有使用应用内打包的1.6.0版本，哪怕本地Studio和自定义domain配置都对齐，按下面顺序排查即可解决：

• 先检查Mule standalone安装目录下的/plugins和/lib文件夹，查找是否存在mule-apikit-module-1.5.5*.jar相关包。Mule启动时会优先加载runtime自带的公共插件，只要公共目录存在旧版本，无论应用内打包了什么版本都会被覆盖，直接删除所有1.5.5版本的APIKit相关jar后重启服务即可，这是90%同类问题的诱因。
• 检查默认域依赖：如果没有指定自定义domain，应用默认运行在/domains/default域下，打开默认域的pom.xml查看是否引入了1.5.5版本的APIKit，默认域的依赖优先级高于应用自身依赖，要么将默认域的APIKit版本修改为1.6.0，要么直接删除默认域内冗余的APIKit依赖，让应用自带的插件包正常生效。
• 校验应用打包结果：解压待部署的应用jar包，查看根目录下/lib文件夹内是否存在mule-apikit-module-1.6.0.jar，再检查/META-INF/mule-artifact/mule-plugin.json中声明的APIKit版本是否为1.6.0。如果对应文件不存在，检查pom.xml内APIKit依赖的scope，不要设置为provided，使用默认的compile scope重新打包，确保插件被包含在部署包内。
• 清理服务器残留缓存：删除/apps目录下之前部署失败的应用文件夹，再清空/work和/tmp目录下和该应用相关的缓存文件，避免旧版本部署的残留文件干扰类加载，清理完成后重新上传部署包。
• 核对runtime版本兼容性：APIKit 1.6.0最低要求Mule runtime 4.3.0及以上版本，如果standalone runtime版本低于4.3.0，自带的APIKit就是1.5.x分支，要么将服务器runtime升级到兼容版本，要么将应用的APIKit版本回退到和runtime匹配的1.5.5。

补充：如果使用自定义domain统一管理公共插件，应用内不要重复引入相同的APIKit依赖，避免类加载冲突，只需保证domain内的版本和应用开发时使用的版本完全一致即可。

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