Error @Override en Eclipse: cómo vencer "Must Override a Superclass Method"

Introducción: ¿por qué Eclipse te grita?

Importaste un proyecto ajeno en Eclipse, presionaste Build y, de repente, decenas de cruces rojas. Error: "Must Override a Superclass Method". ¿Te suena? Si estás aprendiendo a programar en Java o trabajas con código de otros, esta situación es un verdadero fastidio. Especialmente cuando el proyecto se compilaba perfectamente en otro IDE o mediante Maven.

En Stack Overflow, esta pregunta ha acumulado miles de visitas. Y no es para menos: el problema es engañoso. Eclipse es un entorno potente, pero su configuración del compilador puede jugarte una mala pasada. En este artículo, analizaremos de dónde proviene el error "Must Override a Superclass Method" y, lo más importante, cómo solucionarlo de una vez por todas.

Veremos tres causas principales y proporcionaremos instrucciones paso a paso con ejemplos de código reales. Aprenderás a configurar Eclipse para que no se queje del código correcto y cómo evitar este problema en el futuro.

¿Qué significa el error "Must Override a Superclass Method"?

El error aparece cuando usas la anotación @Override antes de un método que, según Eclipse, no sobrescribe un método de la clase padre o interfaz. En realidad, el problema no suele estar en tu código, sino en la configuración del compilador de Java en Eclipse.

La anotación @Override se introdujo en Java 5 (1.5) para métodos que sobrescriben métodos de una superclase. Pero en Java 6 se permitió su uso también para métodos que implementan interfaces. Si tu proyecto está configurado para Java 5 y escribes código para Java 8, Eclipse se quejará.

Aquí tienes un ejemplo típico que provoca el error:

public interface Animal {\n    void makeSound();\n}\n\npublic class Dog implements Animal {\n    @Override\n    public void makeSound() {\n        System.out.println("Woof!");\n    }\n}\n

Si el nivel de compilación del proyecto es Java 5, Eclipse dirá: "Must Override a Superclass Method". Aunque el código es absolutamente correcto para Java 6 y superiores.

Causa 1: Nivel de compilación incorrecto (Compiler Compliance Level)

Esta es la causa más común. Eclipse tiene una configuración llamada Compiler compliance level, que determina qué versión de Java espera. Si importas un proyecto creado en otro IDE, esta configuración suele quedar desactualizada.

Cómo solucionarlo:

\n
1. Haz clic derecho sobre el proyecto → Properties.
\n
2. Ve a Java Compiler.
\n
3. Desmarca la casilla "Use compliance from execution environment".
\n
4. Selecciona el Compiler compliance level — por ejemplo, 1.8 o 11 (según tu proyecto).
\n
5. Presiona Apply and Close.
\n
6. Reconstruye el proyecto: Project → Clean.
\n

Importante: Si tienes varios JDK instalados, asegúrate de que en Installed JREs (Window → Preferences → Java → Installed JREs) esté especificada la versión correcta. De lo contrario, Eclipse podría no encontrar el compilador adecuado.

Causa 2: La biblioteca JRE System Library no coincide con el nivel de compilación

A veces, el proyecto tiene configurada una biblioteca JRE System Library de una versión antigua (por ejemplo, J2SE-1.4), mientras que en el código usas anotaciones de Java 5+. Eclipse detecta esta discrepancia y genera el error.

Cómo solucionarlo:

\n
1. Haz clic derecho sobre el proyecto → Build Path → Configure Build Path.
\n
2. Ve a la pestaña Libraries.
\n
3. Busca JRE System Library.
\n
4. Elimínala (botón Remove).
\n
5. Presiona Add Library → JRE System Library → Next.
\n
6. Selecciona Workspace default JRE (o la versión de JDK que necesites).
\n
7. Presiona Finish y luego Apply and Close.
\n
8. Reconstruye el proyecto: Project → Clean.
\n

Causa 3: Proyecto configurado con un JRE en lugar de un JDK

Eclipse necesita un JDK (Java Development Kit) para compilar código, no solo un JRE (Java Runtime Environment). Si el proyecto está configurado para usar un JRE, es posible que falten herramientas de compilación y se generen errores extraños.

Cómo solucionarlo:

\n
1. Ve a Window → Preferences → Java → Installed JREs.
\n
2. Asegúrate de que haya un JDK agregado (no solo un JRE). Si no, presiona Add y selecciona la carpeta del JDK.
\n
3. En las propiedades del proyecto (Build Path → Libraries), reemplaza el JRE por el JDK.
\n

Conclusión: el error es fácil de solucionar

El error "Must Override a Superclass Method" en Eclipse parece aterrador, pero en la mayoría de los casos se soluciona ajustando la configuración del compilador. Recuerda los tres pasos principales:

\n
• Verifica el Compiler compliance level en las propiedades del proyecto.
\n
• Asegúrate de que la JRE System Library coincida con la versión de Java que usas.
\n
• Usa un JDK en lugar de un JRE.
\n

Después de estos ajustes, limpia y reconstruye el proyecto. En el 99% de los casos, el error desaparecerá. Si el problema persiste, busca en Stack Overflow con las palabras clave de este artículo; seguro encuentras una solución para tu caso específico.

¡Buena suerte con tu código y que Eclipse deje de gritarte!