ASP.NET Core Web API 6.0部署Azure后，如何配置静态文件访问图片？

1. 配置静态文件中间件 #

在Program.cs中添加针对Image文件夹的静态文件映射，注意要把这段配置放在路由相关代码之前：

var builder = WebApplication.CreateBuilder(args);

// 保留原有的API服务注册代码（比如AddControllers）
builder.Services.AddControllers();

var app = builder.Build();

// 配置Image文件夹的静态文件访问规则
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath, "Image")),
    RequestPath = "/Image" // 对应URL中的路径段
});

// 保留原有的路由、授权、端点映射代码
app.UseRouting();
app.UseAuthorization();
app.MapControllers();

app.Run();

2. 确保发布时包含Image文件夹 #

打开项目的.csproj文件，添加以下配置，保证Image文件夹及其所有图片在发布时会被复制到输出目录：

<ItemGroup>
  <Content Include="Image\**">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

3. Azure部署额外设置 #

• 部署内容检查：不管用GitHub Actions、Azure DevOps还是本地ZIP部署，都要确认Image文件夹和图片被包含在部署包中。比如ZIP部署时，打包要包含项目根目录下的Image文件夹。
• 路由冲突排查：避免创建路由为api/Image的控制器（比如ImageController），否则API路由会优先匹配，导致静态文件无法访问。
• 权限验证：Azure App Service默认拥有网站目录的读写权限，无需额外配置文件系统权限，只要文件正常部署即可访问。

测试验证 #

本地运行项目后，访问https://localhost:<端口号>/Image/test.png确认图片能正常打开，部署到Azure后，访问https://<你的API域名>/Image/test.png即可直接查看图片。

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