Pentaho启动报TimeoutException超时异常如何排查解决

故障特征 #

• 启动过程抛出java.util.concurrent.TimeoutException异常
• 日志提示多个bundle的Blueprint容器无法启动
• 报错信息显示存在未解析的OSGi服务依赖，涉及mvn协议URL流处理服务、FeaturesService、KarService等组件

核心报错日志参考：

01:35:10,135 ERROR [BlueprintContainerImpl] Unable to start blueprint container for bundle org.apache.karaf.features.core due to unresolved dependencies [(&(url.handler.protocol=mvn)(objectClass=org.osgi.service.url.URLStreamHandlerService))]
java.util.concurrent.TimeoutException
        at org.apache.aries.blueprint.container.BlueprintContainerImpl$1.run(BlueprintContainerImpl.java:336)
        at org.apache.aries.blueprint.utils.threading.impl.DiscardableRunnable.run(DiscardableRunnable.java:48)
        at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)
        at java.util.concurrent.FutureTask.run(FutureTask.java:266)
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.access$201(ScheduledThreadPoolExecutor.java:180)
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:293)
        at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
        at java.lang.Thread.run(Thread.java:748)
01:35:10,516 ERROR [BlueprintContainerImpl] Unable to start blueprint container for bundle org.apache.karaf.features.command due to unresolved dependencies [(objectClass=org.apache.karaf.features.FeaturesService)]
java.util.concurrent.TimeoutException
        at org.apache.aries.blueprint.container.BlueprintContainerImpl$1.run(BlueprintContainerImpl.java:336)
        at org.apache.aries.blueprint.utils.threading.impl.DiscardableRunnable.run(DiscardableRunnable.java:48)
        at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)
        at java.util.concurrent.FutureTask.run(FutureTask.java:266)
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.access$201(ScheduledThreadPoolExecutor.java:180)
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:293)
        at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
        at java.lang.Thread.run(Thread.java:748)
01:35:10,845 ERROR [BlueprintContainerImpl] Unable to start blueprint container for bundle org.apache.karaf.kar.core due to unresolved dependencies [(objectClass=org.apache.karaf.features.FeaturesService)]
java.util.concurrent.TimeoutException
        at org.apache.aries.blueprint.container.BlueprintContainerImpl$1.run(BlueprintContainerImpl.java:336)
        at org.apache.aries.blueprint.utils.threading.impl.DiscardableRunnable.run(DiscardableRunnable.java:48)
        at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)
        at java.util.concurrent.FutureTask.run(FutureTask.java:266)
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.access$201(ScheduledThreadPoolExecutor.java:180)
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:293)
        at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
        at java.lang.Thread.run(Thread.java:748)
01:35:10,851 ERROR [BlueprintContainerImpl] Unable to start blueprint container for bundle org.apache.karaf.kar.command due to unresolved dependencies [(&(name=installedRepoNameCompleter)(objectClass=org.apache.karaf.shell.console.Completer)), (objectClass=org.apache.karaf.kar.KarService)]
java.util.concurrent.TimeoutException
        at org.apache.aries.blueprint.container.BlueprintContainerImpl$1.run(BlueprintContainerImpl.java:336)
        at org.apache.aries.blueprint.utils.threading.impl.DiscardableRunnable.run(DiscardableRunnable.java:48)
        at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)
        at java.util.concurrent.FutureTask.run(FutureTask.java:266)
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.access$201(ScheduledThreadPoolExecutor.java:180)
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:293)
        at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
        at java.lang.Thread.run(Thread.java:748)
01:35:14,797 ERROR [BlueprintContainerImpl] Unable to start blueprint container for bundle pentaho-marketplace-di due to unresolved dependencies [(objectClass=org.apache.karaf.kar.KarService), (objectClass=org.apache.karaf.features.FeaturesService)]
java.util.concurrent.TimeoutException
        at org.apache.aries.blueprint.container.BlueprintContainerImpl$1.run(BlueprintContainerImpl.java:336)
        at org.apache.aries.blueprint.utils.threading.impl.DiscardableRunnable.run(DiscardableRunnable.java:48)
        at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511)
        at java.util.concurrent.FutureTask.run(FutureTask.java:266)
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.access$201(ScheduledThreadPoolExecutor.java:180)
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:293)
        at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
        at java.lang.Thread.run(Thread.java:748)

根因判断 #

这类报错是典型的OSGi依赖链级联故障，不需要逐个修复报缺失的服务：最底层的mvn协议URL流处理服务加载失败，直接导致依赖该服务的org.apache.karaf.features.corebundle无法启动，FeaturesService也就没法完成注册；后续依赖FeaturesService的Kar核心组件、命令组件、Pentaho市场插件都会因为拿不到依赖，等待超时后抛出异常。

排查步骤 #

• 检查启动脚本的JVM参数：打开Spoon、Carte对应的启动脚本（Windows下是.bat，Linux/macOS下是.sh），确认JVM启动参数中包含-Djava.protocol.handler.pkgs=org.ops4j.pax.url，同时确认没有系统环境变量、其他启动配置覆盖了这个参数——这个参数是注册mvn协议处理器的核心配置，缺失会直接导致mvn协议服务无法初始化。
• 校验核心bundle完整性：进入pentaho-solutions/system/osgi/bundle目录，查找文件名以org.ops4j.pax.url.mvn开头的jar包，确认文件大小正常、没有损坏、没有被杀毒软件隔离删除，这个jar包就是mvn协议URL流处理服务的提供方。
• 检查OSGi缓存状态：如果核心jar包和启动参数都正常，大概率是上次进程异常退出、强制杀进程导致OSGi缓存里的依赖解析状态错乱，触发服务加载死锁。
• 校验目录权限：Linux/macOS环境下，确认运行Pentaho的用户对安装根目录、尤其是osgi、data子目录有完整读写权限，权限不足会导致bundle无法读取、无法注册服务。
• 检查Maven配置：如果之前修改过Karaf的Maven配置，确认etc/org.ops4j.pax.url.mvn.cfg里配置的所有Maven仓库地址都能正常访问，配置了无法连通的仓库会导致pax-url-mvn组件初始化卡住超时。

对应解决方法 #

• 启动参数缺失的场景：在启动脚本的JVM参数段补上-Djava.protocol.handler.pkgs=org.ops4j.pax.url，保存后重新启动即可。
• 核心bundle损坏的场景：从同版本、可正常运行的Pentaho安装包中拷贝对应org.ops4j.pax.url.mvnjar包替换损坏文件，禁止单独下载版本不匹配的bundle替换，避免出现新的依赖冲突。
• OSGi缓存损坏的场景：先彻底关闭所有Pentaho相关进程，删除pentaho-solutions/system/osgi/data/cache目录下的全部内容，再重新启动。第一次清缓存启动会重新解析所有bundle依赖，启动耗时比平时长3-5分钟，不要中途强制终止进程。
• 权限不足的场景：Linux/macOS下执行chown -R 运行用户名:用户组 Pentaho安装根目录递归赋权，之后再用对应用户启动。
• Maven配置错误的场景：打开etc/org.ops4j.pax.url.mvn.cfg，注释掉所有无法访问的自定义Maven仓库配置，恢复默认仓库配置后重启。

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