Keycloak自定义密码重置流程context.success()不记录审计成功事件

根因说明 #

你遇到的问题是Keycloak事件框架的默认触发逻辑导致的，核心原因有两个：

• context.success()和context.error()的事件持久化逻辑完全独立：错误类型事件只有调用context.error()时才会被持久化，成功类型事件只有提前绑定了对应事件类型后调用context.success()才会被持久化。你测试时设置的EventType.SEND_RESET_PASSWORD_ERROR属于错误事件类型，调用success()时会被系统直接丢弃，不会写入EVENT_ENTITY表。
• 自定义认证流程节点默认不会继承内置流程的事件类型配置，如果你没有在自定义节点中显式声明成功事件类型，就算流程执行成功也不会生成对应事件日志。

修复步骤 #

• 在自定义密码重置节点的业务逻辑执行前，先显式绑定对应成功事件类型：

// 绑定密码重置成功的标准事件类型，也可以使用自定义事件类型
context.getEvent().event(EventType.RESET_PASSWORD);

• 如果需要记录自定义业务参数，可以追加事件详情：

// 示例：追加自定义字段到事件详情中
context.getEvent().detail("reset_from", "custom_flow");

• 密码重置操作完成后，正常调用context.success()即可，系统会自动将该事件持久化到EVENT_ENTITY表。

成功/错误事件逻辑差异 #

两者的核心触发逻辑差异：

• 调用context.error(ErrorCode)时，系统会自动覆盖已设置的事件类型为对应错误事件，无需提前绑定即可直接持久化到事件表
• 调用context.success()时，系统只会持久化你提前显式设置的成功类事件类型，如果未设置或者设置的是错误类事件类型，会直接跳过事件持久化逻辑

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