WSO2服务器Jar文件升级至最新版本问题排查

核心问题 #

你直接替换<MI_HOME>/wso2/plugins目录下Jar文件的操作有误——plugins目录下的Jar是OSGi Bundle，不是普通Jar文件。这类Jar包含OSGi元数据（比如Bundle版本、导入/导出包声明），直接用Maven中央仓库的普通Jar（如com.google.gson_2.8.9.jar）替换，会破坏OSGi容器的依赖关系，导致类加载失败（就是你遇到的ClassNotFoundException）。而<MI_HOME>/wso2/lib目录是普通类加载器加载，不需要OSGi元数据，所以替换普通Jar能正常运行。

正确的更新步骤 #

1. 优先使用WSO2官方补丁 #

WSO2会针对第三方依赖漏洞发布官方补丁，补丁里的Jar都是适配其OSGi环境的bundle，直接安装官方补丁是最安全的方式。

2. 手动更新适配的OSGi Bundle（若官方补丁未覆盖） #

• 找对适配版本的Bundle：选择带wso2v后缀的版本（比如com.google.gson_2.8.9.wso2v1.jar），这类是WSO2打包适配过的OSGi Bundle。
• 替换并清理缓存：
  • 删除plugins目录下旧的目标Jar（比如com.google.gson_2.8.5.jar）
  • 将适配的OSGi Bundle放入plugins目录
  • 删除<MI_HOME>/tmp和<MI_HOME>/work目录（清理OSGi缓存，避免旧依赖残留）
  • 重启服务器

3. 为什么编辑artifacts.xml没用？ #

artifacts.xml是WSO2用来记录bundle清单的文件，但如果新Jar本身不是合法的OSGi Bundle，或者依赖不满足，手动修改这个文件无法解决类加载问题，反而容易引入更多配置错误，不需要手动编辑它。

额外注意事项 #

• 更新第三方依赖时，要检查依赖链：比如更新gson后，其他bundle可能依赖旧版本的gson导出包，需要确认是否有其他关联bundle需要同步更新。
• 所有操作先在测试环境验证，确认稳定后再推到生产环境。

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