Piral-NG 转换器在 Angular 20 中的兼容性问题解析

背景概述

Piral 是一个用于构建微前端架构的框架，而 piral-ng 是其专门为 Angular 应用设计的转换器。近期随着 Angular 20 的发布，开发者在使用 piral-ng 1.9.0-beta.8151 版本时遇到了兼容性问题，导致无法正常加载微应用。

问题根源

在 Angular 20 中，开发团队对 @angular/platform-browser-dynamic 模块进行了重构，移除了原本导出的 INTERNAL_BROWSER_DYNAMIC_PLATFORM_PROVIDERS 常量。这一变更属于 Angular 内部实现细节的调整，但由于 piral-ng 的启动逻辑依赖于此常量，导致了兼容性问题。

具体来说，piral-ng 的启动文件（startup.ts）原本通过访问 ɵINTERNAL_BROWSER_DYNAMIC_PLATFORM_PROVIDERS 来获取平台提供者，这一实现方式在 Angular 20 中已不再适用。

技术影响分析

1. 模块加载失败：当尝试加载使用 Angular 20 的 pilet 时，系统会抛出 TypeError: INTERNAL_BROWSER_DYNAMIC_PLATFORM_PROVIDERS is not iterable 错误。

2. 测试环境问题：即使在主应用中解决了加载问题，单元测试环境仍然可能因为相同的依赖关系而失败。

3. XhrFactory 注入问题：部分开发者报告在解决问题后遇到了 NullInjectorError: No provider for XhrFactory! 的错误，这表明 HTTP 客户端的相关依赖注入链出现了问题。

解决方案演进

Piral 团队针对此问题提出了几个阶段的解决方案：

1. 初步修复：通过可选链操作符（optional chaining）来避免直接访问不存在的导出，但这只是临时解决方案。

2. 架构调整：重新设计启动逻辑，不再依赖 Angular 内部实现细节，而是使用更稳定的公共 API。

3. 长期建议：推荐开发者转向使用 Angular 的独立组件（standalone components）架构，这是 Angular 团队当前主要投入的开发方向。

最佳实践建议

对于正在或计划使用 Angular 20 与 piral-ng 的开发者，建议采取以下措施：

1. 版本升级：确保使用 piral-ng 1.9.0-beta.8156 或更高版本，这些版本已经包含了对 Angular 20 的兼容性修复。

2. 依赖管理：仔细检查共享依赖项的导入配置，避免因为依赖版本冲突导致的问题。

3. HTTP 客户端配置：如果遇到 XhrFactory 注入问题，可以考虑在提供 HttpClient 时显式配置 withFetch 选项。

4. 构建工具选择：考虑使用模块联邦（Module Federation）作为 pilet 的打包方案，这可以更好地处理共享依赖关系。

技术前瞻

随着 Angular 生态向独立组件架构的全面迁移，piral-ng 未来可能会逐步减少对传统 NgModule 模式的支持。开发者应当关注这一趋势，并适时调整自己的应用架构。

同时，Webpack 5 的模块联邦特性为解决微前端中的依赖共享问题提供了新的思路，这可能会成为未来 piral-ng 推荐的集成方式之一。