Что такое проблема N+1 запросов и как её решать?

Механизм. ORM загружает список сущностей одним запросом, а связи (order.getCustomer(), order.getItems()) помечены ленивыми и подгружаются при первом обращении. Код проходит по списку в цикле — и на каждой итерации идёт отдельный запрос. В шаблоне или сериализаторе JSON это происходит незаметно.

Почему плохо: каждый запрос — обход по сети и разбор, даже быстрый; сотни запросов на страницу дают сотни миллисекунд и нагружают базу.

Как найти:

• включить лог SQL (spring.jpa.show-sql, p6spy, datasource-proxy) и посмотреть на повторяющиеся запросы;
• в тестах проверять число запросов (Hypersistence Utils, assertSelectCount);
• APM-трассировка показывает десятки одинаковых спанов.

Как лечить:

• JOIN FETCH в JPQL — связь загружается одним запросом с JOIN;
• @EntityGraph — описать, какие связи загрузить для конкретного запроса;
• пакетная загрузка — hibernate.default_batch_fetch_size = 50: связи для 50 сущностей подгружаются одним запросом с IN (...);
• DTO-проекции — выбрать ровно нужные поля одним запросом.

Ловушки: JOIN FETCH двух коллекций — декартово произведение (MultipleBagFetchException); JOIN FETCH коллекции с setMaxResults — Hibernate загрузит всё и пагинирует в памяти (предупреждение HHH000104).

// N+1: запрос за заказами + по запросу на клиента каждого заказа
for (Order o : orderRepo.findAll()) log.info(o.getCustomer().getName());

// один запрос
@Query("select o from Order o join fetch o.customer")
List<Order> findAllWithCustomer();