NullPointerException в Java: как найти null и исправить ошибку

NullPointerException возникает, когда Java пытается обратиться к полю, методу или элементу через ссылку, в которой находится null. Откройте первую строку stack trace, относящуюся к вашему коду, и разберите выражение слева направо. Цель не просто добавить if (x != null), а понять, почему обязательное значение не появилось или почему отсутствие значения не обработано.

Типичная строка выглядит безобидно: user.getName().trim(). Но в ней есть минимум две ссылки: user и результат getName(). Любая может быть null. Сообщение Java указывает файл и номер строки, однако не всегда автоматически объясняет бизнес-причину: пользователь не найден, поле не заполнено или метод нарушил обещание.

Что такое null и какие операции вызывают исключение

null означает, что ссылочная переменная не указывает на объект. Это не пустая строка, не число ноль и не пустой список. Исключение появляется в момент разыменования ссылки: вызова метода, чтения поля, определения длины массива, обращения к элементу массива или синхронизации. Простое сравнение ссылки с null допустимо и само по себе не падает.

Исключение появляется не при хранении null, а при операции через отсутствующий объект.

Читаем stack trace и уменьшаем проблемное выражение

Stack trace читают сверху вниз до первого упоминания своего класса. Верхняя строка сообщает тип исключения, следующие показывают цепочку вызовов. Найдя файл и номер, вынесите промежуточные результаты в отдельные переменные. Это временно делает код длиннее, зато отладчик и вывод сразу показывают, где появился null.

record User(String name) {}

public class Main {
    static String displayName(User user) {
        String rawName = user.name();   // user может быть null
        String cleanName = rawName.trim(); // rawName может быть null
        return cleanName.toUpperCase();
    }

    public static void main(String[] args) {
        User user = new User(null);
        System.out.println(displayName(user));
    }
}

// Пример указателя:
// Exception in thread "main" java.lang.NullPointerException
//   at Main.displayName(Main.java:6)
//   at Main.main(Main.java:12)

Начинайте с верхнего кадра своего класса: он сокращает область поиска до конкретного выражения.

Выбираем исправление по смыслу данных

Универсального оператора против null нет. Если значение обязательно, отвергните неверные данные как можно раньше. Если отсутствие допустимо, задайте явную ветку или запасное значение. Если метод поиска закономерно может ничего не найти, его контракт должен это выражать. Важен не синтаксис проверки, а понятное обещание вызывающему коду.

Практика: исправляем отображаемое имя пользователя

Допустим, имя в профиле может быть пропущено, но сам объект пользователя обязателен. Тогда метод должен отдельно защитить эти два правила: быстро отклонить null вместо User и превратить пустое имя в подпись «Гость». После исправления проверьте нормальное имя, пробелы, null-поле и null-объект.

Правильное решение зависит от контракта: запретить, обработать или выразить отсутствие.

Какие исправления маскируют NullPointerException

Быстрый патч иногда убирает текущий stack trace, но оставляет повреждённые данные. Особенно опасны проверки, которые просто прекращают работу метода, и широкие блоки catch. Через несколько шагов программа падает в другом месте, где связь с исходной причиной уже потеряна. Чините точку появления неверного состояния.