如何在Gradle中添加ODBC驱动连接xlsb文件并解决驱动未找到异常

问题背景 #

为支持遗留流程，尝试将XLSB文件作为数据库连接（因Apache POI对XLSB文件支持不佳），使用以下代码：

try{
    Connection xlsbConnection=DriverManager.getConnection("jdbc:odbc:Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};DBQ="+filePath+";");
    Statement xlsbStatement=xlsbConnection.createStatement();
    ResultSet xlsbResultSet=xlsbStatement.executeQuery("Select * from ["+sheetName+"$]");
    while (xlsbResultSet.next()) {
        ResultSetMetaData xlsbRsmd = xlsbResultSet.getMetaData();
        int numberOfColumns = xlsbRsmd.getColumnCount();

        for (int i = 1; i <= numberOfColumns; i++) {
            if (i > 1)
                System.out.print(", ");
            String columnValue = xlsbResultSet.getString(i);
            System.out.print(columnValue);
        }
        System.out.println("");
    }

    xlsbConnection.close();
}catch(Exception e){
    System.out.print(e.toString());
}

运行后抛出异常：

java.sql.SQLException: No suitable driver found for jdbc:odbc:Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};DBQ=C:\Remaining file path;

已在64位ODBC驱动管理器的User DSN中看到64位驱动，需明确驱动安装位置及解决方法。

解决方法 #

核心原因 #

问题出在JVM位数与Excel ODBC驱动位数不匹配：即使系统里有64位驱动，若你的Java运行环境是32位，JDBC-ODBC桥会找不到对应驱动，反之亦然。

具体步骤 #

1. 确认JVM位数
   打开命令行执行java -version，查看输出内容：

   • 若包含64-Bit，说明是64位JVM；
   • 若无，则为32位JVM。

2. 匹配驱动位数

   • 若JVM是32位：必须安装32位Microsoft Excel ODBC驱动。注意：64位系统下，若安装的是64位Office，默认没有32位驱动，需手动下载安装32位版本的Excel驱动。
   • 若JVM是64位：确保安装的是64位Excel ODBC驱动，且你的Office版本为64位（64位Office会自带对应驱动）。

3. 驱动安装说明
   Excel ODBC驱动是全局安装的，安装后会自动注册到系统ODBC库中，无需手动指定安装路径。关键是保证JVM、ODBC驱动、Office三者位数完全一致。

4. 优化连接方式
   可通过配置ODBC数据源简化连接：

   • 打开对应位数的ODBC管理器：32位为C:\Windows\SysWOW64\odbcad32.exe，64位为C:\Windows\System32\odbcad32.exe；
   • 创建用户DSN或系统DSN，指定目标XLSB文件；
   • 修改连接字符串为jdbc:odbc:你的DSN名称，避免直接写驱动名称可能出现的格式问题。

替代方案 #

若ODBC兼容问题难以解决，可尝试升级Apache POI到最新稳定版，目前POI对XLSB文件的读写支持已大幅改善，能规避ODBC的位数兼容问题。

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