.NET 7.0 WebApp单文件发布未包含wwwroot及web.config求助

1. 调整项目文件（.csproj）配置 #

确保wwwroot下所有文件和web.config都被包含进单文件，覆盖默认的排除规则：

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net7.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>

  <ItemGroup>
    <!-- 更新wwwroot内容的单文件包含规则 -->
    <Content Update="wwwroot/**">
      <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
      <ExcludeFromSingleFile>false</ExcludeFromSingleFile>
    </Content>
    <!-- 单独处理web.config，确保不被排除出单文件 -->
    <Content Update="web.config">
      <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
      <ExcludeFromSingleFile>false</ExcludeFromSingleFile>
    </Content>
  </ItemGroup>

</Project>

2. 修正发布命令 #

显式指定自包含发布（指定运行时后默认自包含，但显式声明更稳妥），保留单文件相关参数：

dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true -p:SelfContained=true -p:IncludeAllContentForSelfExtract=true

3. 调整Program.cs适配单文件运行时 #

ASP.NET Core默认从物理路径读取静态文件和配置，单文件运行时会将嵌入内容提取到临时目录，需让应用指向该目录：

var builder = WebApplication.CreateBuilder(args);

// 获取单文件运行时的提取目录
var basePath = AppContext.BaseDirectory;

// 设置Web根目录为提取后的wwwroot路径
builder.WebHost.UseWebRoot(Path.Combine(basePath, "wwwroot"));

// 加载提取后的web.config配置
builder.Configuration.SetBasePath(basePath)
                     .AddXmlFile("web.config", optional: false, reloadOnChange: false);

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

var app = builder.Build();

// 配置请求管道
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
// 自动使用设置的Web根目录加载静态文件
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

关键说明 #

• Web应用和控制台项目的单文件发布逻辑不同：Web相关内容（如wwwroot、web.config）默认有特殊处理规则，必须显式设置ExcludeFromSingleFile=false才能嵌入单文件。
• IncludeAllContentForSelfExtract=true会让单文件运行时将嵌入内容提取到临时目录，因此必须调整Web根目录和配置路径指向该目录，否则应用会找不到静态文件和配置。
• 若不想提取文件，可直接从嵌入资源读取静态文件，改用EmbeddedFileProvider：

  app.UseStaticFiles(new StaticFileOptions
  {
      FileProvider = new EmbeddedFileProvider(Assembly.GetExecutingAssembly(), "你的项目命名空间.wwwroot")
  });
  

  注意替换命名空间为实际项目的命名空间。

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