如何修改ASP.NET Web API构建目录路径？解决IIS部署502.5错误

从事件日志来看，问题核心是**静态资源清单(StaticWebAssets)**硬编码了本地开发环境的wwwroot路径，导致服务器运行时无法找到对应目录。以下是具体解决步骤：

1. 修正Program.cs的配置加载逻辑 #

你手动构建的Configuration绕过了ASP.NET Core默认的内容根目录配置，导致静态资源加载时使用错误路径。直接让Host.CreateDefaultBuilder处理配置，它会自动识别服务器上的应用根目录：

修改后的Program.cs代码：

namespace WebAppsCoreClone
{
    public class Program
    {
        public static void Main(string[] args)
        {
            var host = Host.CreateDefaultBuilder(args)
                .UseSerilog((context, config) =>
                {
                    // 通过Host上下文获取正确的配置
                    config.ReadFrom.Configuration(context.Configuration);
                })
                .ConfigureWebHostDefaults(webBuilder =>
                {
                    webBuilder.UseStartup<Startup>();
                })
                .Build();

            host.Run();
        }
    }
}

2. 禁用开发环境的静态资源清单（可选但推荐） #

如果生产环境不需要依赖静态资源清单，可在项目文件(WebAppsCoreClone.csproj)中添加以下配置，避免发布时生成包含本地路径的清单文件：

<PropertyGroup>
  <StaticWebAssetsEnablePublish>false</StaticWebAssetsEnablePublish>
</PropertyGroup>

3. 修正Startup.cs的目录获取逻辑 #

不要使用Directory.GetCurrentDirectory()或AppDomain.CurrentDomain.BaseDirectory，改用注入的IWebHostEnvironment获取服务器上的应用根目录：

步骤3.1：在Startup构造函数注入IWebHostEnvironment #

private readonly IConfiguration _configuration;
private readonly IWebHostEnvironment _env;

public Startup(IConfiguration configuration, IWebHostEnvironment env)
{
    _configuration = configuration;
    _env = env;
}

步骤3.2：修改UploadFolder的静态资源配置 #

app.UseStaticFiles(new StaticFileOptions()
{
    // 使用环境对象获取内容根目录，拼接UploadFolder路径
    FileProvider = new PhysicalFileProvider(Path.Combine(_env.ContentRootPath, "UploadFolder")),
    RequestPath = new PathString("/UploadFolder")
});

4. 发布时的注意事项 #

• 发布时选择Release模式，Debug模式会生成包含本地路径的静态资源清单；
• 在项目中右键wwwroot和UploadFolder文件夹，设置"复制到输出目录"为始终复制或如果较新则复制，确保这些文件夹同步到服务器。

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