Java 編譯錯誤：方法必須覆寫超類別方法的解決方案

團隊協作開發中，常遇到同事提交程式碼後，本地更新專案卻編譯失敗，報錯：The method getPOIByName(String) of type POISearchByGeoway must override a superclass method。這類問題通常源於 JDK 版本與編譯器相容性設定不一致。本文詳細說明錯誤成因與 Eclipse/IntelliJ IDEA 中的快速修正步驟。

一、錯誤成因分析

@Override 註解在 Java 5 僅允許標註「覆寫父類別方法」；Java 6 起擴展支援「實作介面方法」。若專案原始碼使用 Java 6+ 語法（介面方法加 @Override），但編譯器相容性設定為 1.5，編譯器會誤判為「必須覆寫超類別方法」而報錯。

二、Eclipse 修正步驟

方法一：專案層級設定（推薦）

1. 右鍵專案 → Properties → Java Compiler
2. 取消勾選 Use compliance from execution environment
3. 將 Compiler compliance level 設為 1.6 或更高（如 1.8、11、17）
4. 點選 Apply and Close，專案自動重新編譯

方法二：全域 Workspace 設定

1. 選單 Window → Preferences
2. 展開 Java → Compiler
3. 同樣將 Compiler compliance level 提升至 1.6+
4. 此設定影響 Workspace 內所有專案

三、IntelliJ IDEA 修正步驟

1. File → Project Structure (Ctrl+Alt+Shift+S)
2. 左側選 Project，將 Project language level 設為 8 - Lambdas, type annotations etc. 或更高
3. 左側選 Modules → Sources 分頁，確認 Language level 同步
4. 若使用 Maven/Gradle，同步 pom.xml 或 build.gradle 中的 maven.compiler.source/target 版本

四、Maven/Gradle 專案統一版本最佳實踐

<!-- pom.xml -->
<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

// build.gradle
java {
    sourceCompatibility = JavaVersion.VERSION_1_8
    targetCompatibility = JavaVersion.VERSION_1_8
}

配置後執行 mvn clean compile 或 gradle clean compileJava，IDE 會自動同步編譯器版本，徹底避免團隊成員環境不一致導致的編譯錯誤。

五、總結

• 錯誤本質：@Override 用於介面實作方法，需 Java 6+ 編譯器支援。
• 核心解法：將 Compiler Compliance Level 升級至 1.6 或更高。
• 團隊協作建議：在建構工具中鎖定 Java 版本，避免 IDE 設定差異。