如何通过keycloak_admin_client为新创建用户添加offline_access角色？

环境与需求 #

• 技术栈：Spring Boot 2.7.4 + keycloak-admin-client 20.0.1
• 需求：自动为指定用户的角色映射添加Keycloak预定义的offline_access角色

问题现象 #

编写代码后，自定义角色可正常添加到用户角色映射中，但offline_access角色始终无法添加，且程序无任何异常抛出或错误日志输出。尝试为Keycloak客户端配置offline_access scope后，问题依然存在。

解决方案 #

将Keycloak服务端版本从15.0.1升级到19.0.3后，无需对原有代码或配置做任何修改，offline_access角色即可成功添加到用户的角色映射中。

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