Microsoft MVP성태의 닷넷 이야기
닷넷: 2282. C# - ASP.NET Core Web App의 Request 용량 상한값 (Kestrel, IIS) [링크 복사], [링크+제목 복사],
조회: 7958
글쓴 사람
정성태 (seongtaejeong at gmail.com)
홈페이지
첨부 파일
 

C# - ASP.NET Core Web App의 Request 용량 상한값 (Kestrel, IIS)

가령, 이런 식으로 Web API를 노출한 경우,

[HttpPost("{file}")]
public async Task Post(string file)
{
    var request = HttpContext.Request;
    var stream = request.Body;
    var buffer = new byte[Convert.ToInt32(request.ContentLength)];
    await stream.ReadAsync(buffer, 0, buffer.Length);
    await System.IO.File.WriteAllBytesAsync(file, buffer);
}

이것에 약 28.6MB 정도(정확히는 30,000,000 바이트)를 초과하는 파일을 Post하는 경우 이런 오류가 발생할 수 있습니다.

PS C:\temp> (New-Object System.Net.WebClient).UploadData('http://localhost:21000/weatherforecast/test.zip', 'POST', [System.IO.File]::ReadAllBytes('c:\temp\test.zip'))
Exception calling "UploadData" with "3" argument(s): "The remote server returned an error: (500) Internal Server Error."
At line:1 char:1
+ (New-Object System.Net.WebClient).UploadData('http://localhost:21000/ ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [], MethodInvocationException
    + FullyQualifiedErrorId : WebException

또는, "Bad Request"로 나오기도 하고,

PS C:\temp> (New-Object System.Net.WebClient).UploadData('http://localhost:21000/weatherforecast/test.zip', 'POST', [System.IO.File]::ReadAllBytes('c:\temp\test.zip'))
Exception calling "UploadData" with "3" argument(s): "The remote server returned an error: (400) Bad Request."
At line:1 char:1
+ (New-Object System.Net.WebClient).UploadData('http://localhost:21000 ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [], MethodInvocationException
    + FullyQualifiedErrorId : WebException


또는 메시지가 좀 더 직관적인 경우도 있습니다.

"The remote server returned an error: (413) Request Entity Too Large."

만약 해당 Web App을 디버깅 중이거나, 로그 파일을 본다면 동시에 아래와 같은 오류 메시지가 출력될 것입니다.

Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware: Error: An unhandled exception has occurred while executing the request.

Microsoft.AspNetCore.Server.Kestrel.Core.BadHttpRequestException: Request body too large.
   at Microsoft.AspNetCore.Server.Kestrel.Core.BadHttpRequestException.Throw(RequestRejectionReason reason)
   at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.Http1ContentLengthMessageBody.OnReadStarting()
   at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.MessageBody.TryStart()
   at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.Http1ContentLengthMessageBody.ReadAsyncInternal(CancellationToken cancellationToken)
   at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.HttpRequestStream.ReadAsyncInternal(Memory`1 buffer, CancellationToken cancellationToken)
   at net_build_helper.ValuesController.ReadAllBytes(Int32 contentLength)
   at net_build_helper.ValuesController.Post(String mode)
   ...[생략]...

원인은, 당연하겠지만 입력 크기의 제한에 걸렸기 때문입니다. 그리고 해결 방법은, Kestrel로 호스팅했느냐, IIS로 호스팅했느냐에 따라 다릅니다.

그렇다면 현재 호스팅 환경은 어떻게 알 수 있을까요? 배포 환경이라면, IIS에 명시적으로 올리지 않는 한 Kestrel로 호스팅되고 있을 것입니다. 반면, Visual Studio에서 개발 중이라면 디버그 타깃을 보면 됩니다.

vs_debug_target_1.png

저기에 "IISExpress"로 선택돼 있다면 IIS 호스팅이고, 그 외의 것은 모두 Kestrel로 호스팅된다고 보면 됩니다.




우선, Kestrel로 호스팅하고 있는 경우의 대처를 볼까요? .NET 8 Web App 프로젝트라면 Program.cs 파일에서 다음과 같은 옵션을 주면 됩니다.

using System.Diagnostics;

namespace WebApplication1;

public class Program
{
    public static void Main(string[] args)
    {
        var builder = WebApplication.CreateBuilder(args);

        builder.WebHost.ConfigureKestrel(options =>
        {
            options.Limits.MaxRequestBodySize = 50 * 1024 * 1024;
        });

        // ...[생략]...

        app.Run();
    }
}

KestrelServerOptions.Limits.MaxRequestBodySize 속성의 기본값은 30,000,000 바이트이므로 위의 경우에는 50MB로 늘린 사례입니다.

참고로, ConfigureKestrel 말고 UseKestrel로 설정해도 됩니다.

builder.WebHost.UseKestrel((options) =>
{
    options.Limits.MaxRequestBodySize = 50 * 1024 * 1024;
});

단지, 이렇게 한 경우에는 명시적으로 Kestrel Web Server를 사용하겠다는 의미이므로, 해당 웹 앱을 IIS에서 호스팅하면 안 됩니다. 만약 그렇게 되면 app.Run 시점에 다음과 같은 예외가 발생합니다.

System.InvalidOperationException
  HResult=0x80131509
  Message=Application is running inside IIS process but is not configured to use IIS server.
  Source=Microsoft.AspNetCore.Server.IIS
  StackTrace:
   at Microsoft.AspNetCore.Server.IIS.Core.IISServerSetupFilter.<>c__DisplayClass0_0.<Configure>b__0(IApplicationBuilder app)
   ...[생략]...

따라서 강제로 Kestrel로 호스팅해야 할 목적이 아니라면, 가능한 ConfigureKestrel로 옵션을 바꾸는 것이 좋고, 그런 경우 설령 IIS(Express)에서 실행하더라도 ConfigureKestrel 코드를 수행하지 않고 그냥 무시하는 수준에서 그칩니다.




자, 그럼 IIS(Express)라면 어떻게 해야 할까요?

IIS는 독립적인 Web Server이고, .NET 런타임에 앞서 web.config의 설정에 따른 제어를 받습니다. 실제로, 위의 Upload 테스트를 Kestrel 호스팅 환경에서 해보면, 요청이 적어도 Web API까지는 진입을 하고 ReadAsync로 읽어내는 중에 "Request Entity Too Large" 예외가 발생하지만, IIS에서는 닷넷 코드로 진입하기 전에 요청이 거부됩니다.

다시 말해, 닷넷 코드에서 MaxRequestBodySize를 변경해 봤자 IIS 입장에서는 그 사실을 알 수 없으므로 아무런 효과가 없습니다. 결국 위의 예제에 다음과 같이 코드를 추가해,

using Microsoft.AspNetCore.Server.IIS;

// ...[생략]...

builder.Services.Configure<IISServerOptions>(options =>
{
    options.MaxRequestBodySize = 50 * 1024 * 1024; // 50MB
});

실행해 보면, 여전히 "Request Entity Too Large" 예외가 발생합니다. 반면, web.config에 관련 설정을 해두면,

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.webServer>
        <security>
            <requestFiltering>
                <requestLimits maxAllowedContentLength="1073741824" />
            </requestFiltering>
        </security>
    </system.webServer>
</configuration>

50MB까지의 요청을 잘 받아들입니다. 아니, 그런데 maxAllowedContentLength에는 100MB를 설정했는데 왜 50MB일까요? 그것은 Configure 코드에서 MaxRequestBodySize를 50MB로 제한했기 때문입니다. 사실 IISServerOptions.MaxRequestBodySize는 초깃값을 web.config의 maxAllowedContentLength로부터 가져옵니다.

정리해 보면, IIS 호스팅인 경우에는 web.config의 maxAllowedContentLength 속성을 상한으로, ASP.NET 코드 내에서 IISServerOptions.MaxRequestBodySize를 통해 maxAllowedContentLength 범위 내에서 변경할 수 있습니다.

따라서 만약 동적으로 변경해야 할 일이 없다면, 그냥 web.config에 설정을 추가하면 되고, 그렇지 않고 코드로 변경해야 한다면 web.config에는 최댓값을 설정한 후 코드로 제어를 하는 식으로 설정하면 됩니다.




어차피, Configure 코드는 다른 호스팅에서는 무시하므로 둘 다 기본으로 코드를 추가해 설정하는 것도 좋은 선택입니다.

long maxRequest = 50 * 1024 * 1024;

builder.Services.Configure<IISServerOptions>(options =>
{
    options.MaxRequestBodySize = maxRequest;
});

builder.WebHost.ConfigureKestrel(options =>
{
    options.Limits.MaxRequestBodySize = maxRequest;
});

저 상태에서 IIS를 위해서만 특별히 web.config에 설정을 추가하는 식으로 관리하면 될 것입니다. 대신 나중에 코드로 값을 변경해도 반영이 안된다는 것에 자칫 헤맬 수 있으므로 web.config에 대해서만 크기를 (uint 타입의 최대 크기인) 4,294,967,295 (약 3.99GB)로 설정하면 될 텐데요, 단지 이런 경우에 문제라면 원치 않는 크기의 요청이 있을 때 IIS 수준에서 걸러지지 않고 닷넷 런타임까지 넘어온다는 점입니다. 어쩔 수 없습니다, 최적의 성능을 원한다면 두 곳 모두 수정하든가 하는 식의 관리 체계를 탄탄하게 마련해야 합니다.

참고로, MaxRequestBodySize 설정은 닷넷 5 이하에서 만들어진 ASP.NET Core Web App 프로젝트라면 Program.cs의 CreateHostBuilder 메서드에 Kestrel 옵션을 적용할 수 있고,

// .NET 5 이하

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();

                webBuilder.ConfigureKestrel(serverOptions =>
                {
                    serverOptions.Limits.MaxRequestBodySize = 50 * 1024 * 1024;
                });
            });
}

Startup.cs의 ConfigureServices 메서드에서 IIS 옵션을 적용할 수 있습니다.

// .NET 5 이하

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

    services.Configure<IISServerOptions>(options =>
    {
        options.MaxRequestBodySize = 50 * 1024 * 1024;
    });
}




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 9/26/2024]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




... 166  167  168  169  [170]  171  172  173  174  175  176  177  178  179  180  ...
NoWriterDateCnt.TitleFile(s)
764정성태8/21/200922909Windows: 47. Windows Virtual PC에 설치된 Windows 7 VPC에서 Aero 효과 사용 [3]
763정성태8/20/200926516Windows: 46. Windows 7 - XP 모드 응용 프로그램 바로가기 만드는 방법 [2]
762정성태8/18/200932130개발 환경 구성: 48. 개발자 PC 환경 - 유니코드(Unicode)를 위한 설정 [3]
760정성태8/17/200938483개발 환경 구성: 47. XmlCodeGenerator 1.0.0.4 업데이트 [2]
759정성태8/16/200930342.NET Framework: 155. 닷넷 프로파일러의 또 다른 응용: Visual Studio 2010 Historical Debugging
758정성태8/15/200923678VS.NET IDE: 65. WPF 프로젝트용 Visual Studio 패치들 [2]
757정성태8/12/200923093오류 유형: 84. TFS 작업 항목 보기 오류 - WorkItemTypeDeniedOrNotExistException
756정성태8/9/200922652오류 유형: 83. A revocation check could not be performed for the certificate.
755정성태8/6/200920414.NET Framework: 154. 이벤트 2중 구독
754정성태7/16/200932759VS.NET IDE: 64. Visual Studio 2010 - 64bit 혼합 모드 디버깅 지원
753정성태7/15/200931282.NET Framework: 153. WPF와 WinForm의 Shown 이벤트 시점
752정성태7/14/200926854개발 환경 구성: 46. .NET Service Bus 응용 사례: SocketShifter [2]파일 다운로드1
751정성태7/9/200928184.NET Framework: 152. 순환 참조와 XmlSerializer파일 다운로드1
750정성태7/7/200927943.NET Framework: 151. Team Explorer가 설치되지 않은 PC에서 System.InvalidProgramException 예외 발생파일 다운로드1
748정성태7/2/200925801.NET Framework: 150. WPF - Property Element 사용 의미파일 다운로드2
747정성태7/1/200945498.NET Framework: 149. WPF - UI 업데이트를 바로 반영하고 싶다면? [3]파일 다운로드1
746정성태6/25/200932621.NET Framework: 148. WPF - 데이터 바인딩 시의 예외 처리 방법 [1]파일 다운로드1
745정성태6/22/200924623.NET Framework: 147. WPF - Binding에 Sibling 요소 지정 [2]파일 다운로드1
744정성태6/21/200923485.NET Framework: 146. WPF - 중첩된 ScrollViewer의 크기 제어 [2]파일 다운로드1
743정성태6/17/200927569.NET Framework: 145. Unity Container 개체 풀이
742정성태6/17/200927029.NET Framework: 144. WPF - FrameworkElement.Parent 속성이 null이라면? [3]
740정성태6/12/200924615.NET Framework: 143. WPF - Transform의 역변환파일 다운로드1
739정성태6/8/200937361.NET Framework: 142. WPF - Grid 컨트롤의 ShowGridLine 개선 [5]파일 다운로드1
737정성태6/6/200942844.NET Framework: 141. Win32 Interop - 크기가 정해지지 않은 배열을 C++에서 C#으로 전달하는 경우파일 다운로드2
734정성태6/4/200926273.NET Framework: 140. WPF - CellPadding 속성을 구현하는 Grid Layout [2]파일 다운로드1
733정성태5/29/200931666.NET Framework: 139. WPF - "M/d/yyyy h:mm:ss tt" 형식으로만 날짜를 출력하는 문제
... 166  167  168  169  [170]  171  172  173  174  175  176  177  178  179  180  ...