ASP.NET Core 5单文件Web应用发布后静态资源加载异常问题咨询

1. 修复项目文件配置，确保静态资源被打包进单文件 #

首先编辑你的.csproj项目文件，在<Project>节点下添加如下配置，强制把wwwroot下所有内容打包进单文件：

<PropertyGroup>
  <!-- 开启嵌入式资源支持 -->
  <GenerateEmbeddedFilesManifest>true</GenerateEmbeddedFilesManifest>
</PropertyGroup>

<ItemGroup>
  <!-- 显式指定wwwroot下所有文件（包含子目录）作为嵌入式资源 -->
  <EmbeddedResource Include="wwwroot/**/*" LogicalName="%(RecursiveDir)%(Filename)%(Extension)" />
</ItemGroup>

如果你的jquery-validation等前端库是通过Library Manager（LibMan）安装的，还要添加发布前自动还原LibMan库的配置，避免发布时丢失依赖：

<Target Name="LibManRestore" BeforeTargets="BeforeBuild">
  <Exec Command="libman restore" />
</Target>

2. 修改静态文件中间件配置，从嵌入式资源读取内容 #

不用手动读取临时解压目录，官方提供了嵌入式文件提供程序实现，修改Startup.cs即可：
首先引入必要命名空间：

using Microsoft.Extensions.FileProviders;
using System.Reflection;

然后修改Configure方法中的静态文件配置：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 其余原有配置保留即可
    
    // 替换默认静态文件提供程序，从当前程序集的嵌入式资源读取wwwroot内容
    var staticFileProvider = new ManifestEmbeddedFileProvider(
        Assembly.GetExecutingAssembly(),
        "wwwroot"
    );
    app.UseStaticFiles(new StaticFileOptions
    {
        FileProvider = staticFileProvider
    });
    
    // 其余原有配置保留即可
}

3. 还原默认Program.cs逻辑 #

删除你之前添加的临时目录读取代码，用默认的启动逻辑即可：

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)            
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            });
}

你原来的发布命令不需要修改，重新发布后生成的单个exe即可正常加载所有静态资源。

之前方案丢资源的原因 #

• ASP.NET Core 5的默认单文件发布逻辑只会打包程序集和原生依赖，wwwroot下的静态资源默认不会被嵌入到exe中，所以临时解压目录不会出现这些文件
• 模板默认安装的jquery相关库如果没有被显式标记为需要打包的资源，发布阶段会被自动过滤，不会进入打包列表

可选方案：支持动态修改静态资源的单exe方案 #

如果你不想把静态资源嵌死在exe里，方便后续直接修改前端内容，可以在发布命令中添加参数/p:IncludeContentInSingleFile=false，发布后把生成的wwwroot目录和exe放在同一目录下，一起拷贝到其他机器即可运行，不需要修改任何代码。

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