NetBeans 專案明明程式碼沒問題,一按 Build 卻跳出 build-impl.xml:305: Compile failed,這是相當惱人的狀況,因為錯誤訊息完全沒說真正的原因是什麼。本文記錄一次實際的排查過程。
F:\項目\subversion\svn2010\jwebplus3\trunk\src\webplus3\webplus3\nbproject\build-impl.xml:868: The following error occurred while executing this line: F:\項目\subversion\svn2010\jwebplus3\trunk\src\webplus3\webplus3\nbproject\build-impl.xml:305: Compile failed; see the compiler error output for details. 構建失敗(總時間: 12 秒)
打開 build-impl.xml 找到 305 行,會看到 javac 任務的起始標籤:
<javac debug="@{debug}" deprecation="${javac.deprecation}" destdir="@{destdir}"
encoding="${source.encoding}" excludes="@{excludes}" executable="${platform.javac}"
fork="yes" includeantruntime="false" includes="@{includes}" source="${javac.source}"
srcdir="@{srcdir}" target="${javac.target}" tempdir="${java.io.tmpdir}">
也就是說,錯誤發生在 javac 這個 Ant 任務本身,而不是某一個 Java 檔案。往上翻同一個 sequential 區塊,會看到 javac 區段中夾著一整批 compilerarg:
<sequential>
<property location="${build.dir}/empty" name="empty.dir"/>
<mkdir dir="${empty.dir}"/>
<mkdir dir="@{apgeneratedsrcdir}"/>
<javac ... >
<src>
<dirset dir="@{gensrcdir}" erroronmissingdir="false">
<include name="*"/>
</dirset>
</src>
<classpath>
<path path="@{classpath}"/>
</classpath>
<span style="color:#ff0000">
<compilerarg line="${endorsed.classpath.cmd.line.arg}"/>
<-\-compilerarg line="${javac.compilerargs}"/-->
<compilerarg value="-processorpath"/>
<-\-compilerarg path="@{processorpath}:${empty.dir}"/-->
<compilerarg line="${ap.processors.internal}"/>
<-\-compilerarg value="-s"/-->
<-\-compilerarg path="@{apgeneratedsrcdir}"/-->
<compilerarg line="${ap.proc.none.internal}"/>
<customize/>
</span>
</javac>
</sequential>
問題就在這段。這些 compilerarg 主要與 Java 6 開始的註解處理器(Annotation Processing)機制有關:-processorpath、-s(指定產生原始碼的目錄)、ap.processors.internal 等。當專案的 JDK 版本、annotation processor 路徑(例如 JSR-269 的實作或某些框架的处理器)彼此不相容,或 processorpath 指向不存在的位置時,javac 就會在參數階段直接失敗,而 NetBeans 只把「Compile failed」丟到 305 行,真正的編譯器訊息被淹沒在上方輸出中。
把上面那一段 compilerarg 註解掉或直接刪除,只留 <customize/>:
<javac debug="@{debug}" deprecation="${javac.deprecation}" destdir="@{destdir}"
encoding="${source.encoding}" excludes="@{excludes}" executable="${platform.javac}"
fork="yes" includeantruntime="false" includes="@{includes}" source="${javac.source}"
srcdir="@{srcdir}" target="${javac.target}" tempdir="${java.io.tmpdir}">
...
<classpath><path path="@{classpath}"/</classpath>
<customize/>
</javac>
存檔後重新 Build,就成功了。
因為專案實際上沒有使用註解處理器,這批參數屬於多餘設定,移除後 javac 走標準編譯流程即可通過。
不過直接編輯 build-impl.xml 有個風險:這個檔案由 NetBeans 依專案設定自動產生,一旦在 IDE 中變更專案屬性或執行 Clean and Build,它會被重新生成而覆蓋你的修改。因此更穩妥的做法有兩種:
做法一:在 IDE 中關閉註解處理。專案屬性 → Build → Compiling,取消勾選「Enable Annotation Processing」,NetBeans 就不會產生這些 compilerarg。
做法二:把覆寫寫進 build.xml。NetBeans 的 build.xml 預設會 import build-impl.xml,且自訂目標優先。可在 build.xml 中覆寫 -javac-init 或 -pre-compile 之類的擴充點,避免直接改動自動產生的檔案。
最根本的方式:看真正的編譯器輸出。「Compile failed; see the compiler error output for details」這句話已經提示了——往上翻 NetBeans 的輸出視窗,javac 的實際錯誤(找不到符號、package 不存在、annotation processor 拋例外等)都寫在 305 行之前。先讀那段訊息,通常比猜 build-impl.xml 快得多。