Karaf启动遇javax.sql.DataSource类找不到异常的原因及解决方法

异常原因 #

1. OSGi模块化类加载限制：javax.sql.DataSource属于Java EE规范API，在Karaf的OSGi环境中，你的业务bundle未被显式授予访问该API包的权限，导致类加载时找不到对应类。
2. 违背Pax-JDBC设计模式：直接手动实例化PGSimpleDataSource绕开了Pax-JDBC的OSGi服务管理机制，这类手动实例操作无法利用OSGi的依赖注入与类资源调度能力。
3. bundle依赖声明缺失：你的业务bundle的MANIFEST.MF中未声明对javax.sql、org.postgresql.ds等必要包的导入，OSGi框架不会自动允许bundle访问未声明的外部包。

修复步骤 #

1. 补充bundle的依赖声明 #

在你的业务bundle构建配置（如Maven的bnd-maven-plugin，或直接编辑MANIFEST.MF）中添加导入声明：

Import-Package: javax.sql, org.postgresql.ds

确保OSGi框架允许你的bundle访问这些API包。

2. 改用Pax-JDBC标准服务获取方式（推荐） #

放弃手动实例化数据源，通过OSGi服务注册表获取DataSource实例，这是Pax-JDBC的标准用法：

方式一：使用Declarative Services（DS）注解

import javax.sql.DataSource;
import org.osgi.service.component.annotations.Reference;

public class YourService {
    @Reference
    private DataSource dataSource;

    // 使用dataSource进行数据库操作
}

方式二：使用ServiceTracker

import javax.sql.DataSource;
import org.osgi.framework.BundleContext;
import org.osgi.util.tracker.ServiceTracker;

public class YourService {
    public void init(BundleContext context) {
        ServiceTracker<DataSource, DataSource> tracker = new ServiceTracker<>(context, DataSource.class, null);
        tracker.open();
        DataSource dataSource = tracker.getService();
        // 使用dataSource进行数据库操作
    }
}

同时在Karaf的etc目录下创建数据源配置文件（如org.ops4j.datasource-postgresql.cfg）：

osgi.jdbc.driver.name=postgresql
url=jdbc:postgresql://localhost:5432/your_database
user=db_username
password=db_password
dataSourceName=postgresDataSource

Pax-JDBC会自动根据配置创建并注册DataSource服务。

3. 验证Postgres驱动与Pax-JDBC特性状态 #

• 运行Karaf命令bundle:list，确认Postgres驱动bundle已启动，且导出了org.postgresql.ds等相关包。
• 运行feature:list | grep jdbc，确保已安装的jdbc相关特性均处于Started状态，若有未启动的特性，执行feature:start <feature-name>启动。

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