NoClassDefFoundError cuando la clase sí que se encuentra

La documentación oficial de la clase java.lang.NoClassDefFoundError nos dice que esta excepción se lanza cuando la máquina virtual intenta cargar la definición de una clase, pero esta definición no se encuentra. Esto indica que cuando el programa se compiló, la clase estaba presente, pero en la ejecución ya no está.

Si al ejecutar una aplicación nos salta esta excepción, al leer esto enseguida pensamos en problemas de classpath o de empaquetamiento, y nos ponemos como locos a comprobar si el jar está bien construido, si están todos los jars, si tenemos bien definido el classpath, etc. Pero a veces, por mucho que busquemos no encontramos ningún error ahí. Es más, es especialmente desconcertante cuando la clase supuestamente desaparecida, está en el mismo jar que la clase que la busca y no la encuentra.

¿Qué puede estar ocurriendo? Bien, hay un motivo por el que la máquina virtual puede lanzar una java.lang.NoClassDefFoundError, aunque encuentre la clase: durante la inicialización estática de la misma. Imaginemos la siguiente clase:

public class SomeClass {
    
    public static final int SOME_CONSTANT = precalculateSomeValue();
    
    static {
        initializeSomething();
    }
 
    // (...)   
 
}

Si durante la ejecución del método precalculateSomeValue() o de initializeSomething(), se lanzara una excepción, la clase que hace referencia a SomeClass (y que ha «disparado» la inicialización), lanzará una NoClassDefFoundError. Fijaos que en este caso, la clase sí que ha sido localizada correctamente por la máquina virtual. El problema no es que no la haya encontrado, sino que no la ha podido inicializar.