WSO2 Identity自定义用户存储加载失败，为何出现ClassNotFoundException？

我之前开发WSO2自定义用户存储管理器时，也踩过一模一样的ClassNotFoundException坑，结合你描述的场景，给你几个实用的排查和解决方向：

1. 重点检查OSGi Bundle的MANIFEST.MF依赖配置 #

这是最常见的触发原因，OSGi的类加载完全依赖MANIFEST.MF里的导入导出声明，你需要确保：

• Import-Package 包含所有代码中用到的外部包：比如你代码里用到的org.apache.commons.logging，还有WSO2用户存储核心的基础包（比如org.wso2.carbon.user.core、org.wso2.carbon.user.core.service），以及你自己的com.xxx.identity.userstore包（如果CustomUserStoreCoordinator和激活类不在同一个包下）。
• 导入的包版本必须和你使用的WSO2 Identity Server版本匹配，比如WSO2 IS 5.11.x对应的org.wso2.carbon.user.core版本是5.11.x，版本不匹配会直接导致类无法被识别。

给你一个参考的Import-Package配置示例：

Import-Package: org.osgi.service.component,
 org.apache.commons.logging; version="1.2.0",
 org.wso2.carbon.user.core; version="5.11.0",
 org.wso2.carbon.user.core.service; version="5.11.0",
 com.xxx.identity.userstore; version="1.0.0"

2. 验证依赖JAR的部署位置 #

如果你的自定义用户存储依赖了第三方JAR，注意区分部署目录：

• 普通非OSGi格式的JAR，要放到<WSO2_HOME>/repository/components/lib目录，这里的JAR会被系统类加载器加载，所有bundle都能访问到；
• 要是OSGi格式的依赖bundle，放到dropins目录没问题，但要通过日志确认它已经被正确激活。

3. 通过服务器日志排查bundle状态 #

重启服务器后，打开<WSO2_HOME>/logs/wso2carbon.log，搜索你的bundle名称：

• 如果看到Bundle com.xxx.identity.userstore [xxx] is ACTIVE，说明bundle启动正常；
• 如果是INSTALLED或RESOLVED状态，日志里通常会有Unresolved requirement的具体提示，照着提示补充缺失的依赖即可。

4. 确认类是否被正确打包进bundle #

有时候maven或其他打包工具会遗漏类，你可以手动解压你的OSGi bundle JAR，检查com/xxx/identity/userstore/CustomUserStoreCoordinator.class是否存在，以及internal包下的激活类是否也在bundle里。

5. 调整bundle的启动顺序 #

如果你的bundle依赖WSO2的核心组件，可以通过配置明确依赖关系来保证启动顺序：
在MANIFEST.MF里添加：

Require-Bundle: org.wso2.carbon.user.core; bundle-version="5.11.0"

或者设置延迟激活避免启动冲突：

Bundle-ActivationPolicy: lazy

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