ZITADEL项目移除CockroachDB支持的技术决策分析

ZITADEL作为一款开源的身份与访问管理平台，近期做出了一个重要的架构决策：从3.0版本开始将不再支持CockroachDB数据库。这一变更反映了项目团队对技术栈的持续优化和对用户体验的重视。

技术背景与决策原因

CockroachDB虽然被宣传为PostgreSQL兼容的分布式数据库，但在实际使用中ZITADEL团队发现其兼容性存在诸多问题。特别是在使用River等第三方库时，需要编写大量定制代码和工作区来绕过兼容性问题，这显著增加了工程维护成本。

另一个关键因素是CockroachDB近期调整了定价策略，可能导致现有用户转向PostgreSQL。考虑到PostgreSQL在开源社区的广泛采用和稳定性，ZITADEL团队决定专注于单一数据库支持，以提供更稳定和一致的用户体验。

版本过渡计划

根据ZITADEL的季度发布策略，2.x版本将是最后一个支持CockroachDB的系列版本，其支持将持续到2025年9月30日。这为用户提供了充足的迁移时间窗口。

数据迁移方案

项目团队已经完善了数据库镜像工具，支持包括CockroachDB到PostgreSQL在内的多种数据库迁移场景。该工具能够确保数据在迁移过程中的完整性和一致性，为用户提供平滑的升级路径。

技术实现细节

在代码层面，团队已经完成了以下关键工作：

1. 完全移除了与CockroachDB相关的专用代码
2. 增加了当配置使用CockroachDB时的明确错误提示
3. 更新了所有相关文档，明确指出PostgreSQL是推荐且唯一的数据库选择
4. 调整了Helm图表等部署配置，确保新版本默认使用PostgreSQL

用户影响与建议

对于现有CockroachDB用户，建议在2025年9月前完成向PostgreSQL的迁移。项目团队将持续提供迁移指导和技术支持，确保用户业务不受影响。这一技术决策虽然带来短期迁移成本，但从长期看将降低系统复杂度，提高维护效率，最终为用户带来更稳定的产品体验。