仅当MinGW路径加入PATH时才能加载DLL的问题求助

问题根源 #

你的MyProgram_Native.dll是通过MinGW编译生成的，它依赖MinGW提供的C++运行时动态库（例如libstdc++-6.dll、libgcc_s_seh-1.dll等）。这些库不在Windows默认的系统PATH中：

• 你本地电脑因为安装了MinGW，系统PATH包含C:\msys64\mingw64\bin，所以能自动找到这些依赖库；
• 同事电脑未配置该PATH路径，系统无法定位依赖库，因此抛出java.lang.UnsatisfiedLinkError。

解决方案 #

1. 静态链接MinGW运行时库（推荐） #

修改编译命令，添加静态链接参数，将MinGW的运行时库直接打包到DLL中，彻底消除对外部库的依赖：

# 编译目标文件
g++ -c -I"%JAVA_HOME%/include" -I"%JAVA_HOME%/include/win32" -m64 -fPIC MyProgram.cpp -o MyProgram.o

# 编译动态库时添加静态链接参数
g++ -shared -m64 -static-libgcc -static-libstdc++ -o MyProgram_Native.dll MyProgram.o -Wl,-add-stdcall-alias

注意：如果你的C++代码还依赖其他第三方动态库，此方法仅解决MinGW自身的运行时依赖，第三方库的依赖需单独处理。

2. 打包依赖库到插件目录 #

• 用工具（如VS自带的dumpbin或Dependency Walker）查看MyProgram_Native.dll的依赖项，找出所有MinGW相关的动态库；
• 从你的MinGW安装目录C:\msys64\mingw64\bin中复制这些依赖库，放到插件的DLL所在目录（即plugins/MyPlugin/）；
• 系统加载DLL时会优先从DLL所在目录查找依赖，无需依赖系统PATH。

3. 代码中临时注入MinGW路径（不推荐） #

在加载DLL前，将MinGW的bin目录临时添加到系统PATH中：

private static final String DLL_PATH = System.getProperty("user.dir") + 
"\\plugins\\MyPlugin\\MyProgram_Native.dll";

static {
    logger = new LogManager();
    logger.addInfo("Attempting to load .dll");

    try {
        // 临时添加MinGW路径到系统PATH
        String mingwBinPath = "C:\\msys64\\mingw64\\bin";
        String currentPath = System.getenv("PATH");
        System.setProperty("PATH", mingwBinPath + ";" + currentPath);
        
        logger.addVariable("DLL_PATH", DLL_PATH);
        System.load(DLL_PATH);
        logger.addInfo(".dll loaded successfully");
    } catch (Throwable exc) {
        logger.addInfo(".dll loading error message:", exc.toString());
    }
}

缺点：依赖固定的MinGW安装路径，若同事电脑的MinGW位置不同则失效，且不够优雅。

验证方法 #

编译完成后，用Dependency Walker打开MyProgram_Native.dll，检查是否仍存在未解决的MinGW运行时依赖，确认解决方案生效。

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