Spring Boot中邮箱唯一列重复输入验证：解决约束冲突报错

1. 业务层前置校验 #

在保存用户前主动查询数据库，判断邮箱是否已存在，从源头避免触发数据库异常。

Service层代码示例：

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;

    public void saveUser(User user) {
        if (userRepository.existsByUseremail(user.getUseremail())) {
            throw new RuntimeException("该邮箱已被注册");
            // 建议自定义业务异常，比如DuplicateEmailException，便于全局统一处理
        }
        userRepository.save(user);
    }
}

Repository接口扩展：

public interface UserRepository extends JpaRepository<User, Long> {
    boolean existsByUseremail(String useremail);
}

2. 全局异常捕获 #

如果仍触发数据库唯一约束异常，通过全局异常处理器捕获并返回友好提示，避免暴露底层SQL错误。

全局异常处理器代码：

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(SQLIntegrityConstraintViolationException.class)
    public ResponseEntity<String> handleDuplicateEmail(SQLIntegrityConstraintViolationException ex) {
        String tip = "该邮箱已被注册，请更换其他邮箱";
        // 可根据异常信息关键字精准判断
        if (ex.getMessage().contains("Duplicate entry") && ex.getMessage().contains("@")) {
            return ResponseEntity.badRequest().body(tip);
        }
        return ResponseEntity.badRequest().body("数据保存失败");
    }
}

3. 确保数据库唯一约束生效 #

虽然你已使用@Column(unique = true)，但可通过@Table注解明确声明唯一约束，避免DDL生成时出现问题：

实体类修改：

@Entity
@Table(name = "users", uniqueConstraints = {
        @UniqueConstraint(columnNames = "useremail", name = "UK_user_email")
})
public class User {
    // 原有字段...
    @Column(unique = true)
    @NotEmpty(message = "Please Enter Your Email Address")
    @Email(message = "Please Enter Valid Email Address")
    private String useremail;
    // 其他字段...
}

提示：修改后可通过spring.jpa.hibernate.ddl-auto=update自动更新表结构，生产环境建议手动执行SQL脚本。

4. 自定义参数校验注解 #

通过自定义校验注解，在参数校验阶段就拦截重复邮箱，实现更优雅的前端交互。

步骤1：创建自定义注解 #

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = UniqueEmailValidator.class)
public @interface UniqueEmail {
    String message() default "该邮箱已被注册";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

步骤2：实现校验器 #

public class UniqueEmailValidator implements ConstraintValidator<UniqueEmail, String> {
    @Autowired
    private UserRepository userRepository;

    @Override
    public boolean isValid(String email, ConstraintValidatorContext context) {
        return email != null && !userRepository.existsByUseremail(email);
    }
}

步骤3：在实体类中使用 #

@UniqueEmail(message = "该邮箱已被注册")
@NotEmpty(message = "Please Enter Your Email Address")
@Email(message = "Please Enter Valid Email Address")
private String useremail;

步骤4：Controller触发校验 #

@PostMapping("/register")
public ResponseEntity<String> register(@Valid @RequestBody User user) {
    userService.saveUser(user);
    return ResponseEntity.ok("注册成功");
}

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