基于环境变量配置Maven依赖：用java -jar加载Oracle驱动

下面是几个可行的方案，解决你无法统一$ORACLE_HOME路径、需要用java -jar启动的问题：

方案1：用JVM启动参数扩展类路径 #

java -jar启动时会忽略-cp参数，但可以通过-Djava.ext.dirs参数把Oracle驱动目录加入类路径。注意要保留JRE默认的ext目录，避免丢失系统扩展类：

# Linux/macOS
java -Djava.ext.dirs="$ORACLE_HOME/jdbc/lib:$JAVA_HOME/jre/lib/ext" -jar your-app.jar

# Windows
java -Djava.ext.dirs="%ORACLE_HOME%\jdbc\lib;%JAVA_HOME%\jre\lib\ext" -jar your-app.jar

直接执行这条命令即可，系统会自动从$ORACLE_HOME路径下加载驱动jar。

方案2：封装启动脚本简化操作 #

如果不想让团队成员记住复杂的命令，可以写个启动脚本，自动读取环境变量并拼接启动参数：

Linux/macOS脚本（start-app.sh） #

#!/bin/bash
if [ -z "$ORACLE_HOME" ]; then
    echo "错误：未设置ORACLE_HOME环境变量"
    exit 1
fi
DRIVER_DIR="$ORACLE_HOME/jdbc/lib"
java -Djava.ext.dirs="$DRIVER_DIR:$JAVA_HOME/jre/lib/ext" -jar target/your-app.jar

给脚本加执行权限后，团队成员只需要运行./start-app.sh即可。

Windows脚本（start-app.bat） #

@echo off
if "%ORACLE_HOME%"=="" (
    echo 错误：未设置ORACLE_HOME环境变量
    exit /b 1
)
set DRIVER_DIR=%ORACLE_HOME%\jdbc\lib
java -Djava.ext.dirs="%DRIVER_DIR%;%JAVA_HOME%\jre\lib\ext" -jar target\your-app.jar

双击运行脚本就能启动应用，和java -jar的使用习惯一致。

方案3：代码动态加载驱动（无需启动参数） #

如果不想依赖启动参数，可以在应用启动时通过代码动态加载$ORACLE_HOME下的驱动：

1. 先在Maven的对应Profile里把Oracle驱动依赖设为provided，避免打包进应用jar：

<dependency>
    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc8</artifactId>
    <version>19.3.0.0</version>
    <scope>provided</scope>
</dependency>

2. 添加驱动加载代码，在应用启动时执行：

import java.io.File;
import java.net.URL;
import java.net.URLClassLoader;
import java.sql.Driver;

public class OracleDriverLoader {
    public static void load() throws Exception {
        String oracleHome = System.getenv("ORACLE_HOME");
        if (oracleHome == null || oracleHome.isBlank()) {
            throw new IllegalStateException("请设置ORACLE_HOME环境变量");
        }

        File driverJar = new File(oracleHome + "/jdbc/lib/ojdbc8.jar"); // 根据实际驱动版本调整文件名
        if (!driverJar.exists()) {
            throw new IllegalStateException("未找到Oracle驱动：" + driverJar.getAbsolutePath());
        }

        // 动态加载驱动jar
        URLClassLoader loader = new URLClassLoader(new URL[]{driverJar.toURI().toURL()}, Thread.currentThread().getContextClassLoader());
        Class<?> driverClass = loader.loadClass("oracle.jdbc.OracleDriver");
        Driver driver = (Driver) driverClass.getDeclaredConstructor().newInstance();
        // 注册驱动到DriverManager
        java.sql.DriverManager.registerDriver(driver);
    }
}

3. 在应用主类的main方法开头调用OracleDriverLoader.load()即可。

为什么之前的方法没效果？ #

• Manifest添加路径：Manifest的Class-Path字段不支持解析环境变量，写$ORACLE_HOME只会被当作字符串路径，无法定位到实际目录。
• Maven system scope：systemPath要求必须是绝对路径，而你无法统一所有环境的$ORACLE_HOME位置，所以这个方式不适用。

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