修改程序集名称致Blazor WebAssembly应用组件加载异常求助

问题根源 #

修改程序集名称后，Blazor的组件扫描逻辑、静态资源引用路径会因程序集标识变更而失效，导致组件无法正确初始化、样式资源加载失败。

修复步骤 #

1. 更新_Imports.razor的命名空间引用 #

打开项目根目录的_Imports.razor文件，将原有默认命名空间替换为新程序集对应的命名空间：

@using MyAssembly.YourOriginalProjectName
@using MyAssembly.YourOriginalProjectName.Shared

2. 调整wwwroot/index.html中的样式引用 #

在wwwroot/index.html里，Blazor自动生成的样式文件名称与程序集名称绑定，需同步修改：

<!-- 修改前 -->
<link href="YourOriginalProjectName.styles.css" rel="stylesheet">

<!-- 修改后 -->
<link href="MyAssembly.YourOriginalProjectName.styles.css" rel="stylesheet">

3. 配置项目文件的静态资源路径 #

打开项目的.csproj文件，添加或更新StaticWebAssetBasePath属性，与新程序集名称保持一致：

<PropertyGroup>
  <AssemblyName>MyAssembly.YourOriginalProjectName</AssemblyName>
  <StaticWebAssetBasePath>MyAssembly.YourOriginalProjectName</StaticWebAssetBasePath>
</PropertyGroup>

4. 清理重建项目 #

• 删除项目根目录下的bin和obj文件夹
• 在开发工具中执行「清理解决方案」→「重建解决方案」
• 清空浏览器缓存（或使用无痕模式打开应用）

验证 #

完成上述操作后重新运行应用，Index页面的组件和样式即可恢复正常显示。

内容的提问来源于stack exchange，提问作者J Nguyen