ASP.NET Core 7.0 MVC引用NuGet主题包时wwwroot文件不加载问题

以下是针对该问题的具体解决步骤：

1. 确保NuGet项目中wwwroot文件的生成配置正确 #

对于NuGet项目内的所有wwwroot文件，需在属性中设置：

• 生成操作：设为Content
• 复制到输出目录：设为如果较新则复制或始终复制

如果是SDK风格的NuGet项目，可直接修改.csproj文件添加全局配置，避免逐个文件设置：

<ItemGroup>
  <Content Include="wwwroot\**\*">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <PackageCopyToOutput>true</PackageCopyToOutput>
  </Content>
</ItemGroup>

2. 修正nuspec文件的contentFiles配置 #

检查你的contentFiles节点是否配置正确，需明确指定目标框架、文件路径、生成操作和复制规则。示例配置如下：

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

注意：

• include路径要匹配NuGet项目中wwwroot文件的实际位置，any/net7.0表示适配任意平台的.NET 7.0框架
• flatten="false"会保留原文件目录结构，避免文件混乱

3. 验证ASP.NET Core静态文件中间件配置 #

在MVC项目的Program.cs中，确保已启用静态文件中间件，且配置正确：

var builder = WebApplication.CreateBuilder(args);

// 添加MVC服务
builder.Services.AddControllersWithViews();

var app = builder.Build();

// 启用静态文件服务
app.UseStaticFiles();

// 其他中间件配置...
app.UseRouting();
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

如果NuGet包的静态文件输出路径有特殊设置，可额外添加静态文件源：

app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(Directory.GetCurrentDirectory(), "wwwroot")),
    RequestPath = "/wwwroot"
});

4. 清理缓存并重新部署NuGet包 #

• 删除本地NuGet缓存：找到%userprofile%\.nuget\packages目录下对应自定义包的文件夹并删除
• 重新生成NuGet项目：执行dotnet pack命令重新打包
• 在MVC项目中卸载原NuGet包，重新安装新生成的包，然后清理解决方案并重新生成

内容的提问来源于stack exchange，提问作者Osman İşci