Fluent UI Blazor 项目在.NET 9发布时内容丢失问题分析

在.NET 9环境下使用Fluent UI Blazor组件库进行项目发布时，开发人员可能会遇到一个隐蔽但影响严重的问题——当使用dotnet publish --no-build命令时，项目发布后的网页内容会异常显示为空白页面。

问题现象

开发者在将项目升级到.NET 9后，发现生产环境部署的应用页面显示为空白。检查页面元素时，会发现body标签被自动添加了hidden-body类，导致内容不可见。同时，主题相关组件也显示异常，控制台会出现"无法读取未定义的属性"这类JavaScript错误。

根本原因

经过深入分析，发现问题源于.NET 9中dotnet publish --no-build命令的行为变更。在.NET 8中，该命令会正确生成名为[项目名称].publish.manifest.json的资源文件；而在.NET 9中，同样的命令却生成了名为jsmodules.publish.manifest.json的资源文件。

这种命名差异导致Fluent UI Blazor组件库无法正确识别和加载所需的JavaScript模块，进而引发一系列连锁反应：

1. 主题系统初始化失败
2. 本地存储功能不可用
3. 页面内容被隐藏

影响范围

该问题主要影响以下场景：

• 使用.NET 9 SDK构建的项目
• 采用Fluent UI Blazor组件库
• 发布流程中使用--no-build参数
• 生产环境部署（开发环境通常不会使用--no-build）

值得注意的是，部分用户反馈在.NET 8环境下也遇到了类似问题，这表明可能某些SDK更新引入了行为变更。

解决方案

目前推荐的解决方案有以下几种：

1. 移除--no-build参数： 最简单的解决方法是修改发布命令，直接使用dotnet publish而不带--no-build参数。

2. 手动重命名资源文件： 对于需要保留--no-build参数的场景，可以在发布后手动将jsmodules.publish.manifest.json重命名为[项目名称].publish.manifest.json。

3. 等待官方修复： 微软ASP.NET Core团队已经注意到此问题，后续版本可能会提供修复。

技术细节

Fluent UI Blazor组件库依赖这些manifest文件来：

• 标识需要加载的JavaScript模块
• 管理主题系统初始化
• 控制页面加载状态

当文件命名不符合预期时，组件库的初始化流程会中断，但不会抛出明显的错误，这增加了问题排查的难度。

最佳实践建议

为避免类似问题，建议开发团队：

• 在升级.NET版本后，全面测试发布流程
• 建立发布产物的自动化验证机制
• 考虑在CI/CD流程中加入对关键资源文件的检查
• 保持对依赖库和工具链更新的关注

这个问题提醒我们，即使是看似无害的构建参数变更，也可能对应用行为产生深远影响。在现代化Web开发中，构建工具链的稳定性与应用程序功能同样重要。