Linux 下解決 java.lang.NoClassDefFoundError: magick/MagickException 類找不到問題

錯誤現象

Caused by: java.lang.NoClassDefFoundError: magick/MagickException

應用啟動或執行圖片壓縮任務時拋出上述異常，提示找不到 magick.MagickException 類。

原因分析

在 CentOS 6.3 環境中，已分別編譯安裝 ImageMagick-6.4.0-0.tar.gz 與 jmagick-6.4.0-src.tar.gz，但 Java 應用仍無法載入 JMagick 類。根本原因是 JVM 類路徑中缺少 jmagick.jar，導致類載入器找不到 magick 包下的所有類。

解決方案

1. 編譯 JMagick 原始碼後，在產出目錄（通常為 jmagick-6.4.0/target 或 build 目錄）找到 jmagick.jar。
2. 將該 JAR 複製到 JDK 擴展目錄：
   cp jmagick.jar /usr/local/jdk1.7.0_03/jre/lib/ext/
3. 重啟應用服務（Tomcat/Jetty 等），驗證錯誤是否消失。

補充說明

• 為何放入 ext 目錄？ JMagick 依賴原生庫 libjmagick.so，該庫通常安裝在系統庫路徑（/usr/local/lib）。放入 jre/lib/ext 可確保所有 JVM 進程自動載入，避免類路徑配置遺漏。
• 更佳實踐：生產環境建議將 jmagick.jar 納入專案依賴管理（Maven/Gradle），並通過 -Djava.library.path 顯式指定原生庫路徑，避免污染全局 JDK。
• 確認 libjmagick.so 存在於 java.library.path 包含的目錄中（如 /usr/lib、/usr/local/lib），若無則需執行 ldconfig 更新動態鏈接器緩存。