ASP.NET Core 프로젝트 문제 해결 및 디버깅
작성자: Rick Anderson
다음 링크는 문제 해결 지침을 제공합니다.
- Azure App Service 및 IIS에서 ASP.NET Core 문제 해결
- ASP.NET Core를 사용하여 Azure App Service 및 IIS에 대한 일반적인 오류 문제 해결
- NDC 컨퍼런스(런던, 2018): ASP.NET 핵심 애플리케이션의 문제 진단
- ASP.NET 블로그: ASP.NET 핵심 성능 문제 해결
.NET Core SDK 경고
.NET Core SDK 32비트 및 64비트 버전이 모두 설치되어 있습니다.
ASP.NET Core에 대한 새 프로젝트 대화 상자에서 다음과 같은 경고가 표시될 수 있습니다.
.NET Core SDK 32비트 및 64비트 버전이 모두 설치되어 있습니다. 'C:\Program Files\dotnet\sdk\'에 설치된 64비트 버전의 템플릿만 표시됩니다.
이 경고는 .NET Core SDK 32비트(x86) 및 64비트(x64) 버전이 모두 설치된 경우에 나타납니다. 두 버전이 모두 설치될 수 있는 일반적인 이유에는 다음이 포함됩니다.
- 처음에 32비트 컴퓨터를 사용하여 .NET Core SDK 설치 관리자를 다운로드한 다음, 복사하고 64비트 컴퓨터에 설치했습니다.
- 32비트 .NET Core SDK가 다른 애플리케이션에 의해 설치되었습니다.
- 잘못된 버전이 다운로드 및 설치되었습니다.
이 경고를 피하려면 32비트 .NET Core SDK를 제거합니다. 제어판>프로그램 및 기능>프로그램 제거 또는 변경에서 제거합니다. 경고가 발생하는 이유와 그 영향을 이해하는 경우 경고를 무시해도 됩니다.
.NET Core SDK는 여러 위치에 설치됩니다.
ASP.NET Core에 대한 새 프로젝트 대화 상자에서 다음과 같은 경고가 표시될 수 있습니다.
.NET Core SDK는 여러 위치에 설치됩니다. 'C:\Program Files\dotnet\sdk\'에 설치된 SDK의 템플릿만 표시됩니다.
C:\Program Files\dotnet\sdk\ 외부의 디렉터리에 .NET Core SDK를 하나 이상 설치하는 경우 이 메시지가 표시됩니다. 일반적으로 이 문제는 .NET Core SDK가 MSI 설치 관리자 대신 복사/붙여넣기를 사용하여 컴퓨터에 배포된 경우에 발생합니다.
이 경고를 방지하려면 모든 32비트 .NET Core SDK 및 런타임을 제거합니다. 제어판>프로그램 및 기능>프로그램 제거 또는 변경에서 제거합니다. 경고가 발생하는 이유와 그 영향을 이해하는 경우 경고를 무시해도 됩니다.
.NET Core SDK가 검색되지 않았습니다.
ASP.NET Core에 대한 Visual Studio 새 프로젝트 대화 상자에서 다음과 같은 경고가 표시될 수 있습니다.
.NET Core SDK를 검색하지 못했습니다. 환경 변수
PATH에 포함되어 있는지 확인하세요.dotnet명령을 실행하면 다음과 같은 경고가 표시됩니다.설치된 dotnet SDK를 찾을 수 없습니다.
이러한 경고는 환경 변수 PATH가 컴퓨터의 .NET Core SDK를 가리키지 않을 때 나타납니다. 이 문제를 해결하려면
- Install the .NET Core SDK(.NET Core SDK 설치) .NET 다운로드에서 최신 설치 관리자를 가져옵니다.
PATH환경 변수가 SDK 설치 위치를 가리키는지 확인합니다(64비트/x64의 경우C:\Program Files\dotnet\또는 32비트/x86인 경우C:\Program Files (x86)\dotnet\). SDK 설치 관리자는 일반적으로PATH를 설정합니다. 항상 동일한 비트 SDK 및 런타임을 동일한 컴퓨터에 설치합니다.
.NET Core 호스팅 번들을 설치한 후 SDK가 누락됨
.NET Core 호스팅 번들을 설치하면 .NET Core 런타임을 설치할 때 32비트(x86) 버전의 .NET Core(C:\Program Files (x86)\dotnet\)를 가리키도록 PATH를 수정합니다. 32비트(x86) .NET Core dotnet 명령을 사용하는 경우 SDK가 누락될 수 있습니다(.NET Core SDK가 검색되지않음). 이 문제를 해결하려면 C:\Program Files\dotnet\을 PATH의 C:\Program Files (x86)\dotnet\ 앞으로 이동합니다.
앱에서 데이터 얻기
앱이 요청에 응답할 수 있는 경우 미들웨어를 사용하여 앱에서 다음 데이터를 가져올 수 있습니다.
- 요청: 메서드, 체계, 호스트, 경로베이스, 경로, 쿼리 문자열, 헤더
- 연결: 원격 IP 주소, 원격 포트, 로컬 IP 주소, 로컬 포트, 클라이언트 인증서
- Identity: 이름, 표시 이름
- 구성 설정
- 환경 변수
Startup.Configure 메서드의 요청 처리 파이프라인의 시작 부분에 다음 미들웨어 코드를 추가합니다. 개발 환경에서만 코드가 실행되도록 하기 위해 미들웨어가 실행되기 전에 환경이 검사됩니다.
환경을 가져오려면 다음 방법 중 하나를 사용합니다.
IHostingEnvironment를Startup.Configure메서드에 주입하고 지역 변수를 사용하여 환경을 확인합니다. 다음 샘플 코드에서는 이 방법을 보여 줍니다.Startup클래스의 속성에 환경을 할당합니다. 속성(예:if (Environment.IsDevelopment()))을 사용하여 환경을 확인합니다.
public void Configure(IApplicationBuilder app, IHostingEnvironment env,
IConfiguration config)
{
if (env.IsDevelopment())
{
app.Run(async (context) =>
{
var sb = new StringBuilder();
var nl = System.Environment.NewLine;
var rule = string.Concat(nl, new string('-', 40), nl);
var authSchemeProvider = app.ApplicationServices
.GetRequiredService<IAuthenticationSchemeProvider>();
sb.Append($"Request{rule}");
sb.Append($"{DateTimeOffset.Now}{nl}");
sb.Append($"{context.Request.Method} {context.Request.Path}{nl}");
sb.Append($"Scheme: {context.Request.Scheme}{nl}");
sb.Append($"Host: {context.Request.Headers["Host"]}{nl}");
sb.Append($"PathBase: {context.Request.PathBase.Value}{nl}");
sb.Append($"Path: {context.Request.Path.Value}{nl}");
sb.Append($"Query: {context.Request.QueryString.Value}{nl}{nl}");
sb.Append($"Connection{rule}");
sb.Append($"RemoteIp: {context.Connection.RemoteIpAddress}{nl}");
sb.Append($"RemotePort: {context.Connection.RemotePort}{nl}");
sb.Append($"LocalIp: {context.Connection.LocalIpAddress}{nl}");
sb.Append($"LocalPort: {context.Connection.LocalPort}{nl}");
sb.Append($"ClientCert: {context.Connection.ClientCertificate}{nl}{nl}");
sb.Append($"Identity{rule}");
sb.Append($"User: {context.User.Identity.Name}{nl}");
var scheme = await authSchemeProvider
.GetSchemeAsync(IISDefaults.AuthenticationScheme);
sb.Append($"DisplayName: {scheme?.DisplayName}{nl}{nl}");
sb.Append($"Headers{rule}");
foreach (var header in context.Request.Headers)
{
sb.Append($"{header.Key}: {header.Value}{nl}");
}
sb.Append(nl);
sb.Append($"WebSockets{rule}");
if (context.Features.Get<IHttpUpgradeFeature>() != null)
{
sb.Append($"Status: Enabled{nl}{nl}");
}
else
{
sb.Append($"Status: Disabled{nl}{nl}");
}
sb.Append($"Configuration{rule}");
foreach (var pair in config.AsEnumerable())
{
sb.Append($"{pair.Path}: {pair.Value}{nl}");
}
sb.Append(nl);
sb.Append($"Environment Variables{rule}");
var vars = System.Environment.GetEnvironmentVariables();
foreach (var key in vars.Keys.Cast<string>().OrderBy(key => key,
StringComparer.OrdinalIgnoreCase))
{
var value = vars[key];
sb.Append($"{key}: {value}{nl}");
}
context.Response.ContentType = "text/plain";
await context.Response.WriteAsync(sb.ToString());
});
}
}
ASP.NET Core 앱 디버그
다음 링크는 ASP.NET Core 앱을 디버그하는 방법에 대한 정보를 제공합니다.
ASP.NET Core