如何在JHipster应用中同步Keycloak用户数据及关联信息？

一、解决Keycloak创建用户后关联JHipster专属数据的问题 #

提供两种落地性强的实现方案：

1. 登录时自动初始化用户数据 #

在JHipster登录流程中添加拦截逻辑，处理首次登录的用户数据初始化：

• 自定义AuthenticationSuccessHandler，用户通过Keycloak登录后，提取Keycloak返回的用户唯一标识sub，检查JHI_USER表是否存在该用户。
• 若不存在，创建JHI_USER记录，并同步初始化用户专属业务数据（如个人配置、默认关联实体等）。
• 核心代码示例：

@Component
public class CustomAuthSuccessHandler extends SavedRequestAwareAuthenticationSuccessHandler {
    private final UserService userService;

    public CustomAuthSuccessHandler(UserService userService) {
        this.userService = userService;
    }

    @Override
    public void onAuthenticationSuccess(HttpServletRequest request, HttpServletResponse response, Authentication authentication) throws IOException, ServletException {
        OAuth2AuthenticationToken token = (OAuth2AuthenticationToken) authentication;
        String userId = token.getPrincipal().getAttribute("sub");
        
        if (!userService.existsById(userId)) {
            User user = new User();
            user.setId(userId);
            user.setLogin(token.getPrincipal().getAttribute("preferred_username"));
            user.setEmail(token.getPrincipal().getAttribute("email"));
            userService.save(user);
            // 初始化用户专属数据
            userService.initUserExclusiveData(user);
        }
        super.onAuthenticationSuccess(request, response, authentication);
    }
}

2. Keycloak事件监听器主动触发同步 #

在Keycloak中开发自定义事件监听器，监听USER_CREATED事件：

• 当Keycloak完成用户创建后，调用JHipster暴露的用户初始化API，传递用户核心信息（ID、用户名、邮箱等）。
• JHipster端接收请求后，创建JHI_USER记录并完成专属数据初始化。

二、实现删除用户时同步删除JHipster关联数据 #

需从事件触发、数据级联两个层面配合实现：

1. 监听Keycloak用户删除事件，触发JHipster清理流程 #

• 基于Keycloak事件监听器，监听USER_REMOVED事件，获取被删除用户的ID。
• 调用JHipster的用户删除接口，触发后续关联数据的清理操作。

2. JHipster端配置级联删除逻辑 #

（1）数据库层面设置级联约束

在JHI_USER与关联表的外键上添加ON DELETE CASCADE：

• 针对用户角色关联表jhi_user_authority，修改外键约束，确保JHI_USER记录删除时自动清除对应角色关联条目。
• 针对用户创建的业务数据表（如订单、文章等），在user_id外键上配置ON DELETE CASCADE。

（2）JPA实体层面配置级联规则

在JHipster生成的实体类中，通过注解定义级联删除行为：

• 业务数据实体与用户的关联字段添加@OnDelete注解：

@Entity
public class Order {
    @ManyToOne
    @OnDelete(action = OnDeleteAction.CASCADE)
    @JoinColumn(name = "user_id")
    private User user;
    // 其他字段...
}

• 用户实体与角色的关联集合添加级联删除：

@ManyToMany
@JoinTable(
    name = "jhi_user_authority",
    joinColumns = {@JoinColumn(name = "user_id", referencedColumnName = "id")},
    inverseJoinColumns = {@JoinColumn(name = "authority_name", referencedColumnName = "name")}
)
@OnDelete(action = OnDeleteAction.CASCADE)
private Set<Authority> authorities = new HashSet<>();

（3）用户删除服务补充清理逻辑

在UserService中实现完整的删除流程（若部分数据未配置自动级联，需手动触发删除）：

@Transactional
public void deleteUser(String userId) {
    // 手动删除用户关联的业务数据（按需添加）
    orderRepository.deleteByUserId(userId);
    articleRepository.deleteByUserId(userId);
    // 删除用户角色关联
    userAuthorityRepository.deleteByUserId(userId);
    // 删除JHI_USER主记录
    userRepository.deleteById(userId);
}

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