HttpClient에서 HTTP/3 사용

2025-06-17

HTTP/3 은 세 번째이자 최근에 표준화된 HTTP 주 버전입니다. HTTP/3은 HTTP/1.1 및 HTTP/2와 동일한 의미 체계를 사용하기 때문에 동일한 요청 메서드, 상태 코드 및 메시지 필드가 모든 버전에 적용됩니다. 기본 전송에 차이가 있습니다. HTTP/1.1과 HTTP/2 모두 TCP를 전송으로 사용합니다. HTTP/3은 QUIC라는 HTTP/3과 함께 개발된 전송 기술을 사용합니다.

HTTP/3 및 QUIC는 HTTP/1.1 및 HTTP/2에 비해 몇 가지 이점이 있습니다.

첫 번째 요청에 대한 응답 시간이 빨라집니다. QUIC와 HTTP/3은 클라이언트와 서버 간의 왕복을 줄이면 연결을 협상합니다. 첫 번째 요청이 서버에 더 빨리 도달합니다.
연결 패킷 손실이 있을 때의 환경이 향상되었습니다. HTTP/2는 하나의 TCP 연결을 통해 여러 요청을 멀티플렉싱합니다. 연결의 패킷 손실은 모든 요청에 영향을 미칩니다. 이 문제를 ‘HOC(head-of-line) 블로킹’이라고 합니다. QUIC는 네이티브 멀티플렉싱을 제공하므로 손실된 패킷은 데이터가 손실된 요청에만 영향을 줍니다.
네트워크 간 전환을 지원합니다. 이 기능은 모바일 디바이스가 위치를 변경함에 따라 WIFI와 셀룰러 네트워크 간에 전환하는 것이 일반적인 모바일 디바이스에 유용합니다. 현재 네트워크를 전환할 때 오류와 함께 HTTP/1.1 및 HTTP/2 연결이 실패합니다. 앱 또는 웹 브라우저는 실패한 HTTP 요청을 다시 시도해야 합니다. HTTP/3을 사용하면 네트워크가 변경될 때도 앱 또는 웹 브라우저가 원활하게 지속될 수 있습니다. HttpClient 및 Kestrel은 .NET 7에서 네트워크 전환을 지원하지 않습니다. 향후 릴리스에서는 지원될 수 있을 것입니다.

중요합니다

HTTP/3을 활용하도록 구성된 앱은 HTTP/1.1 및 HTTP/2도 지원하도록 디자인되어야 합니다. HTTP/3에서 문제가 식별되면 이후 .NET 릴리스에서 문제가 해결될 때까지 HTTP/3을 사용하지 않도록 설정하는 것이 좋습니다.

HttpClient 설정

HTTP 버전은 3.0으로 설정 HttpRequestMessage.Version 하여 구성할 수 있습니다. 그러나 모든 라우터, 방화벽 및 프록시가 HTTP/3을 제대로 지원하지 않으므로 HTTP/1.1 및 HTTP/2와 함께 HTTP/3을 구성하는 것이 좋습니다. 에서 HttpClient다음을 지정하여 이 작업을 수행할 수 있습니다.

HttpRequestMessage.Version 에서 1.1로
HttpRequestMessage.VersionPolicy가 HttpVersionPolicy.RequestVersionOrHigher로 변경되었습니다.

플랫폼 종속성

HTTP/3은 QUIC를 전송 프로토콜로 사용합니다. HTTP/3의 .NET 구현에서는 MsQuic 를 사용하여 QUIC 기능을 제공합니다. 따라서 HTTP/3의 .NET 지원은 MsQuic 플랫폼 요구 사항에 따라 달라집니다. MsQuic를 설치하는 방법에 대한 자세한 내용은 QUIC 플랫폼 종속성을 참조하세요. HttpClient가 실행되는 플랫폼에 HTTP/3에 대한 모든 요구 사항이 없는 경우 사용하지 않도록 설정됩니다.

HttpClient 사용

다음 코드 예제에서는 최상위 문을 사용하고 요청에서 HTTP3을 지정하는 방법을 보여 줍니다.

// See https://aka.ms/new-console-template for more information
using System.Net;

using var client = new HttpClient
{
    DefaultRequestVersion =  HttpVersion.Version30,
    DefaultVersionPolicy = HttpVersionPolicy.RequestVersionExact
};

Console.WriteLine("--- localhost:5001 ---");

HttpResponseMessage resp = await client.GetAsync("https://localhost:5001/");
string body = await resp.Content.ReadAsStringAsync();

Console.WriteLine(
    $"status: {resp.StatusCode}, version: {resp.Version}, " +
    $"body: {body.Substring(0, Math.Min(100, body.Length))}");

.NET 6의 HTTP/3 지원

.NET 6에서는 HTTP/3 사양이 아직 확정되지 않았기 때문에 HTTP/3을 미리 보기 기능 으로 사용할 수 있습니다. 동작 또는 성능 문제는 .NET 6이 있는 HTTP/3에 있을 수 있습니다. 미리 보기 기능에 대한 자세한 내용은 미리 보기 기능 사양을 참조하세요.

.NET 6에서 HTTP/3 지원을 활성화하려면 HTTP/3을 사용하도록 설정하는 데 필요한 노드 RuntimeHostConfigurationOption 및 HttpClient을 프로젝트 파일에 포함하세요.

<ItemGroup>
    <RuntimeHostConfigurationOption Value="true"
        Include="System.Net.SocketsHttpHandler.Http3Support" />
</ItemGroup>

또는 앱 코드에서 호출 System.AppContext.SetSwitch 하거나 환경 변수DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP3SUPPORT를 true .로 설정할 수 있습니다. 자세한 내용은 .NET 환경 변수( DOTNET_SYSTEM_NET_HTTP_*)를 참조하세요.

HTTP/3에 대한 구성 플래그를 요구하는 이유는 버전 정책을 RequestVersionOrHigher사용할 때 향후 중단으로부터 앱을 보호하기 위한 것입니다. 현재 HTTP/1.1 및 HTTP/2를 사용하는 서버를 호출할 때 서버가 나중에 HTTP/3으로 업그레이드하는 경우 클라이언트는 HTTP/3을 사용하려고 시도하며 표준이 최종적이지 않으므로 호환되지 않을 수 있으므로 .NET 6이 릴리스된 후에 변경될 수 있습니다.

.NET 6은 libmsquic의 1.9.x 버전과만 호환됩니다. 라이브러리의 호환성이 손상되는 변경으로 인해 Libmsquic 2.x는 .NET 6과 호환되지 않습니다. Libmsquic는 보안 픽스를 통합하는 데 필요한 경우 1.9.x에 대한 업데이트를 받습니다.

HTTP/3 서버

ASP.NET은 Kestrel 서버를 통해 HTTP/3을 지원하며, .NET 6에서는 미리 보기로, .NET 7에서는 완전히 지원됩니다. 자세한 내용은 ASP.NET Core Kestrel 웹 서버에서 HTTP/3 사용을 참조하세요.

공용 테스트 서버

Cloudflare는 클라이언트를 테스트 https://cloudflare-quic.com하는 데 사용할 수 있는 HTTP/3 사이트를 호스트합니다.