El origen del problema: Compilación con JDK incompatible
El error java.lang.UnsupportedClassVersionError ocurre cuando el bytecode de una aplicación fue compilado con una versión de JDK superior a la soportada por el entorno de ejecución de WebLogic. Ejemplo común: compilar con JDK 11 e intentar desplegar en un servidor configurado con JDK 8.
Paso 1: Verificación de versiones activas
1.1. En la consola de administración
Acceda a Environment > Servers y seleccione su servidor. En la pestaña Configuration > Server Start, revise los valores de JAVA_HOME.
1.2. Mediante línea de comandos
Ejecute en cada nodo:
java -version
Y para WebLogic específicamente:
${DOMAIN_HOME}/bin/setDomainEnv.sh | grep "JAVA_VENDOR|JAVA_HOME"Paso 2: Modificación de variables de entorno
2.1. Edición de scripts de inicio
Localice y edite según su sistema operativo:
- Unix/Linux:
${DOMAIN_HOME}/bin/setDomainEnv.sh - Windows:
%DOMAIN_HOME%binsetDomainEnv.cmd
Modifique o agregue:
export JAVA_HOME=/ruta/nueva/jdk1.8.0_291
export PATH=${JAVA_HOME}/bin:${PATH}2.2. Configuración específica por nodo
Para nodos administrados, edite startManagedWebLogic.sh o su equivalente, asegurando coherencia con el AdminServer.
Paso 3: Reinicio limpio del servidor
- Detenga todos los servidores del dominio:
${DOMAIN_HOME}/bin/stopWebLogic.sh - Elimine archivos temporales en
${DOMAIN_HOME}/servers/{SERVER_NAME}/tmp - Inicie el AdminServer:
${DOMAIN_HOME}/bin/startWebLogic.sh - Verifique el cambio con:
ps -ef | grep java(Linux/Unix)
FAQs: Preguntas frecuentes
¿Puedo configurar diferentes JDKs por aplicación?
Sí, mediante el archivo weblogic-application.xml usando <package-name> y directivas específicas. Consulte la documentación oficial.
¿Cómo verificar la versión de compilación de un archivo .war/.ear?
Use el comando:
javap -verbose MyClass.class | grep "major"
¿WebLogic 12.2.1.4 soporta JDK 11?
Solo parcialmente para desarrollo. Para producción, se requiere WebLogic 14.1.1+ con JDK LTS. Revise la matriz de compatibilidad.
Samuel Gil es especialista en infraestructura tecnológica, administración de servidores y desarrollo de servicios digitales. Con una sólida trayectoria en entornos web de alta exigencia, optimización de servidores y gestión de arquitecturas de red, Samuel dedica su labor en faq-box.com a desglosar cuestiones técnicas complejas para convertirlas en guías prácticas, transparentes y de alto valor técnico.
Su enfoque editorial prioriza el rigor, la seguridad en los sistemas y la resolución eficiente de problemas técnicos cotidianos y avanzados. A través de sus análisis, busca ofrecer respuestas directas y contrastadas para profesionales y entusiastas del sector tecnológico.
Cuenta con una sólida formación en el área tecnológica, destacando su especialización a través del Máster en Inteligencia Artificial Aplicada a la Gestión Empresarial y el MBA in Digital Transformation & Artificial Intelligence de ISEEN.EU, lo que aporta un rigor técnico avanzado a cada análisis de desarrollo y arquitectura digital.
