分发含jacob依赖的Jar文件时DLL加载问题求解决方案

核心思路 #

不需要将DLL放入需要管理员权限的JRE目录，直接将DLL与程序JAR、Jacob的JAR放在同一目录，程序启动时自动定位并加载指定路径的DLL（利用System.load()方法支持绝对路径加载的特性）。

步骤1：准备分发文件 #

将以下文件放在同一文件夹中：

• 你的程序JAR文件（比如OutlookMailTool.jar）
• jacob-1.18.jar
• jacob-1.18-x64.dll（如需兼容32位系统，额外准备jacob-1.18-x86.dll）

步骤2：添加DLL加载代码 #

在程序入口类的最开始执行DLL加载逻辑，确保后续Jacob相关操作能正常运行。

通用加载工具类 #

import java.io.File;
import java.net.URL;
import java.net.URLDecoder;

public class JacobDLLLoader {
    public static void load() {
        try {
            // 获取当前程序JAR的所在目录
            URL jarLocation = JacobDLLLoader.class.getProtectionDomain().getCodeSource().getLocation();
            String jarPath = URLDecoder.decode(jarLocation.getPath(), "UTF-8");
            File jarDirectory = new File(jarPath).getParentFile();
            
            // 根据系统位数选择对应DLL
            String dllFileName = is64BitSystem() ? "jacob-1.18-x64.dll" : "jacob-1.18-x86.dll";
            File dllFile = new File(jarDirectory, dllFileName);
            
            if (dllFile.exists()) {
                // 加载指定绝对路径的DLL
                System.load(dllFile.getAbsolutePath());
                System.out.println("Jacob DLL加载成功：" + dllFile.getAbsolutePath());
            } else {
                throw new RuntimeException("未找到Jacob DLL文件，请确保" + dllFileName + "与程序JAR在同一目录");
            }
        } catch (Exception e) {
            throw new RuntimeException("加载Jacob DLL失败：" + e.getMessage(), e);
        }
    }

    // 判断系统是否为64位
    private static boolean is64BitSystem() {
        String systemArch = System.getProperty("os.arch");
        return systemArch.contains("64");
    }
}

程序入口调用 #

在main方法开头调用加载方法：

import com.jacob.activeX.ActiveXComponent;

public class OutlookMailApp {
    public static void main(String[] args) {
        // 优先加载DLL
        JacobDLLLoader.load();
        
        // 后续业务逻辑：打开Outlook HTML邮件
        ActiveXComponent outlookApp = new ActiveXComponent("Outlook.Application");
        // 示例：创建新邮件并设置HTML内容
        ActiveXComponent mailItem = new ActiveXComponent(outlookApp.invoke("CreateItem", 0).toDispatch());
        mailItem.setProperty("Subject", "测试HTML邮件");
        mailItem.setProperty("HTMLBody", "<h1>这是HTML格式的邮件内容</h1><p>测试段落</p>");
        mailItem.invoke("Display");
        
        // 释放资源（可选）
        mailItem.safeRelease();
        outlookApp.safeRelease();
    }
}

步骤3：给用户的运行方式 #

为了让用户无需手动输入命令行，创建一个批处理文件（比如启动程序.bat），内容如下：

@echo off
java -cp "*.jar" OutlookMailApp
pause

用户只需双击这个批处理文件即可运行程序，无需关心路径配置。

关键说明 #

• System.load()与System.loadLibrary()的区别：前者支持直接加载绝对路径的DLL，后者依赖java.library.path环境变量，这是避开管理员权限的核心；
• 路径编码处理：URLDecoder用于解决路径中包含空格或特殊字符时的编码问题；
• 系统位数兼容：通过os.arch属性判断系统位数，自动选择对应DLL，提升兼容性。

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