加载32位pcseclj.dll遇UnsatisfiedLinkError错误的解决咨询

问题 #

加载pcseclj.dll时触发java.lang.UnsatisfiedLinkError错误，提示“操作系统无法运行%1”。相关信息如下：

• 32位DLL路径：C:\Program Files (x86)\IBM\Personal Communications\pcseclj.dll
• 已使用32位JDK

相关Java代码 #

package ibm;

import java.util.Properties;

import com.ibm.eNetwork.ECL.ECLErr;
import com.ibm.eNetwork.ECL.ECLSession;

public class connect {
    
    public static void main(String[] args) throws InterruptedException {
        try {
            System.loadLibrary("pcseclj");
            Properties prop = new Properties();
            // prop.put("SESSION_VT_LOCAL_ECHO ", "true");
 
            //prop.put("SESSION_HOST", "local");
            //prop.put("SESSION_PORT", "992");
            prop.put("SESSION_WIN_STATE", "MAX");
            prop.put("SESSION_VT_KEYPAD ", "SESSION_VT_KEYPAD_APPL");
            prop.put("SESSION_VT_LOCAL_ECHO", "SESSION_VT_LOCAL_ECHO_ON");
 
            ECLSession session = new ECLSession(prop);
 
            session.StartCommunication();
            Thread.sleep(5000);
            session.connect();
 
        } catch (ECLErr err) {
            System.out.println("ECL Error!  " + err.GetMsgText());
        }
    }
}

错误堆栈信息 #

Exception in thread "main" java.lang.UnsatisfiedLinkError: C:\Program Files (x86)\IBM\Personal Communications\pcseclj.dll: The operating system cannot run %1
    at java.base/java.lang.ClassLoader$NativeLibrary.load0(Native Method)
    at java.base/java.lang.ClassLoader$NativeLibrary.load(ClassLoader.java:2450)
    at java.base/java.lang.ClassLoader$NativeLibrary.loadLibrary(ClassLoader.java:2506)
    at java.base/java.lang.ClassLoader.loadLibrary0(ClassLoader.java:2705)
    at java.base/java.lang.ClassLoader.loadLibrary(ClassLoader.java:2667)
    at java.base/java.lang.Runtime.loadLibrary0(Runtime.java:830)
    at java.base/java.lang.System.loadLibrary(System.java:1890)
    at ibm.connect.main(connect.java:14)

解决方法 #

• 检查DLL依赖项：用32位版本的dumpbin /dependents pcseclj.dll（Visual Studio自带工具）或Dependency Walker扫描该DLL，确认所有依赖的32位系统库、第三方库都存在且可访问。“无法运行%1”通常意味着缺少某个依赖DLL。
• 匹配JDK版本：确认32位JDK版本与IBM Personal Communications版本兼容，部分旧版PC不支持Java 11+，可尝试降级到Java 8 32位版本测试。
• 配置系统PATH：将C:\Program Files (x86)\IBM\Personal Communications添加到系统环境变量PATH中，确保JVM能找到该DLL及其依赖库。
• 使用绝对路径加载：替换System.loadLibrary("pcseclj")为System.load("C:\\Program Files (x86)\\IBM\\Personal Communications\\pcseclj.dll")，直接指定完整路径避免加载路径问题。
• 修复PC安装：重新安装或修复IBM Personal Communications，确保所有组件（含相关DLL）安装完整、无损坏。
• 提升运行权限：以管理员身份启动IDE或命令行，运行Java程序，避免权限不足导致的DLL加载失败。

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