Liferay 7.x OSGi Bundle部署FirebirdSQL JDBC驱动报错求助

问题分析 #

报错Unresolved requirement: Import-Package: com.sun.jna的核心原因是：Jaybird 4.x版本开始依赖JNA（Java Native Access）处理Firebird本地客户端库，而Liferay的OSGi容器默认未提供这个依赖包。把驱动放到Tomcat lib目录无效，是因为OSGi Bundle的类加载机制是隔离的，Tomcat的系统类路径不会自动被OSGi模块识别。

解决方案 #

1. 打包JNA依赖到自定义Bundle #

在build.gradle中添加JNA的compileInclude依赖，让构建工具把JNA相关包打包进你的认证器Bundle：

compileInclude group: 'org.firebirdsql.jdbc', name: 'jaybird', version: '4.0.9.java11'
compileInclude group: 'net.java.dev.jna', name: 'jna', version: '5.13.0'
compileInclude group: 'net.java.dev.jna', name: 'jna-platform', version: '5.13.0'

注意：JNA版本需与Jaybird 4.0.9依赖的版本匹配，可通过Maven仓库查看Jaybird的依赖树确认

2. 显式配置Bundle的导入包 #

如果自动生成的Import-Package规则有遗漏，可在bnd.bnd文件中补充声明：

Import-Package: com.sun.jna, com.sun.jna.*, *

这条配置会让Bundle明确导入JNA相关包，确保OSGi容器能找到对应的依赖。

3. 独立部署JNA OSGi Bundle #

若不想把JNA打包进自定义Bundle，可单独下载带有OSGi元数据的JNA jar包（从Maven仓库获取），放到Liferay的osgi/modules目录下，先启动JNA Bundle，再部署你的认证器Bundle。可通过Gogo Shell（telnet localhost 11311）执行ss com.sun.jna命令，确认JNA Bundle处于Active状态。

4. 使用无JNA依赖的纯Java版Jaybird #

如果不需要Firebird本地客户端功能，可改用纯Java版Jaybird，避免JNA依赖问题：

compileInclude group: 'org.firebirdsql.jdbc', name: 'jaybird-jdk11', version: '4.0.9.java11'

该版本仅支持纯Java连接方式，性能或部分功能可能受限，需根据业务场景选择。

5. 为什么Tomcat lib目录无效？ #

Liferay的OSGi模块运行在独立的类加载器中，Tomcat lib下的jar属于系统类加载器，OSGi模块默认不会自动导入这些类。强行通过配置打破隔离会破坏OSGi模块化设计，不推荐使用。

验证步骤 #

1. 确保JNA依赖已正确引入（打包或独立部署）
2. 重新编译并部署认证器Bundle
3. 查看Liferay日志，确认依赖错误已消除
4. 测试Firebird数据库的用户认证功能

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