Número de comprobaciones de null

Actualizado el 15 de noviembre de 2026

Sigla NULL
Aspecto «Complejidad»
Se mide en método
Tipo de valor recuento (entero, mínimo 0)
Dirección informativa: ni alto ni bajo es mejor
Stau Metro NumNullChecks

En pocas palabras

Cuenta las veces que un método compara algo con null usando == o !=. Muchas comprobaciones suelen indicar que nadie tiene claro quién garantiza que un valor existe, y que cada método se protege por su cuenta.

Qué mide

Cuánto código defensivo contra null hay en un método. Cada comprobación es una decisión más que probar (con valor y sin él) y, repetida en muchos métodos, es una señal de que el diseño no fija en un solo sitio qué referencias pueden ser nulas. Se reduce con tipos que expresan la ausencia (Optional), con anotaciones de nulabilidad, con colecciones vacías en lugar de null y con objetos nulos.

Cómo se calcula

Se suma 1 por cada operando que sea el literal null en una expresión con == o !=.

Ejemplo

boolean same(Object a, Object b) {
    if (a == null || b == null) {   // +2: a == null, b == null
        return a == b;              // 0: no hay literal null
    }
    return a != null;               // +1
}

Total: 3. El if y el || que rodean las dos primeras comprobaciones suman en la «complejidad ciclomática»; la del último return no suma allí, porque no decide nada.

Cómo interpretarla

No tiene umbrales. Compáralo con el «tamaño del método»: tres comprobaciones en un método de tres líneas son mucho más que tres en uno de cincuenta. Mira especialmente los métodos que lo repiten en cascada (a != null && a.b() != null && …), que suelen indicar un valor que debería ser obligatorio.

Relación con otras métricas

En las herramientas

Stau Metro (NumNullChecks, a nivel de método). Cuenta los operandos que son el literal null en expresiones con == o !=; null == null suma 2. No cuenta las comparaciones entre variables que valgan null, las llamadas a Objects.isNull, Objects.requireNonNull o Optional, ni case null en un switch, ni un null escrito entre paréntesis (x == (null)). En o == null || i == 0 suma 1. Incluye lo que haya en lambdas y en clases anónimas o locales declaradas en el método. No se calcula para los métodos abstractos.

CK (herramienta de Aniche). Su comparisonsQty cuenta «el número de comparaciones (es decir, == y !=)», todas, no solo las que tienen null.

Referencias