.NET 7 API部署Azure Web App后文件上传失败问题排查

1. 文件大小限制 #

本地和Azure环境的请求大小限制规则不同，这是最常见的问题：

• .NET 7 默认限制请求体大小为30MB，需在Program.cs中显式调整：

  builder.Services.Configure<FormOptions>(options =>
  {
      options.MultipartBodyLengthLimit = 104857600; // 示例：设置为100MB，按需调整
  });
  
  builder.WebHost.ConfigureKestrel(options =>
  {
      options.Limits.MaxRequestBodySize = 104857600; // 匹配FormOptions的限制值
  });
  

• Azure Web App 平台层面也有默认限制：在Azure门户进入你的Web App → 配置 → 常规设置，找到「最大上传大小」，将默认的30MB调整为业务所需值。

2. 文件类型拦截 #

即使日志能正常写入，上传文件可能被安全规则拦截：

• 检查代码中是否有文件类型验证逻辑，本地测试时可能未覆盖到某些边界情况（比如文件名带特殊后缀）。
• 若使用IIS托管（Web App默认配置），需确保web.config中允许目标文件扩展名：

  <system.webServer>
    <security>
      <requestFiltering>
        <fileExtensions>
          <add fileExtension=".docx" allowed="true" />
          <add fileExtension=".png" allowed="true" />
          <!-- 添加所有需要允许的文件扩展名 -->
        </fileExtensions>
      </requestFiltering>
    </security>
  </system.webServer>
  

• 若配置了Azure Application Gateway或WAF，需检查是否有拦截特定文件类型的规则。

3. 路径与权限细节 #

日志能写入不代表上传路径的处理完全正确：

• 禁止硬编码路径，必须通过IWebHostEnvironment获取wwwroot路径：

  private readonly IWebHostEnvironment _env;
  public UploadController(IWebHostEnvironment env)
  {
      _env = env;
  }
  
  // 正确的上传路径生成方式
  var uploadDir = Path.Combine(_env.WebRootPath, "your-upload-folder");
  

• 通过Kudu工具（https://<你的应用名>.scm.azurewebsites.net）的文件管理器，检查上传文件夹的权限，确保应用进程（IIS AppPool\DefaultAppPool）有写入权限。
• 注意：Azure Web App的本地存储是临时的，实例重启后数据会丢失，生产环境建议改用Azure Blob Storage存储上传文件。

4. 请求与代码逻辑问题 #

• 确认客户端上传时使用的是multipart/form-data内容类型，部分客户端在云端环境下可能发送错误的请求头，导致文件解析失败。
• 完善代码中的异常捕获，确保能记录上传过程中的具体错误（比如文件名重复、流写入失败等）：

  [HttpPost("upload")]
  public async Task<IActionResult> UploadFile(IFormFile file)
  {
      if (file == null || file.Length == 0)
          return BadRequest("未选择上传文件");
  
      try
      {
          var uploadDir = Path.Combine(_env.WebRootPath, "uploads");
          Directory.CreateDirectory(uploadDir);
          var savePath = Path.Combine(uploadDir, Guid.NewGuid() + Path.GetExtension(file.FileName));
  
          using var stream = new FileStream(savePath, FileMode.Create);
          await file.CopyToAsync(stream);
          return Ok("文件上传成功");
      }
      catch (Exception ex)
      {
          _logger.LogError(ex, "文件上传失败");
          return StatusCode(500, $"上传失败：{ex.Message}");
      }
  }
  

5. 诊断建议 #

• 在Azure门户的Web App → 监控 → 日志流中查看实时日志，能直接获取上传失败的具体错误信息（比如请求大小超限、文件被拦截等）。
• 用Kudu工具的调试控制台手动上传测试文件到目标文件夹，验证文件夹本身的写入可用性，排除代码逻辑问题。

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