Nexus 3.x无法更新Bundle部署特性问题求助

问题描述 #

未对Nexus 3.x做任何更改，服务运行期间持续出现大量Bundle相关错误，核心报错为java.lang.NullPointerException，涉及org.apache.karaf.deployer.features.FeatureDeploymentListener类，具体错误示例如下：

错误示例1 #

ERROR [FelixStartLevel]  *SYSTEM org.apache.karaf.deployer.features.FeatureDeploymentListener - Unable to update deployed features for bundle: org.apache.felix.framework - 6.0.5
java.lang.NullPointerException: null
        at org.apache.karaf.deployer.features.FeatureDeploymentListener.bundleChanged(FeatureDeploymentListener.java:254)
        at org.apache.karaf.deployer.features.FeatureDeploymentListener.init(FeatureDeploymentListener.java:90)
        at org.apache.karaf.deployer.features.osgi.Activator$DeploymentFinishedListener.deploymentEvent(Activator.java:86)
        at org.apache.karaf.features.internal.service.FeaturesServiceImpl.registerListener(FeaturesServiceImpl.java:296)

错误示例2 #

ERROR [FelixDispatchQueue]  *SYSTEM org.apache.karaf.deployer.features.FeatureDeploymentListener - Unable to update deployed features for bundle: org.apache.karaf.log.core - 4.3.6
java.lang.NullPointerException: null
        at org.apache.karaf.deployer.features.FeatureDeploymentListener.bundleChanged(FeatureDeploymentListener.java:254)
        at org.apache.felix.framework.EventDispatcher.invokeBundleListenerCallback(EventDispatcher.java:915)
        at org.apache.felix.framework.EventDispatcher.fireEventImmediately(EventDispatcher.java:834)
        at org.apache.felix.framework.EventDispatcher.run(EventDispatcher.java:1147)
        at org.apache.felix.framework.EventDispatcher.access$000(EventDispatcher.java:54)
        at org.apache.felix.framework.EventDispatcher$1.run(EventDispatcher.java:102)
        at java.lang.Thread.run(Thread.java:750)

已尝试清理Nexus缓存、重启服务，问题未解决，需让Nexus无错误运行并正常访问仪表盘。

解决方案 #

1. 彻底清理Karaf缓存与临时文件 #

停止Nexus服务后，找到Nexus的数据目录（默认路径为sonatype-work/nexus3），执行以下操作：

• 删除karaf/data/cache文件夹
• 删除karaf/data/tmp文件夹
• 重启Nexus服务

2. 检查并修复Karaf配置文件 #

进入sonatype-work/nexus3/karaf/etc目录，检查org.apache.karaf.deployer.features.cfg等核心配置文件是否存在损坏：

• 如果有配置文件备份，恢复备份文件
• 若无备份，从同版本的全新Nexus安装包中拷贝对应配置文件替换

3. 验证Java版本兼容性 #

确认当前使用的Java版本符合Nexus 3.x官方要求：

• Nexus 3.20+推荐使用Java 11，部分旧版本支持Java 8
• 避免使用非官方推荐的Java版本，防止类加载异常

4. 检查文件系统权限 #

确保Nexus运行用户对以下目录拥有完整的读写权限：

• Nexus安装目录
• sonatype-work/nexus3数据目录
  权限不足可能导致bundle加载失败或缓存文件损坏

5. 替换核心Bundle文件（终极方案） #

若上述方法无效，下载对应版本的Nexus官方安装包，解压后：

• 停止Nexus服务
• 替换安装目录下的system文件夹（该文件夹包含所有核心Bundle）
• 重启Nexus服务，观察错误是否消失

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