Appearance
Keycloak Sandbox 双沙箱开发环境深度解析
基于 Keycloak SPI 开发的一站式双沙箱环境技术解析，覆盖 Maven 多模块架构、Docker/Release 双沙箱、SPI 一键打包发布、多版本切换等核心开发实践。
项目简介
Keycloak SPI 扩展开发的痛点之一在于开发环境的搭建：开发者需要在本地安装和配置 Keycloak 服务器，手动部署扩展 JAR，反复重启服务来验证修改效果。当需要在不同 Keycloak 版本之间切换时，环境管理的复杂度更是成倍增加。
Keycloak Sandbox 双沙箱项目正是为了解决这些问题而设计的。它基于 Maven 多模块架构，内置 Docker 版和 Release 版两种沙箱环境，支持任意 Keycloak 版本的全局切换，提供 SPI 一键打包发布能力，让开发者可以专注于 SPI 扩展的业务逻辑实现，而非环境配置的繁琐细节。
技术文章索引
开发环境与架构
核心技术栈
┌──────────────────────────────────────────────────────┐
│ Keycloak SPI 扩展 │
├──────────┬──────────┬──────────┬────────────────────┤
│ 用户存储SPI │ 事件监听SPI │ 国密算法SPI │ 自定义扩展... │
├──────────┴──────────┴──────────┴────────────────────┤
│ SPI 一键打包发布模块 │
├──────────────────────┬───────────────────────────────┤
│ Docker 版沙箱 │ Release 版沙箱 │
├──────────────────────┴───────────────────────────────┤
│ Maven 多模块 + 全局版本控制 │
└──────────────────────────────────────────────────────┘适用读者
- 正在进行 Keycloak SPI 扩展开发的工程师
- 需要多版本 Keycloak 兼容测试的技术团队
- 对 Keycloak 内部机制和扩展开发流程感兴趣的开发者