Java Classpath 實戰故障排查：相對路徑陷阱與三種解決方案

案例背景

執行 Run 類別時拋出 NoClassDefFoundError: org/apache/wsif/WSIFException，雖然 JAR 檔存在，但 JVM 找不到。根因：Classpath 使用相對路徑，導致執行工作目錄不同時路徑失效。

環境資訊

• 類別：localJava.client.dynamic.Run
• 依賴 JAR：wsif.jar (位於 C:\wsif\lib)
• 類別實際位置：C:\wsif\build\samples\localjava\client\dynamic\Run.class
• 執行指令：java localjava.client.dynamic.Run samples/localjava/AddressBook.wsdl (於 C:\wsif\build\samples 下執行)

錯誤原因分析

Classpath 設定為相對路徑 lib\wsif.jar。JVM 依據當前工作目錄解析相對路徑。若工作目錄非預期位置，JAR 即找不到。

三種解決方案

方案一：改用絕對路徑 (最推薦)

環境變數 CLASSPATH 直接寫完整路徑：

CLASSPATH=.;C:\wsif\lib\wsif.jar;C:\wsif\lib\other.jar;...

優點：不受工作目錄影響，穩定可靠。

方案二：使用 -cp 參數指定運行時 classpath

cd C:\wsif
java -cp %CLASSPATH%;build\samples localjava.client.dynamic.Run samples/localjava/AddressBook.wsdl

• build\samples：指定 Run.class 所在包的根目錄 (即 localjava 的上層)
• 相對路徑寫法：.\build\samples 或 ..\wsif\build\samples

cd C:\wsif\build\samples
java -cp "C:\wsif\lib\wsif.jar;C:\wsif\lib\other.jar;." localjava.client.dynamic.Run samples/localjava/AddressBook.wsdl

@echo off
set CP=C:\wsif\lib\wsif.jar;C:\wsif\lib\cstools.jar;C:\wsif\build\samples
java -cp %CP% localjava.client.dynamic.Run samples/localjava/AddressBook.wsdl