如何为ASP.NET Core控制器的指定方法配置maxAllowedContentLength？

首先明确：IIS的maxAllowedContentLength是服务器层面的配置，无法直接精准到控制器的单个方法——它基于URL路径匹配，而ASP.NET Core的路由逻辑在IIS之后执行。要实现方法级的内容长度限制，需要结合ASP.NET Core自身的特性，同时配合调整IIS配置避免提前拦截请求。

一、修正控制器级的IIS配置（先解决现有错误） #

你当前web.config中location的path写错了，它应该对应控制器的路由路径，而非物理文件路径。比如你的控制器路由是：

[Route("api/MyController")]
public class MyController : ControllerBase
{
    // ...
}

那web.config的location应修改为：

<location path="api/MyController">
    <system.webServer>
        <handlers>
            <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
        </handlers>
        <security>
            <requestFiltering>
                <!-- 设置足够大的值，让请求能进入ASP.NET Core管道再做方法级限制 -->
                <requestLimits maxAllowedContentLength="1073741824" /> <!-- 1GB -->
            </requestFiltering>
        </security>
    </system.webServer>
</location>

二、方法级内容长度限制实现 #

1. 直接使用RequestSizeLimit特性 #

在目标方法上添加特性，指定允许的最大字节数（示例为50MB=52428800字节）：

using Microsoft.AspNetCore.Mvc;

public class MyController : ControllerBase
{
    [RequestSizeLimit(52428800)]
    [HttpPost]
    public async Task<JsonResult> MyUpload()
    {
        // 处理上传逻辑
    }
}

2. 针对文件/表单上传：使用RequestFormLimits #

如果是表单或文件上传场景，可使用此特性更精细地控制表单和文件大小：

[RequestFormLimits(MultipartBodyLengthLimit = 52428800)]
[HttpPost]
public async Task<JsonResult> MyUpload()
{
    // 处理文件上传逻辑
}

3. 全局+方法级的结合配置 #

如果全局有默认请求大小限制，方法级特性会自动覆盖全局配置。全局配置可在Program.cs中设置：

var builder = WebApplication.CreateBuilder(args);

// 全局默认请求大小限制
builder.Services.Configure<Microsoft.AspNetCore.Http.Features.FormOptions>(options =>
{
    options.MultipartBodyLengthLimit = 10485760; // 10MB 默认值
});

三、关键注意事项 #

• IIS的maxAllowedContentLength值必须大于等于ASP.NET Core中设置的方法级限制，否则IIS会在请求进入ASP.NET Core之前就直接拦截。
• 无表单的原始请求（如JSON）用RequestSizeLimit，文件/表单上传优先用RequestFormLimits。

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