С какими проблемами сталкивался в Hibernate

Проблемы при работе с Hibernate

Я встречался с множеством подводных камней Hibernate в production-системах. Вот самые частые и опасные из них.

1. N+1 SELECT Problem (Самая частая)

Это не ошибка, а архитектурная проблема нетерпеливой загрузки ассоциаций:

@Entity
public class User {
    @OneToMany(fetch = FetchType.EAGER)
    private List<Order> orders;
}

public List<User> getAllUsers() {
    return userRepository.findAll();
}

Загружает 1 запрос для пользователей + N запросов для каждого заказа.

Решение 1: Fetch JOIN

@Query("SELECT DISTINCT u FROM User u LEFT JOIN FETCH u.orders")
List<User> findAllWithOrders();

Решение 2: @NamedEntityGraph

@Entity
@NamedEntityGraph(
    name = "User.withOrders",
    attributeNodes = @NamedAttributeNode("orders")
)
public class User { }

Решение 3: Batch fetch

@OneToMany(fetch = FetchType.LAZY)
@BatchSize(size = 10)
private List<Order> orders;

Почему это критично: 1000 пользователей = 1001 запрос вместо 1.

2. LazyInitializationException

Попытка использовать lazy-loaded коллекцию вне сессии:

@Transactional
public User getUser(Long id) {
    return userRepository.findById(id).orElse(null);
}

public void process() {
    User user = getUser(123);
    user.getOrders().forEach(...);  // LazyInitializationException
}

Решение 1: @Transactional на весь метод

@Transactional
public User getUser(Long id) {
    User user = userRepository.findById(id).orElse(null);
    user.getOrders().size();
    return user;
}

Решение 2: Явная загрузка

Hibernate.initialize(user.getOrders());

Решение 3: DTO-проекция

@Query("SELECT new com.example.UserDTO(u.id, u.name) FROM User u")
List<UserDTO> findAllAsDTO();

3. Dirty Check

Hibernate отслеживает изменения всех объектов и обновляет их:

@Transactional
public void process() {
    User user = userRepository.findById(1L);
    user.setLastLoginDate(LocalDateTime.now());
}

На выходе Hibernate сделает UPDATE автоматически.

Решение: Явное управление

@Transactional(readOnly = true)
public User getUser(Long id) {
    return userRepository.findById(id).orElse(null);
}

@Transactional
public void updateLastLogin(Long userId) {
    userRepository.updateLastLoginDate(userId, LocalDateTime.now());
}

4. Collection Modification

Добавление/удаление элементов может генерировать множество SQL:

@OneToMany(cascade = CascadeType.ALL, orphanRemoval = true)
private List<Order> orders = new ArrayList<>();

@Transactional
public void reassignOrders(Long userId, List<Order> newOrders) {
    User user = userRepository.findById(userId).get();
    user.getOrders().clear();
    user.getOrders().addAll(newOrders);
}

Решение: Bulk операции

@Modifying
@Query("DELETE FROM Order o WHERE o.user.id = :userId")
void deleteOrdersByUserId(Long userId);

5. Hibernate Session Cache

Кэши могут вернуть старомодные данные:

@Transactional
public void updateUser() {
    User user = userRepository.findById(1L);
    user.getName();  // Вернёт кэшированное значение
}

Решение: Refresh перед использованием

entityManager.refresh(user);

6. Circular Dependencies

Когда User -> Orders и Order -> User:

@Entity
public class Order {
    @ManyToOne
    @JsonBackReference
    private User user;
}

Используй @JsonBackReference или DTO.

7. Open Session in View (Anti-pattern)

spring.jpa.open-in-view: false

Отключи это. Может привести к N+1 запросам и неожиданным UPDATE.

8. Identity Generator + Batch Insert

@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "user_seq")
@SequenceGenerator(name = "user_seq", sequenceName = "user_sequence", allocationSize = 50)
private Long id;

Используй SEQUENCE вместо IDENTITY для batch операций.

9. Кэш и Raw SQL

Кэш не инвалидируется при прямых SQL обновлениях:

entityManager.createQuery("UPDATE User SET name = :n WHERE id = :id")
    .executeUpdate();
entityManager.getEntityManagerFactory().getCache().evict(User.class);

10. SQL Injection в Query

return em.createQuery("SELECT u FROM User u WHERE u.name = " + name)
    .getResultList();

Правильно: Named parameters

return em.createQuery("SELECT u FROM User u WHERE u.name = :name")
    .setParameter("name", name)
    .getResultList();

Лучшие практики

• Используй LAZY по умолчанию, явно загружай EAGER
• Мониторь SQL логи (show_sql=true)
• Профилируй запросы на production
• DTO-проекции для API endpoints
• Отключи OSIV (open-in-view=false)
• Batch операции для bulk insert/update
• Используй readOnly=true где возможно
• Явные JOIN FETCH вместо defaults