添加maxAllowedContentLength后Azure Web App无法启动的原因排查

1. web.config配置错误（直接引发启动失败） #

你的web.config中maxAllowedContentLength属性值末尾多了一个空格：

<requestLimits maxAllowedContentLength="2147483647 " />

XML对属性值解析要求严格，多余的空格会导致配置文件无效，Azure Web App无法加载正确的IIS配置，直接触发启动失败。

修正方式：删除属性值末尾的空格，修改为：

<requestLimits maxAllowedContentLength="2147483647" />

2. 补充ASP.NET Core自身的请求大小限制配置 #

仅修改IIS的requestFiltering不足以完全解决大文件上传问题，ASP.NET Core框架本身默认有请求大小限制（约30MB），需要同步配置：

全局配置（Program.cs） #

在builder.Services.AddControllers()后添加全局大小限制：

builder.Services.Configure<Microsoft.AspNetCore.Http.Features.FormOptions>(options =>
{
    options.MultipartBodyLengthLimit = 2147483647; // 与IIS配置保持一致，即2GB
});

// 也可使用中间件方式
app.UseRequestSizeLimit(2147483647);

局部配置（控制器/Action） #

若仅需特定接口支持大文件上传，可在控制器或Action上添加特性：

[RequestSizeLimit(2147483647)]
public class UploadController : ControllerBase
{
    [HttpPost("upload")]
    public IActionResult Upload(IFormFile file)
    {
        // 处理上传逻辑
        return Ok();
    }
}

3. Azure Web App额外检查项 #

• 确认Azure门户中应用服务的配置->常规设置里，运行时已设置为.NET 7
• 你当前使用InProcess托管模型（hostingModel="inprocess"），需确保无其他与托管模型冲突的配置
• 可开启stdout日志排查：将stdoutLogEnabled="false"改为true，部署后通过Azure门户的日志流或LogFiles目录查看详细启动错误信息

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