Apache Felix OSGI包导出失效问题求助：跨模块继承类失败

我之前在搭建OSGi模块化系统的时候，也踩过类似的包导出不生效的坑，结合你的情况，咱们一步步来排查问题：

1. 先确认Manifest的实际生效内容 #

别只盯着POM里的配置，直接去target目录下找到Common模块生成的JAR包，解压后打开META-INF/MANIFEST.MF文件，仔细核对：

• Export-Package的包路径要和你要导出的类所在的包完全一致，比如类在com.example.common.base，那导出的必须是这个完整路径，不能少层级或者拼写错误。
• 如果用的是maven-bundle-plugin，检查POM里的instructions配置，有没有其他规则覆盖了你的Export-Package设置——比如插件默认的自动导出可能会和手动配置冲突，最好显式指定要导出的包，避免模糊的通配符导致遗漏。

2. 检查依赖Bundle的Import配置 #

你要继承Common类的那个Bundle，必须显式导入对应的包：

• 同样去看这个Bundle的MANIFEST.MF，确认Import-Package里包含Common模块导出的包，版本范围也要匹配（如果Common包指定了版本的话）。
• 如果用Maven Bundle Plugin，你可以在POM里配置Import-Package，或者让插件自动检测，但自动检测有时候会漏掉继承关系这种非直接引用的情况，所以最好手动加上需要的包。

3. 解决IntelliJ的本地调试异常 #

IntelliJ有时候会因为OSGI模块的依赖缓存抽风，试试这几个操作：

• 右键项目 → Maven → Reload Project，刷新所有依赖。
• 打开File → Invalidate Caches...，选择Invalidate and Restart，彻底清理IDE缓存。
• 去File → Project Structure → Modules里，确认依赖Common模块的那个模块，已经把Common设为Compile依赖，不是Provided或者其他类型。

4. 排查Apache Felix运行时的问题 #

启动Felix后，用Gogo Shell命令来诊断：

• 输入 lb 查看所有Bundle状态，确保Common模块和依赖它的Bundle都处于Active状态（如果是Installed或者Resolved，说明有依赖问题）。
• 输入 headers [Bundle-ID] 查看Common模块的导出详情，比如headers 1（假设Common的ID是1），确认Export-Package条目正确无误。
• 输入 headers [依赖Bundle的ID]，检查它的Import-Package，看有没有Missing Constraint的错误——这通常是找不到导入的包或者版本不匹配的信号。
• 查看Felix的启动日志，里面会详细记录依赖缺失、类加载失败的原因，这是排查运行时问题的关键。

5. 类继承的特殊注意事项 #

如果继承的是抽象类或者带protected方法的类，还要注意：

• 确保导出的包包含父类的所有相关类（比如嵌套类、内部类），以及父类依赖的其他类所在的包（如果子类用到了这些类的话）。
• OSGi的类加载器是模块化的，父类所在的Bundle必须处于Active状态，子类的Bundle才能正常加载父类。如果Common模块没激活，依赖它的Bundle肯定会报错。

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