Hibernate主键问题：无法将Todo对象持久化到MySQL数据库

问题背景 #

开发简易在线笔记Web应用，使用Hibernate处理模型与数据库交互，数据库包含user表和todo表。执行TestTodoRepository的test1AddTodo方法时，触发java.lang.IllegalArgumentException: id to load is required for loading异常。

错误原因 #

1. 新增逻辑错误：TodoRepository的addTodo方法中，新增Todo对象时，ID尚未通过数据库自增生成，却调用em.find(Todo.class, todo.getId())判断对象是否存在。此时todo.getId()为null，直接触发参数非法异常。
2. 映射配置冲突：项目同时混用JPA注解和Hibernate XML映射文件，可能导致实体映射逻辑混乱，进一步引发ID生成或查询的异常。

解决方案 #

1. 修复新增逻辑，避免空ID查询 #

移除基于ID的存在性判断，直接执行持久化；若需判断重复，改用非ID字段（如关联用户、标题等）做查询：

public void addTodo(Todo todo) {
    // 示例：通过关联用户ID和标题判断是否重复
    TypedQuery<Todo> query = em.createQuery(
        "SELECT t FROM Todo t WHERE t.user.id = :userId AND t.title = :title", Todo.class
    );
    query.setParameter("userId", todo.getUser().getId());
    query.setParameter("title", todo.getTitle());
    
    List<Todo> existingTodos = query.getResultList();
    if (existingTodos.isEmpty()) {
        em.persist(todo);
    } else {
        // 按需处理重复场景，比如抛出异常或执行更新
        throw new RuntimeException("该Todo已存在");
    }
}

2. 统一实体映射方式，消除配置冲突 #

选择一种映射方式并保持一致：

• 使用JPA注解：删除Todo.hbm.xml映射文件，确保实体类注解配置正确：

  @Entity
  @Table(name = "todo")
  public class Todo {
      @Id
      @GeneratedValue(strategy = GenerationType.IDENTITY)
      private Long id;
      // 其他字段及注解
  }
  

• 使用Hibernate XML映射：移除实体类上的JPA注解，确保Todo.hbm.xml中ID生成策略配置正确：

  <class name="com.yourpackage.Todo" table="todo">
      <id name="id" type="java.lang.Long">
          <column name="id" />
          <generator class="identity"/>
      </id>
      <!-- 其他字段映射 -->
  </class>
  

3. 验证ID自增配置正确性 #

确保数据库todo表的id字段已设置为自增主键，同时Hibernate的ID生成策略与数据库匹配（如上述的IDENTITY策略对应MySQL自增、SQL Server标识列等）。

内容的提问来源于stack exchange，提问作者Antonino