Hadoop Jar 執行報錯：ClassNotFoundException 實為缺少 package 聲明導致

問題現場

類名為 LogCleanJob，使用 hadoop jar 提交任務時拋出 ClassNotFoundException。網上多建議檢查 classpath 或 Jar 包依賴，但經排查環境變量與依賴均正常。

根因定位

源碼文件頂部錯誤保留了 package 聲明，導致編譯生成的 class 文件路徑與執行時期待的不一致。Hadoop 預期主類在預設包（無 package）或與提交命令一致的包結構下。

解決方案

1. 刪除源碼中的 package com.xxx.yyy; 行。
2. 重新編譯打包：javac LogCleanJob.java && jar cvf logclean.jar LogCleanJob.class
3. 重新提交：hadoop jar logclean.jar LogCleanJob

原理說明

• Java 類的完整限定名 = package名 + 類名。
• 無 package 聲明時，類屬於 無名包（default package），限定名即簡單類名。
• Hadoop 的 jar 命令通過反射載入主類，若包名不匹配則找不到類。

最佳實踐

1. MapReduce 主類建議放在無名包，避免包路徑麻煩。
2. 若必須使用包，打包時保持目錄結構，提交命令需用完整限定名：hadoop jar my.jar com.pkg.MainClass
3. 使用 Maven/Gradle 打包時，配置 Main-Class 與 manifest，減少手動錯誤。

一行多餘的 package 聲明，浪費數小時排查 —— 大數據開發中，細節決定成敗。