DIV CSS 佈局教程網

NetBeans 編譯失敗 build-impl.xml:305: Compile failed 的解法
編輯:JavaScript綜合知識     

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 秒)

305 行到底是什麼

打開 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

把上面那一段 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 快得多。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved