Backstage v1.39.0 版本深度解析：重大架构演进与新特性解读

Backstage 作为 Spotify 开源的开发者门户平台，在最新发布的 v1.39.0 版本中带来了一系列重要的架构变革和功能增强。本文将深入剖析这次更新的技术内涵，帮助开发者理解其影响并顺利升级。

核心架构变革

旧版后端系统的全面淘汰

本次版本最显著的改变是对旧版后端系统的支持移除。多个核心后端模块（包括 auth-backend、catalog-backend 等）已彻底放弃对旧系统的兼容，这标志着 Backstage 新后端系统的成熟。对于尚未迁移的项目，现在必须完成向新后端系统的过渡。

迁移过程中需要注意：

• 移除旧版导入路径中的 /alpha 后缀
• 检查并更新相关依赖版本范围（如 catalog-backend 已升级至 2.0.0）
• 重构使用了已废弃API的代码段

CodeOwnersProcessor 的调整

作为架构优化的一部分，默认处理器集合中的 CodeOwnersProcessor 已被移除。这一变更源于其较高的运行时开销和模糊的语义定义。如需继续使用该功能，开发者需要手动将其添加到 catalogProcessingExtensionPoint 中。

重要新特性

身份令牌优化

身份认证系统新增了 omitIdentityTokenOwnershipClaim 配置选项，启用后将不再在令牌中包含 ent 声明（用户所有权引用）。这一优化可以显著减小令牌体积，但需要注意：

• 令牌不再自包含，依赖所有权声明的消费者需调用 /api/auth/v1/userinfo 端点
• 自定义登录解析器需要调整返回格式，直接返回 issueToken 的完整结果

国际化增强

i18n 系统现在原生支持 JSX 元素的插值处理。当翻译内容中包含 JSX 元素时，系统会自动将其合并为片段返回，这大大简化了包含动态内容（如链接）的国际化实现。

调度服务API

新增的调度服务REST API提供了任务管理和触发的标准化接口，为自动化工作流集成提供了更灵活的控制能力。

开发者体验改进

React 17 弃用通知

项目正式将 React 17 标记为弃用状态，CLI 会在检测到旧版本时发出警告。建议开发者参考迁移指南尽快升级至 React 18。

Yarn 插件兼容性提升

Yarn 插件现在会同时添加 npm: 和 backstage: 范围到锁文件条目中，这解决了构建分布式工作空间时的依赖锁定问题，提高了工具链兼容性。

企业级功能增强

Azure DevOps 联合凭证支持

对于使用 Entra ID 进行认证的组织，现在可以通过托管身份使用联合凭证。这一特性特别适用于跨租户场景，消除了管理外部租户客户端密钥的需求。

缓存服务扩展

后端默认实现的缓存服务新增了对 Valkey 的支持，为基础设施选型提供了更多可能性。

升级建议

对于正在使用旧版后端系统的项目，应立即规划迁移工作。特别注意：

1. 检查所有自定义后端插件与新系统的兼容性
2. 更新 package.json 中的依赖版本约束
3. 测试关键业务流程是否受影响

对于新项目，建议直接基于新架构进行开发，充分利用最新特性带来的优势。

Backstage 社区持续推动着平台的演进，v1.39.0 版本在性能、安全性和开发者体验方面都做出了重要改进，是企业级开发者门户建设的优选方案。