OSGi环境中引入外部SQLite Jar包失败的问题求助

我之前在OSGi环境里折腾第三方JDBC驱动也踩过类似的坑，OSGi的类加载隔离机制确实容易让人头疼——你试的几种方法没生效，大概率是没适配OSGi的元数据要求或者类加载逻辑。给你几个靠谱的解决思路：

方法1：将SQLite Jar转换为OSGi Bundle（推荐） #

普通的第三方Jar没有OSGi必需的Manifest元数据（比如Export-Package、Bundle-SymbolicName），OSGi容器无法正确识别和加载它的类。最规范的做法是把它转换成标准的OSGi Bundle：

用Gradle + Bnd插件实现 #

在你的Gradle构建脚本中添加如下配置（以最新版SQLite JDBC为例）：

plugins {
    id 'java'
    id 'biz.aQute.bnd.builder' version '6.4.0'
}

dependencies {
    implementation 'org.xerial:sqlite-jdbc:3.41.2.1'
}

jar {
    manifest {
        attributes(
            'Bundle-Name': 'SQLite Driver Bundle',
            'Bundle-SymbolicName': 'org.xerial.sqlite.jdbc',
            'Bundle-Version': '3.41.2.1',
            // 导出SQLite驱动的所有核心包，供业务Bundle调用
            'Export-Package': 'org.sqlite,org.sqlite.core,org.sqlite.jdbc4,org.sqlite.jdbc42,org.sqlite.util'
        )
    }
}

构建完成后，你会得到一个带OSGi元数据的Bundle Jar。

配置你的业务Bundle依赖 #

在业务Bundle的Manifest中添加依赖声明：

Require-Bundle: org.xerial.sqlite.jdbc;bundle-version="[3.41.2.1,4.0.0)"

或者更灵活的Import-Package方式：

Import-Package: org.sqlite,java.sql,javax.sql

方法2：将SQLite Jar嵌入到业务Bundle中 #

如果不想单独生成驱动Bundle，也可以把SQLite Jar直接嵌入到你的业务Bundle里，需要注意以下几点：

Gradle构建配置 #

确保把第三方Jar打包到业务Bundle中，并正确配置Manifest：

plugins {
    id 'java'
    id 'biz.aQute.bnd.builder' version '6.4.0'
}

dependencies {
    implementation files('libs/my3rdparty.jar') // 本地Jar路径，或用Maven坐标
}

jar {
    // 将第三方Jar的内容解压到业务Bundle中
    from configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) }
    manifest {
        attributes(
            'Bundle-Name': 'Your Business Bundle',
            'Bundle-SymbolicName': 'com.yourcompany.yourbundle',
            'Bundle-Version': '1.0.0',
            'Bundle-ClassPath': '.', // 表示Bundle根目录下的所有类和资源
            // 导入JDBC相关的系统包
            'Import-Package': 'java.sql,javax.sql',
            // 导出你自己的业务包（如果需要其他Bundle调用）
            'Export-Package': 'com.yourcompany.yourpackage'
        )
    }
}

修正驱动加载逻辑 #

在OSGi中，默认的类加载器不是Bundle的类加载器，所以Class.forName需要指定当前Bundle的类加载器：

private void getConnection() throws ClassNotFoundException, SQLException {
    // 使用当前类的类加载器（即业务Bundle的类加载器）加载SQLite驱动
    Class.forName("org.sqlite.JDBC", true, getClass().getClassLoader());
    // 数据库路径建议使用Bundle的资源路径或绝对路径，避免OSGi环境下的路径问题
    String dbUrl = "jdbc:sqlite:" + System.getProperty("user.dir") + "/your-db.db";
    Connection conn = DriverManager.getConnection(dbUrl);
}

排查之前的问题点 #

你之前尝试的方法没生效，可能是这些原因：

• Bundle-ClassPath配置错误：如果手动配置Bundle-ClassPath: .,my3rdparty.jar，需要确保my3rdparty.jar确实在Bundle的根目录下，否则OSGi找不到它。
• 类加载器问题：直接用Class.forName("org.sqlite.JDBC")会使用系统类加载器，而OSGi的系统类加载器无法访问Bundle内部的Jar类。
• Gradle构建未打包Jar：如果只是在依赖里添加了Jar，但没有配置from zipTree(it)，第三方Jar不会被打包到业务Bundle中。

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