引用自定义Blazor NuGet包后静态资源出现404错误

针对你遇到的Blazor Razor类库打包NuGet后，消费项目中静态资源404的问题，可以从以下几个方向排查：

1. 静态资源引用路径错误 #

Blazor Razor类库的静态资源会被部署到消费项目的_content/[你的NuGet包ID]路径下，而非本地项目的wwwroot。所以在Stylesheet.razor中引用资源时，必须使用这个完整路径。

比如，原本的引用如果是：

<link href="css/custom.css" rel="stylesheet" />

需要修改为：

<link href="_content/UI.Web.Blazor.Components/css/custom.css" rel="stylesheet" />

确保包ID和你NuGet包的ID完全一致，大小写也要匹配。

2. .nuspec配置未正确包含资源 #

Blazor类库的静态资源需要同时打包到content和contentFiles目录，才能兼容不同类型的消费项目。检查你的.nuspec是否包含以下配置：

<files>
    <!-- 将wwwroot资源打包到content目录（兼容旧项目） -->
    <file src="wwwroot/**/*" target="content/wwwroot" />
    <!-- 将wwwroot资源打包到contentFiles目录（兼容SDK风格项目） -->
    <file src="wwwroot/**/*" target="contentFiles/any/any/wwwroot" />
</files>

<contentFiles>
    <files include="any/any/wwwroot/**/*" 
           buildAction="Content" 
           copyToOutput="true" 
           flatten="false" />
</contentFiles>

• src路径要匹配你项目中wwwroot的实际位置，比如如果项目根目录下就是wwwroot，这个路径是对的；如果是嵌套目录，需要调整。
• 解压你的.nupkg文件（改成.zip），确认content/wwwroot和contentFiles/any/any/wwwroot下是否存在所有静态资源，这能直接验证资源是否被正确打包。

3. 消费项目配置问题 #

• 如果你用的是.NET 6+的Blazor项目，检查项目.csproj文件中是否存在<DisableStaticAssetProcessing>true</DisableStaticAssetProcessing>，这个配置会禁用静态资源的自动处理，导致无法访问NuGet包中的资源。
• Blazor Server项目的_Host.cshtml或WASM项目的index.html中，不需要手动添加NuGet包静态资源的引用，Blazor会自动处理资源映射。

4. 清理缓存重新构建 #

缓存问题可能导致资源未更新：

• 删除消费项目的bin、obj目录；
• 执行命令清理本地NuGet缓存：dotnet nuget locals all --clear；
• 重新安装你的NuGet包并重新构建整个解决方案。

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