WSO2 Identity Server 5.11.0批量导入用户出现ListValuedMap类缺失错误

根因说明 #

报错核心原因是WSO2 IS 5.11.0内置的poi_3.17.0.wso2v1依赖包缺失commons-collections4组件类。批量导入Excel格式用户列表时，POI组件解析Excel需要调用org.apache.commons.collections4.ListValuedMap类，但对应版本的WSO2发行包没有将该依赖正确纳入POI bundle的类路径，触发类找不到异常。

修复操作步骤 #

• 下载版本为4.4的commons-collections4 jar包，该版本与POI 3.17.0兼容性最佳
• 将下载好的jar包放入WSO2 IS安装目录下的repository/components/dropins文件夹
• 停止WSO2 IS服务，删除<IS_HOME>/repository/work目录下的所有缓存内容，清理OSGi运行缓存
• 重启WSO2 IS服务，等待所有组件加载完成后重新测试批量用户导入功能即可

注意事项 #

请勿随意升级POI组件版本，WSO2 IS 5.11.0对POI 3.17.0版本存在代码适配，更换更高版本POI可能引发其他用户管理接口的兼容问题。
重启后可进入OSGi控制台执行ss poi命令，确认POI bundle状态为ACTIVE，即可确认依赖加载正常。

内容的提问来源于stack exchange，提问作者Manu Singh Kirola