.NET 8 Blazor无法加载外部程序集的styles.css问题求助

问题概述 #

共享程序集可构建为MAUI或WebAssembly，在.NET 6/7环境下采用相同配置运行正常，但升级到.NET 8后出现以下问题：

• 共享程序集中的主布局、视图可正常加载
• _content/CommonAssembly/css/bootstrap/bootstrap.min.css、_content/CommonAssembly/css/app.css等静态资源可正常加载
• CommonAssembly.styles.css无法加载，请求路径为https://0.0.0.0/CommonAssembly.styles.css，提示文件未找到
• 已在路由中注册外部程序集：

  <Router AppAssembly="@typeof(MauiProgram).Assembly" AdditionalAssemblies="new[] {typeof(MainLayout).Assembly}">
  

排查建议 #

• 修正样式文件引用路径
  .NET 8调整了Blazor静态资源寻址规则，自动生成的组件样式文件不再暴露在根路径，需补充_content/前缀，将引用改为：

  <link rel="stylesheet" href="_content/CommonAssembly/CommonAssembly.styles.css" />
  

• 检查共享程序集的嵌入配置
  确认共享项目的.csproj文件中包含以下配置，确保样式文件能被正确嵌入并生成清单：

  <PropertyGroup>
    <GenerateEmbeddedFilesManifest>true</GenerateEmbeddedFilesManifest>
    <StaticWebAssetBasePath>_content/CommonAssembly</StaticWebAssetBasePath>
  </PropertyGroup>
  

  同时检查组件内的<style>块、关联的样式文件是否设置为Embedded Resource属性。

• 清理重建解决方案
  删除所有项目的bin、obj文件夹，执行dotnet clean和dotnet build命令，同时清除浏览器缓存（或用隐私模式测试），避免旧缓存导致的路径匹配问题。

• 验证项目类型与依赖
  确认共享项目的<ProjectSdk>为Microsoft.NET.Sdk.Razor，并正确引用.NET 8版本的Blazor包：

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.Components.Web" Version="8.0.*" />
  </ItemGroup>
  

• 检查静态资源生成情况
  执行dotnet publish发布项目后，查看发布目录下的wwwroot/_content/CommonAssembly文件夹，确认是否存在CommonAssembly.styles.css文件；也可通过反编译共享程序集，验证嵌入式资源中是否包含该文件。

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