Как решить проблему NullPointerException в методе контроллера при работе с параметрами?

Что проверяют

Знаете ли вы, откуда в контроллере берётся null: из отсутствующего параметра, из пустого поля в теле запроса или из сервиса. И умеете ли отсекать его на входе с ответом 400, а не 500. Следом спрашивают про валидацию и глобальную обработку ошибок.

Как отвечать

Сначала найдите место. С Java 15 подробные сообщения NPE (JEP 358) включены по умолчанию: в стектрейсе написано, какое выражение оказалось null, например because the return value of "UserDto.getName()" is null.

Типичные источники в Spring MVC:

• @RequestParam: по умолчанию required = true, без параметра Spring сам вернёт 400 через MissingServletRequestParameterException. NPE появляется, когда поставили required = false и не проверили. Варианты: defaultValue, Optional<String> в параметре или явная проверка;
• примитивы: int page с required = false без параметра падает, потому что null нельзя положить в int. Берут Integer или defaultValue;
• @RequestBody: поля DTO приходят null, если клиент их не прислал. Лечится Bean Validation: @NotNull, @NotBlank на полях и @Valid на параметре. Ошибка превращается в MethodArgumentNotValidException, то есть в 400 с описанием полей;
• автораспаковка: Integer из DTO сравнивают через == с int или передают туда, где ждут примитив;
• сервис вернул null: пусть репозиторий отдаёт Optional, а контроллер решает, что вернуть, например 404 через orElseThrow.

Ответы на ошибки собирают в одном месте через @RestControllerAdvice и @ExceptionHandler, а контракт на null помечают аннотацией @Nullable (свежие версии Spring используют аннотации JSpecify).

Где спотыкаются

Ловят NullPointerException в try/catch и пишут в лог. Это прячет ошибку в коде, а клиент всё равно получает невнятный ответ.

Считают, что @NonNull сам защищает. Аннотации JSpecify или JetBrains это подсказка для IDE и анализаторов, в рантайме они ничего не проверяют. Исключение составляет @NonNull из Lombok: он генерирует проверку, которая бросает всё тот же NPE.

Заворачивают в Optional поля DTO и параметры сервисов. Он задуман как тип возвращаемого значения, в полях и сериализации только мешает.