Keycloak 16.1.1注册时忽略邮箱重复异常的后续修改方案

你当前的问题根源是：虽然跳过了邮箱重复的校验，但后续流程仍会尝试创建新用户，而用户名（通常与邮箱关联）已存在于数据库中，触发了唯一约束异常。要实现「重复邮箱注册时跳转到成功页并提示验证」的需求，核心是不创建新用户，复用已存在的用户并触发验证邮件逻辑，具体修改步骤如下：

1. 完善自定义校验器的逻辑 #

在ProfileValidationIgnoreEmailInUse的validate方法中，不仅要跳过邮箱错误，还要将已存在的用户信息存入上下文，供后续步骤复用：

@Override
public void validate(ValidationContext context) {
    // 保留原有其他字段的校验逻辑...

    // 邮箱校验部分修改
    String email = context.getHttpRequest().getDecodedFormParameters().getFirst("email");
    boolean emailValid = // 保留原有邮箱格式校验逻辑...

    if (emailValid && !context.getRealm().isDuplicateEmailsAllowed()) {
        UserModel existingUser = context.getSession().users().getUserByEmail(email, context.getRealm());
        if (existingUser != null) {
            logger.infof("Email %s already exists, skip creating new user", email);
            // 将已存在用户存入上下文，供后续步骤调用
            context.getAttributes().put("EXISTING_USER", existingUser);
            // 直接标记校验通过，不抛出错误
            context.success();
            return;
        }
    }

    // 原有其他校验逻辑...
}

2. 自定义用户创建执行器 #

替换注册流中原有的「Create User」执行器，实现「存在用户则复用，不存在则创建」的逻辑：

public class RegistrationUserCreationIgnoreExisting implements FormAction, FormActionFactory {

    @Override
    public void action(ValidationContext context) {
        // 先检查上下文是否存在已有的用户
        UserModel existingUser = (UserModel) context.getAttributes().get("EXISTING_USER");
        if (existingUser != null) {
            // 将已存在用户设置到上下文，替代新建用户
            context.setUser(existingUser);
            
            // 若用户邮箱未验证，重新发送验证邮件
            if (!existingUser.isEmailVerified()) {
                sendVerificationEmail(context, existingUser);
            }
            
            // 标记流程成功，进入下一步
            context.success();
            return;
        }

        // 不存在用户时，执行原有的创建用户逻辑（复制RegistrationUserCreation的action代码）
        RealmModel realm = context.getRealm();
        KeycloakSession session = context.getSession();
        // ... 原有创建用户的代码 ...
    }

    // 封装发送验证邮件的逻辑
    private void sendVerificationEmail(ValidationContext context, UserModel user) {
        RealmModel realm = context.getRealm();
        KeycloakSession session = context.getSession();
        EventBuilder event = context.getEvent();

        try {
            session.getProvider(EmailTemplateProvider.class)
                .setRealm(realm)
                .setUser(user)
                .sendVerifyEmail(event);
            logger.infof("Resent verification email to user: %s", user.getEmail());
        } catch (EmailException e) {
            logger.error("Failed to send verification email", e);
            // 可根据需求添加发送失败的处理逻辑，比如提示用户
        }
    }

    // 实现FormAction和FormActionFactory的其他必要方法...
}

3. 调整注册流配置 #

1. 在Keycloak管理后台的「认证」-「注册」页面，进入你复制的自定义注册流
2. 移除原有的「Create User」执行器，添加你自定义的RegistrationUserCreationIgnoreExisting执行器
3. 若原有流中包含「Send Verify Email」步骤，可选择移除（因为我们已在自定义创建步骤中处理了邮件发送），或修改该步骤逻辑：当上下文存在EXISTING_USER时跳过发送

4. 处理成功页提示 #

在注册成功页的模板中，可通过判断上下文是否存在EXISTING_USER，显示不同的提示文案：

• 新用户：「注册成功，请点击邮箱中的链接完成验证」
• 重复邮箱用户：「该邮箱已注册，请检查邮箱中的验证链接完成账号激活」

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