ASP.NET 6项目Visual Studio Docker调试失败：路径必须为绝对路径

问题场景 #

开发ASP.NET 6项目时，通过外部命令构建Docker容器或IIS调试均正常，但使用Visual Studio自带的Docker支持调试时，容器内抛出如下异常：

Unhandled exception. System.ArgumentException: The path must be absolute. (Parameter 'root')
   at Microsoft.Extensions.FileProviders.PhysicalFileProvider..ctor(String root, ExclusionFilters filters)
   at Microsoft.Extensions.FileProviders.PhysicalFileProvider..ctor(String root)
   at Microsoft.AspNetCore.Hosting.StaticWebAssets.StaticWebAssetsLoader.<>c.<UseStaticWebAssetsCore>b__1_0(String contentRoot)
   at Microsoft.AspNetCore.StaticWebAssets.ManifestStaticWebAssetFileProvider..ctor(StaticWebAssetManifest manifest, Func`2 fileProviderFactory)
   at Microsoft.AspNetCore.Hosting.StaticWebAssets.StaticWebAssetsLoader.UseStaticWebAssetsCore(IWebHostEnvironment environment, Stream manifest)
   at Microsoft.AspNetCore.Hosting.StaticWebAssets.StaticWebAssetsLoader.UseStaticWebAssets(IWebHostEnvironment environment, IConfiguration configuration)
   at Microsoft.AspNetCore.WebHost.<>c.<ConfigureWebDefaults>b__9_0(WebHostBuilderContext ctx, IConfigurationBuilder cb)
   at Microsoft.AspNetCore.Hosting.GenericWebHostBuilder.<>c__DisplayClass9_0.<ConfigureAppConfiguration>b__0(HostBuilderContext context, IConfigurationBuilder builder)
   at Microsoft.AspNetCore.Hosting.BootstrapHostBuilder.RunDefaultCallbacks(ConfigurationManager configuration, HostBuilder innerBuilder)
   at Microsoft.AspNetCore.Builder.WebApplicationBuilder..ctor(WebApplicationOptions options, Action`1 configureDefaults)
   at Microsoft.AspNetCore.Builder.WebApplication.CreateBuilder(String[] args)
   at Program.<Main>$(String[] args) in D:\workspace\my\mdo\xx\src\xxx\Program.cs:line 1
Aborted

项目的Program.cs代码如下：

using Microsoft.AspNetCore;
using Microsoft.Extensions.FileProviders;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.

builder.Services.AddControllersWithViews();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();


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

app.MapFallbackToFile("index.html");

app.Run();

问题原因 #

Visual Studio的Docker调试模式会自动启用**静态Web资产(Static Web Assets)**功能，该功能用于在开发环境中映射静态文件。但VS调试容器时，内容根路径被设置为相对路径，导致PhysicalFileProvider初始化时因路径非绝对而抛出异常。

解决方案 #

方案1：禁用静态Web资产构建 #

在项目的.csproj文件中添加以下配置，彻底禁用静态Web资产的构建和加载逻辑：

<PropertyGroup>
  <DisableStaticWebAssetsBuild>true</DisableStaticWebAssetsBuild>
</PropertyGroup>

方案2：显式指定绝对内容根路径 #

修改Program.cs，在创建WebApplicationBuilder时显式设置绝对内容根路径：

var builder = WebApplication.CreateBuilder(new WebApplicationOptions
{
    ContentRootPath = Path.GetFullPath(Directory.GetCurrentDirectory())
});

方案3：修正Dockerfile配置 #

确保Dockerfile中设置了绝对工作目录，并将项目文件复制到该目录，同时通过环境变量指定内容根路径：

WORKDIR /app
COPY . .

ENV ASPNETCORE_CONTENTROOT=/app

验证 #

应用上述任一方案后，重新使用Visual Studio的Docker调试功能启动项目，异常即可解决。

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