如何定位Hibernate中插入重复值的唯一约束列？

当Hibernate插入数据触发@Column(unique = true)的唯一约束时，日志里只会显示自动生成的随机约束名（如UK_3h6o7iww8015m4q3yffbkqtrw），可以通过以下几种方式定位对应的列：

• 直接查询数据库元数据
  针对MySQL等数据库，执行SQL语句查询约束关联的列：

  SELECT column_name 
  FROM information_schema.key_column_usage 
  WHERE constraint_name = 'UK_3h6o7iww8015m4q3yffbkqtrw' 
    AND table_schema = '你的数据库名称' 
    AND table_name = 'business';
  

  也可以执行SHOW CREATE TABLE business;查看完整建表语句，里面会明确列出每个唯一约束对应的列。

• 自定义唯一约束名称
  避免使用Hibernate自动生成的随机约束名，在实体类中手动指定约束名称，报错时能直接通过约束名识别冲突列：

  @Entity
  @Table(name = "business", uniqueConstraints = {
      @UniqueConstraint(name = "UK_business_email", columnNames = "email"),
      @UniqueConstraint(name = "UK_business_phone", columnNames = "phone")
  })
  public class Business {
      @Column(name = "email")
      private String email;
      
      @Column(name = "phone")
      private String phone;
  }
  

  后续触发冲突时，日志会显示Duplicate entry 'xxx' for key 'business.UK_business_email'，直接就能知道是email列重复。

• 代码中解析异常并查询
  捕获DataIntegrityViolationException，从异常信息提取约束名后查询数据库获取对应列：

  try {
      businessRepository.save(businessEntity);
  } catch (DataIntegrityViolationException e) {
      if (e.getCause() instanceof SQLIntegrityConstraintViolationException) {
          SQLIntegrityConstraintViolationException sqlEx = (SQLIntegrityConstraintViolationException) e.getCause();
          // 从报错信息提取约束名，需根据数据库报错格式调整拆分逻辑
          String[] parts = sqlEx.getMessage().split("'");
          String constraintName = parts[3];
          
          // 通过JDBC或JdbcTemplate执行查询获取列名
          String columnName = jdbcTemplate.queryForObject(
              "SELECT column_name FROM information_schema.key_column_usage WHERE constraint_name = ? AND table_schema = ? AND table_name = ?",
              new Object[]{constraintName, "你的数据库名", "business"},
              String.class
          );
          // 后续可根据columnName处理业务逻辑
      }
  }
  

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