嵌入式Apache Felix启动Bundle遇maven-bundle-plugin依赖解析错误

我帮你梳理下这类问题的核心原因和解决步骤——OSGi的强依赖解析机制加上maven-bundle-plugin的自动约束逻辑，很容易出现这类版本匹配问题：

1. 调整Maven Bundle插件的依赖版本约束 #

maven-bundle-plugin默认会根据项目依赖自动生成Import-Package的版本范围，有时候会生成过于严格的约束（比如你遇到的(&(osgi.wiring.package=com.google.common.base)(version>=21.0.0)(!(version>=22.0.0)))）。解决方法是手动指定Import-Package的版本范围，放宽或明确符合你需求的约束：

在pom.xml的maven-bundle-plugin配置中，添加或修改<Import-Package>指令：

<plugin>
    <groupId>org.apache.felix</groupId>
    <artifactId>maven-bundle-plugin</artifactId>
    <version>4.2.1</version> <!-- 使用适配你项目的稳定版本 -->
    <extensions>true</extensions>
    <configuration>
        <instructions>
            <Bundle-SymbolicName>a.b.c</Bundle-SymbolicName>
            <Bundle-Version>1.0.0</Bundle-Version>
            <!-- 手动控制依赖包的版本范围，替换自动生成的严格约束 -->
            <Import-Package>
                <!-- 允许Guava 21.x到23.x的版本，根据你的实际依赖调整 -->
                com.google.common.base;version="[21.0.0,23.0.0)",
                <!-- 针对自定义包调整版本范围，避免之前的约束错误 -->
                com.a.b.c;version="[xx.0.0,zz.0.0)",
                * <!-- 其他依赖包使用插件默认规则 -->
            </Import-Package>
            <Export-Package>
                <!-- 配置你需要导出的业务包 -->
            </Export-Package>
        </instructions>
    </configuration>
</plugin>

2. 确保嵌入式Felix中存在匹配版本的依赖Bundle #

启动时的BundleException本质是Felix找不到满足版本要求的com.google.common.base包，所以你需要：

• 找到对应版本的Guava OSGi Bundle（可以用官方提供的OSGi打包版本，或者自己用maven-bundle-plugin打包）
• 在嵌入式Felix启动时，先安装这个依赖Bundle，再启动你的业务Bundle

比如在启动代码中加入：

// 初始化Felix框架
Felix felix = new Felix(config);
felix.start();
BundleContext context = felix.getBundleContext();

// 先安装Guava依赖Bundle（替换为你的Jar路径）
Bundle guavaBundle = context.installBundle("file:libs/guava-21.0-osgi.jar");
guavaBundle.start();

// 再安装并启动你的业务Bundle
Bundle myBundle = context.installBundle("file:libs/your-bundle-1.0.0.jar");
myBundle.start();

3. 排查并解决依赖传递冲突 #

有时候你的项目依赖的其他库会间接引入不同版本的Guava，导致maven-bundle-plugin生成错误的版本约束。可以用Maven命令查看依赖树：

mvn dependency:tree

找到冲突的Guava依赖后，在对应的依赖中排除掉不兼容的版本：

<dependency>
    <groupId>第三方库groupId</groupId>
    <artifactId>第三方库artifactId</artifactId>
    <version>x.y.z</version>
    <exclusions>
        <exclusion>
            <groupId>com.google.guava</groupId>
            <artifactId>guava</artifactId>
        </exclusion>
    </exclusions>
</dependency>

4. 验证生成的MANIFEST.MF内容 #

构建项目后，打开你的业务Bundle Jar包，查看META-INF/MANIFEST.MF中的Import-Package条目，确认版本范围是否和你配置的一致，避免插件自动生成的约束覆盖了你的手动配置。

内容的提问来源于stack exchange，提问作者Ahmad R. Nazemi