HOWTO · Java

Java no pudo inicializar la clase org.codehaus.groovy.vmplugin.v7.java7

Este tutorial demuestra el error de no poder inicializar la clase org.codehaus.groovy.vmplugin.v7.java7 en Java.

En esta página

El mensaje Could not initialize class org.codehaus.groovy.vmplugin.v7.java7 significa que Java no pudo terminar de inicializar el complemento de máquina virtual Java 7 de Groovy. Es un síntoma, no un diagnóstico: por sí solo, el mensaje no demuestra que falte Gradle, no identifica una incompatibilidad entre Java y Groovy ni prueba que la instalación esté dañada. En una compilación de Gradle, primero determina qué entorno de ejecución de Java y qué distribución de Gradle usa realmente el comando que falla. Cambia el wrapper del proyecto solo si las pruebas y los requisitos de compatibilidad de esas versiones lo justifican.

Qué significa este error

org.codehaus.groovy.vmplugin.v7.Java7 es el nombre exacto de la clase asociada al complemento. El java7 en minúsculas del error puede ser la forma en que se muestra el fallo de inicialización; por sí solo, no identifica la causa subyacente. Un error de inicialización de clase puede producirse después de un fallo anterior al cargar o inicializar una dependencia. Por lo general, la información útil está en la primera excepción y sus mensajes anidados Caused by, no solo en la última línea que imprime Gradle.

Gradle usa Groovy internamente, así que este error puede aparecer antes de que se ejecute el código del proyecto. Entre los aspectos que conviene investigar están el entorno de ejecución de Java seleccionado para la compilación, la versión de Gradle y la versión de Groovy que incluye, o un problema con las dependencias o el classpath. Trátalos como posibles pistas, no como causas confirmadas. No cambies un CLASSPATH global, no reinstales Groovy ni actualices Java basándote únicamente en este mensaje; primero recopila las versiones y los detalles del fallo que se indican a continuación.

Confirma qué Java y Gradle usa la compilación

Ejecuta las comprobaciones desde el mismo directorio, shell, contenedor, terminal del IDE o tarea de CI donde se produce el fallo. java -version informa sobre el comando de Java que encuentra el PATH de ese shell; puede diferir del entorno configurado en un IDE o servicio de compilación. Si el proyecto incluye Gradle Wrapper, usa su comando de versión para consultar la distribución y la JVM que informa el wrapper.

Ejecuta este ejemplo:

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

public class Main {
    public static void main(String[] args) {
        System.out.println("Java runtime: " + System.getProperty("java.version"));
    }
}
Java runtime: 17.0.20.1

Este código fuente está pensado para ejecutarse con la instalación de Java que quieres inspeccionar; el resultado depende de ese entorno. Informa sobre la JVM que ejecuta este programa, no sobre un proceso de Gradle independiente. Para inspeccionar la JVM de Gradle, consulta el informe de versión del wrapper.

Un valor ausente o en blanco es un caso límite que debes gestionar: no lo interpretes como una versión de Java ni adivines una. Esta ilustración independiente usa un valor de diagnóstico en blanco para mostrar esa rama:

public class Main {
    public static void main(String[] args) {
        String javaVersion = "";
        if (javaVersion == null || javaVersion.trim().isEmpty()) {
            System.out.println("Java runtime: unavailable");
        } else {
            System.out.println("Java runtime: " + javaVersion);
        }
    }
}
Java runtime: unavailable

En tu propio código de diagnóstico, sustituye el valor en blanco por el valor que devuelve realmente la fuente. Conserva la rama para valores no disponibles si esa fuente puede omitir el valor; que falte un dato de diagnóstico no demuestra que la JVM en ejecución carezca de versión.

En shells tipo Unix, ejecuta ./gradlew --version; en Windows, ejecuta gradlew.bat --version. Estos comandos usan el wrapper del proyecto. Un comando gradle --version instalado por separado informa sobre el Gradle del sistema y no sustituye al wrapper cuando la compilación fallida se inició con este. Guarda también toda la salida de la tarea exacta del wrapper que falla, incluida la primera excepción y todas las líneas Caused by.

Compara el entorno de ejecución de Java que usa Gradle con las versiones de Java admitidas por esa versión de Gradle en la tabla oficial de compatibilidad de Java de Gradle. Un número de versión por sí solo no demuestra que exista incompatibilidad ni identifica una solución; comprueba los requisitos de las versiones usadas en esta compilación. Si un IDE o ejecutor de CI inicia Gradle con un JDK configurado, verifica ese ajuste además del resultado de java -version en un shell.

Actualiza Gradle Wrapper

El wrapper fija una distribución de Gradle para el proyecto. Inspecciona gradle/wrapper/gradle-wrapper.properties y su distributionUrl; esa URL identifica la distribución que el wrapper descargará o usará. No edites el wrapper solo porque el nombre de la clase menciona Java 7 o porque la versión de Gradle del sistema sea distinta.

Si las comprobaciones de compatibilidad muestran que la versión de Gradle del wrapper no admite el entorno de ejecución de Java o los requisitos documentados de la compilación, elige una versión de Gradle que los cumpla. Actualiza el wrapper mediante el proceso habitual de actualización de Gradle del proyecto o, si la tarea del wrapper no está disponible, cambia con cuidado la versión de distribución en gradle-wrapper.properties. Limita el cambio al proyecto y revísalo según la política habitual del equipo para dependencias. La versión adecuada depende del entorno de ejecución de Java y de la compilación reales; este error por sí solo no permite elegirla.

Si el error persiste

Después de confirmar las versiones, vuelve a ejecutar la misma tarea del wrapper y conserva el fallo completo inicial. Sigue la primera causa pertinente del rastreo. Si señala una clase ausente o en conflicto, inspecciona la información de dependencias o del classpath de esa compilación concreta. Si apunta a un artefacto dañado en la caché, usa el procedimiento de actualización de caché o resolución de dependencias admitido por la compilación y compara el rastreo resultante. Reinstalar Groovy por separado no suele ser el primer paso en una compilación de Gradle, porque Gradle proporciona su propio entorno de ejecución de Groovy.

Comprueba que la tarea fallida usa la copia de trabajo del proyecto y los archivos del wrapper esperados, sobre todo en CI o en un repositorio multimódulo. Compara el directorio de trabajo, los scripts del wrapper, gradle-wrapper.properties y la selección de Java entre un entorno que falla y otro que funciona. Evita cambiar varias variables de entorno o versiones a la vez: así es más difícil determinar qué condición influyó. Si la primera causa todavía no señala un origen probable, conserva el rastreo e investiga esa causa en lugar de tratar el nombre final de la clase del complemento como una prueba.

Verifica la solución

Repite la tarea original con el mismo comando del wrapper y el mismo entorno en que falló. Después, vuelve a ejecutar ./gradlew --version o gradlew.bat --version y confirma que la distribución de Gradle y la JVM informadas coinciden con las versiones que querías probar. Que el informe de versión se ejecute correctamente no demuestra por sí solo que la compilación original esté corregida; la tarea original debe terminar sin el error de inicialización.

Si sigue fallando, compara la nueva primera excepción y sus causas anidadas con el rastreo guardado. Eso significa que el cambio intentado no resolvió el fallo observado y que hace falta seguir investigando. No des el problema por resuelto hasta que termine correctamente la misma tarea que lo puso de manifiesto.