ASP.NET Core API部署Azure后，FTP上传文件无法通过URL访问

阿华AIGC实验室

2026-5-21

问题根源分析

ASP.NET Core Web API模板默认不会启用静态文件服务中间件——这是因为Web API的设计初衷是处理API请求，而非直接提供静态资源访问。所以哪怕你把文件传到了/site/wwwroot或者其他目录，没有配置对应的中间件，Azure App Service也不会把这些文件暴露给外部请求。

解决方案步骤

1. 启用静态文件服务中间件

打开你的项目代码，根据.NET版本配置中间件：

.NET 6+（Program.cs）

在builder.Services.AddControllers();之后添加静态文件服务注册，然后在管道中启用：

var builder = WebApplication.CreateBuilder(args);

// 注册控制器服务
builder.Services.AddControllers();
// 注册静态文件服务
builder.Services.AddStaticFiles();

var app = builder.Build();

// 启用静态文件服务（必须放在MapControllers之前）
app.UseStaticFiles();

app.MapControllers();

app.Run();

旧版本（Startup.cs）

在ConfigureServices中注册服务，Configure方法中启用中间件：

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers();
    services.AddStaticFiles();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // ...其他中间件（比如异常处理、路由）
    
    // 启用静态文件服务
    app.UseStaticFiles();

    app.UseRouting();
    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

2. 处理非wwwroot目录的静态文件

如果你想把文件放在wwwroot之外的目录（比如自定义的uploads文件夹），需要配置StaticFileOptions指定文件路径和请求路径映射：

// .NET 6+ 示例：映射/site/wwwroot/uploads目录到/uploads请求路径
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath, "uploads")),
    RequestPath = "/uploads"
});

这样上传到uploads目录的xyz.jpg，就可以通过https://somename.azurewebsites.net/uploads/xyz.jpg访问。

3. 检查Azure App Service的额外配置

验证文件路径：通过Kudu控制台（https://somename.scm.azurewebsites.net/DebugConsole）确认文件确实在你期望的目录下——有时候FTP客户端可能会误传路径（比如传到了/site/home而非/site/wwwroot）。
检查文件权限：在Kudu控制台中右键文件，查看属性，确保文件权限为可读（默认FTP上传的文件权限是没问题的，但如果是控制器上传的，要确认代码中保存文件时设置了正确的权限）。
排查web.config干扰（Windows App Service）：如果你的应用部署在Windows环境下，web.config中的URL重写规则可能会把静态文件请求导向API控制器。可以添加规则排除静态文件路径，比如：

<rewrite>
  <rules>
    <rule name="StaticFiles" stopProcessing="true">
      <match url="^(.+\.(jpg|jpeg|png|gif|css|js|ico))$" />
      <action type="None" />
    </rule>
    <!-- 其他API重写规则 -->
  </rules>
</rewrite>

4. 修复控制器上传文件的访问问题

如果控制器上传的文件无法访问，需要：

确保上传路径指向wwwroot下的子目录（比如Path.Combine(builder.Environment.WebRootPath, "uploads")，WebRootPath就是/site/wwwroot），或者配置了对应自定义目录的静态文件中间件。
确认控制器中保存文件的代码没有错误，比如路径拼接正确、文件成功写入磁盘。