Azure App Service 및 IIS에서 ASP.NET Core 문제 해결

작성자 Justin Kotalik

이 문서에서는 앱이 Azure App Service 또는 IIS에 배포될 때 일반적인 앱 시작 오류에 대한 정보와 오류 진단 방법에 대한 지침을 제공합니다.

앱 시작 오류
일반적인 시작 HTTP 상태 코드 시나리오에 대해 설명합니다.

Azure App Service 문제 해결
Azure App Service에 배포된 앱에 대한 문제 해결 조언을 제공합니다.

IIS에 대한 문제 해결
IIS에 배포되었거나 IIS Express에서 로컬로 실행되는 앱에 대한 문제 해결 조언을 제공합니다. 이 지침은 Windows Server 및 Windows 데스크톱 배포 모두에 적용됩니다.

패키지 캐시 지우기
주요 업그레이드를 수행하거나 패키지 버전을 변경할 때 일관되지 않은 패키지가 앱을 중단시킬 경우에 수행할 작업을 설명합니다.

추가 리소스
추가 문제 해결 항목을 나열합니다.

앱 시작 오류

Visual Studio에서 ASP.NET Core 프로젝트 기본 서버는 Kestrel입니다. Visual studio는 IIS Express를 사용하도록 구성할 수 있습니다. IIS Express를 이용해 로컬에서 디버그할 때 발생하는 502.5 - 프로세스 실패 또는 500.30 - 시작 실패는 이 항목의 권장 사항을 사용하여 진단할 수 있습니다.

403.14 사용할 수 없음

앱이 시작되지 않았습니다. 다음 오류가 로깅됩니다.

The Web server is configured to not list the contents of this directory.

이 오류는 일반적으로 다음과 같은 시나리오를 포함하여 호스팅 시스템의 중단된 배포로 인해 발생합니다.

• 앱이 호스팅 시스템의 잘못된 폴더에 배포됩니다.
• 배포 프로세스에서 앱의 모든 파일 및 폴더를 호스팅 시스템의 배포 폴더로 이동하지 못했습니다.
• web.config 파일이 배포에 없거나 web.config 파일 내용의 형식이 잘못되었습니다.

다음 단계를 수행합니다.

1. 호스팅 시스템의 배포 폴더에서 모든 파일과 폴더를 삭제합니다.
2. Visual Studio, PowerShell 또는 수동 배포와 같은 일반적인 배포 방법을 사용하여 앱의 게시 폴더 콘텐츠를 호스팅 시스템에 다시 배포합니다.
   • web.config 파일이 배포에 있고 내용이 올바른지 확인합니다.
   • Azure App Service에 호스트할 때 앱이 D:\home\site\wwwroot 폴더에 배포되었는지 확인합니다.
   • IIS에서 앱을 호스트하는 경우 IIS 관리자의 기본 설정에 표시되는 IIS 실제 경로에 앱이 배포되었는지 확인합니다.
3. 호스팅 시스템의 배포를 프로젝트의 publish 폴더의 콘텐츠와 비교하여 모든 앱의 파일 및 폴더가 배포되었는지 확인합니다.

게시된 ASP.NET Core 앱의 레이아웃에 대한 자세한 내용은 ASP.NET Core 디렉터리 구조를 참조하세요. web.config 파일에 대한 자세한 내용은 IIS용 ANCM(ASP.NET Core 모듈)을 참조하세요.

500 내부 서버 오류

앱이 시작되지만 오류로 인해 서버에서 요청을 처리할 수 없습니다.

이 오류는 시작하는 동안 또는 응답을 만드는 동안 앱 코드 내에서 발생합니다. 응답에 콘텐츠가 없거나 응답이 브라우저에 ‘500 내부 서버 오류’로 표시될 수 있습니다. 애플리케이션 이벤트 로그는 일반적으로 앱이 정상적으로 시작되었음을 나타냅니다. 서버의 관점에서 보면 맞습니다. 앱이 시작되었지만 유효한 응답을 생성할 수 없습니다. 서버의 명령 프롬프트에서 앱을 실행하거나 ASP.NET Core 모듈 stdout 로그를 사용하여 문제를 해결합니다.

이 오류는 .NET Core 호스팅 번들이 설치되지 않았거나 손상된 경우에도 발생할 수 있습니다. .NET Core 호스팅 번들(IIS의 경우) 또는 Visual Studio(IIS Express의 경우)를 설치 또는 복구하면 이 문제가 해결될 수 있습니다.

500.0 In-Process 처리기 로드 실패

작업자 프로세스가 실패합니다. 앱이 시작되지 않습니다.

ASP.NET Core 모듈 구성 요소를 로드하는 중 알 수 없는 오류가 발생했습니다. 다음 작업 중 하나를 수행합니다.

• Microsoft 지원에 문의하세요(개발자 도구를 선택한 다음, ASP.NET Core 선택).
• Stack Overflow에 대해 질문하세요.
• GitHub 리포지토리에 문제를 제기하세요.

500.30 In-Process 시작 실패

작업자 프로세스가 실패합니다. 앱이 시작되지 않습니다.

ASP.NET Core 모듈이 .NET Core CLR in-process를 시작하려고 하지만 시작할 수 없습니다. 프로세스 시작 실패의 원인은 일반적으로 애플리케이션 이벤트 로그 및 ASP.NET Core 모듈 stdout 로그의 항목에서 확인할 수 있습니다.

일반적인 오류 조건:

• 존재하지 않는 ASP.NET Core 공유 프레임워크의 버전을 대상으로 하여 앱이 잘못 구성되었습니다. 대상 머신에 설치된 ASP.NET Core 공유 프레임워크의 버전을 확인합니다.
• Azure Key Vault를 사용할 경우 Key Vault에 대한 사용 권한이 부족합니다. 대상 Key Vault의 액세스 정책을 확인하여 올바른 사용 권한이 부여되었는지 확인합니다.

500.31 ANCM 네이티브 종속성을 찾지 못함

작업자 프로세스가 실패합니다. 앱이 시작되지 않습니다.

ASP.NET Core 모듈이 진행 중인 .NET Core 런타임을 시작하려고 하지만 시작할 수 없습니다. 이 시작 오류의 가장 일반적인 원인은 Microsoft.NETCore.App 또는 Microsoft.AspNetCore.App 런타임이 설치되어 있지 않은 경우입니다. 앱이 대상 ASP.NET Core 3.0에 배포되고 해당 버전이 머신에 없는 경우 이 오류가 발생합니다. 예제 오류 메시지는 다음과 같습니다.

The specified framework 'Microsoft.NETCore.App', version '3.0.0' was not found.
  - The following frameworks were found:
      2.2.1 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App]
      3.0.0-preview5-27626-15 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App]
      3.0.0-preview6-27713-13 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App]
      3.0.0-preview6-27714-15 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App]
      3.0.0-preview6-27723-08 at [C:\Program Files\dotnet\x64\shared\Microsoft.NETCore.App]

오류 메시지는 설치된 모든 .NET Core 버전과 앱에서 요청한 버전을 나열합니다. 이 오류를 해결하려면 다음 중 하나를 수행합니다.

• 머신에 적절한 버전의 .NET Core를 설치합니다.
• 머신에 있는 .NET Core 버전을 대상으로 앱을 변경합니다.
• 자체 포함 배포로 앱을 게시합니다.

개발 중에 실행될 때(ASPNETCORE_ENVIRONMENT 환경 변수가 Development로 설정됨) 특정 오류가 HTTP 응답에 기록됩니다. 프로세스 시작 실패의 원인은 애플리케이션 이벤트 로그에도 있습니다.

500.32 ANCM dll을 로드하지 못함

작업자 프로세스가 실패합니다. 앱이 시작되지 않습니다.

이 오류의 가장 일반적인 원인은 앱이 호환되지 않는 프로세서 아키텍처에 대해 게시되기 때문입니다. 작업자 프로세스가 32비트 앱으로 실행 중이고 해당 앱이 대상 64 비트로 게시된 경우 이 오류가 발생합니다.

이 오류를 해결하려면 다음 중 하나를 수행합니다.

• 작업자 프로세스와 동일한 프로세서 아키텍처에 대해 앱을 다시 게시합니다.
• 앱을 프레임워크 종속 배포로 게시합니다.

500.33 ANCM 요청 처리기 로드 실패

작업자 프로세스가 실패합니다. 앱이 시작되지 않습니다.

앱이 Microsoft.AspNetCore.App 프레임워크를 참조하지 않습니다. Microsoft.AspNetCore.App 프레임워크를 대상으로 하는 앱만 ASP.NET Core 모듈에서 호스트할 수 있습니다.

이 오류를 해결하려면 앱이 Microsoft.AspNetCore.App 프레임워크를 대상으로 하는지 확인합니다. .runtimeconfig.json을 확인하여 앱이 대상으로 하는 프레임워크를 확인합니다.

500.34 ANCM 혼합된 호스팅 모델이 지원되지 않음

작업자 프로세스는 동일한 프로세스에서 In Process 앱과 out-of-process 앱을 모두 실행할 수 없습니다.

이 오류를 해결하려면 별도의 IIS 애플리케이션 풀에서 앱을 실행합니다.

500.35 ANCM 동일한 프로세스의 여러 In-Process 애플리케이션

작업자 프로세스는 동일한 프로세스에서 여러 in-process 앱을 실행할 수 없습니다.

이 오류를 해결하려면 별도의 IIS 애플리케이션 풀에서 앱을 실행합니다.

500.36 ANCM Out-Of-Process 처리기 로드 실패

Out-of-process 요청 처리기, aspnetcorev2_outofprocess.dll이 aspnetcorev2.dll 파일 옆에 없습니다. 이는 ASP.NET Core 모듈의 손상된 설치를 나타냅니다.

이 오류를 해결하려면 .NET Core 호스팅 번들(IIS의 경우) 또는 Visual Studio(IIS Express의 경우)의 설치를 복구합니다.

500.37 ANCM 시작 시간 제한 내에 시작하지 못함

제공된 시작 시간 제한 내에 ANCM을 시작하지 못했습니다. 기본적으로 제한 시간은 120초입니다.

이 오류는 동일한 머신에서 많은 수의 앱을 시작할 때 발생할 수 있습니다. 시작하는 동안 서버에서 CPU/메모리 사용량이 급증하는지 확인합니다. 여러 앱의 시작 프로세스를 분산해야 합니다.

500.38 ANCM 애플리케이션 DLL을 찾을 수 없음

ANCM에서 실행 파일 옆에 있어야 하는 애플리케이션 DLL을 찾지 못했습니다.

이 오류는 단일 파일 실행 파일로 패키지된 앱을 In-process 호스팅 모델을 사용하여 호스트할 때 발생합니다. In-process 모델을 사용하려면 ANCM에서 .NET Core 앱을 기존 IIS 프로세스로 로드해야 합니다. 단일 파일 배포 모델에서는 이 시나리오가 지원되지 않습니다. 앱의 프로젝트 파일에서 다음 방법 중 하나를 사용하여 이 오류를 해결합니다.

1. PublishSingleFile MSBuild 속성을 false로 설정하여 단일 파일 게시를 사용하지 않도록 설정합니다.
2. AspNetCoreHostingModel MSBuild 속성을 OutOfProcess로 설정하여 out-of-process 호스팅 모델로 전환합니다.

502.5 프로세스 오류

작업자 프로세스가 실패합니다. 앱이 시작되지 않습니다.

ASP.NET Core 모듈이 작업자 프로세스를 시작하려고 하지만 시작할 수 없습니다. 프로세스 시작 실패의 원인은 일반적으로 애플리케이션 이벤트 로그 및 ASP.NET Core 모듈 stdout 로그의 항목에서 확인할 수 있습니다.

일반적인 실패 조건은 존재하지 않는 ASP.NET Core 공유 프레임워크의 버전을 대상으로 하여 앱이 잘못 구성되었다는 것입니다. 대상 머신에 설치된 ASP.NET Core 공유 프레임워크의 버전을 확인합니다. 공유 프레임워크는 컴퓨터에 설치되고 메타패키지(예: Microsoft.AspNetCore.App메타패키지)에서 참조되는 어셈블리 집합(.dll 파일)입니다. 메타패키지 참조는 필요한 최소 버전을 지정할 수 있습니다. 자세한 내용은 공유 프레임워크를 참조하세요.

호스팅 또는 앱의 잘못된 구성으로 인해 작업자 프로세스가 실패하면 ‘502.5 프로세스 실패’ 오류 페이지가 반환됩니다.

애플리케이션을 시작하지 못함(오류 코드 '0x800700c1')

EventID: 1010
Source: IIS AspNetCore Module V2
Failed to start application '/LM/W3SVC/6/ROOT/', ErrorCode '0x800700c1'.

앱의 어셈블리(.dll)를 로드할 수 없기 때문에 앱을 시작하지 못했습니다.

게시된 앱과 w3wp/iisexpress 프로세스 간에 비트 수가 불일치하는 경우 이 오류가 발생합니다.

앱 풀의 32비트 설정이 올바른지 확인합니다.

1. IIS 관리자의 애플리케이션 풀에서 앱 풀을 선택합니다.
2. 작업 패널의 애플리케이션 풀 편집에서 고급 설정을 선택합니다.
3. 32비트 애플리케이션 사용 설정:
   • 32비트(x86) 앱을 배포하는 경우 값을 True로 설정합니다.
   • 64비트(x64) 앱을 배포하는 경우 값을 False로 설정합니다.

프로젝트 파일의 <Platform> MSBuild 속성과 앱의 게시된 비트 간에 충돌이 없는지 확인합니다.

애플리케이션을 시작하지 못했습니다(ErrorCode '0x800701b1')

EventID: 1010
Source: IIS AspNetCore Module V2
Failed to start application '/LM/W3SVC/3/ROOT', ErrorCode '0x800701b1'.

Windows 서비스를 로드하지 못해 앱을 시작하지 못했습니다.

사용하도록 설정해야 하는 일반적인 서비스 중 하나는 "null" 서비스입니다. 다음 명령을 사용하면 Windows 서비스를 사용할 수 null 있습니다.

sc.exe start null

연결 다시 설정

헤더가 전송된 후 오류가 발생할 경우, 오류가 발생할 때 서버에서 500 내부 서버 오류를 전송하는 것은 너무 늦은 것입니다. 응답에 대한 복잡한 개체의 serialization 중에 오류가 발생할 때 이 문제가 종종 발생합니다. 이 유형의 오류는 클라이언트에서 ‘연결 다시 설정’ 오류로 나타납니다. 애플리케이션 로깅은 이러한 유형의 오류를 해결하는 데 도움이 될 수 있습니다.

기본 시작 제한

ASP.NET Core 모듈은 기본 startupTimeLimit가 120초로 구성됩니다. 기본값으로 남아 있으면 앱에서 모듈이 프로세스 실패를 기록하기 전에 시작하는 데 최대 2분이 걸릴 수 있습니다. 모듈 구성에 대한 자세한 내용은 aspNetCore 요소의 특성을 참조하세요.

Azure App Service 문제 해결

Important

Azure App Service를 포함한 ASP.NET Core 미리 보기 릴리스

ASP.NET Core 미리 보기 릴리스는 기본적으로 Azure App Service에 배포되지 않습니다. ASP.NET Core 미리 보기 릴리스를 사용하는 앱을 호스팅하려면 Azure App Service에 ASP.NET Core 미리 보기 릴리스 배포를 참조하세요.

Azure App Service 로그 스트리밍

Azure App Service 로그는 로깅 정보가 발생하는 대로 스트리밍합니다. 스트리밍 로그를 보려면:

1. Azure Portal에서 Azure App Services의 앱을 엽니다.
2. 왼쪽 창에서 모니터링>App Service 로그로 이동합니다.
3. 웹 서버 로깅용 파일 시스템을 선택합니다. 필요에 따라 애플리케이션 로깅을 사용하도록 설정합니다.
4. 왼쪽 창에서 모니터링>로그 스트림으로 이동한 다음, 애플리케이션 로그 또는 웹 서버 로그를 선택합니다.

다음 이미지는 애플리케이션 로그 출력을 보여 줍니다.

스트리밍 로그에는 약간의 대기 시간이 있으며 즉시 표시되지 않을 수 있습니다.

애플리케이션 이벤트 로그(Azure App Service)

애플리케이션 이벤트 로그에 액세스하려면 Azure Portal에서 문제 진단 및 해결 블레이드를 사용합니다.

1. Azure Portal에서 Azure App Services의 앱을 엽니다.
2. 문제 진단 및 해결을 선택합니다.
3. 진단 도구 제목을 선택합니다.
4. 지원 도구에서 애플리케이션 이벤트 단추를 선택합니다.
5. 원본 열에서 IIS AspNetCoreModule 또는 IIS AspNetCoreModule V2 항목이 제공하는 최신 오류를 검토합니다.

문제 진단 및 해결 블레이드를 사용하는 대신에 Kudu를 사용하여 애플리케이션 이벤트 로그 파일을 직접 검토하는 것입니다.

1. 개발 도구 영역에서 고급 도구를 엽니다. Go→ 단추를 선택합니다. 새 브라우저 탭 또는 창에서 Kudu 콘솔이 열립니다.
2. 페이지 위쪽의 탐색 모음을 사용하여 디버그 콘솔을 열고 CMD를 선택합니다.
3. LogFiles 폴더를 엽니다.
4. eventlog.xml 파일 옆에 있는 연필 아이콘을 선택합니다.
5. 로그를 검토합니다. 로그 아래쪽으로 스크롤하여 가장 최근 이벤트를 확인합니다.

Kudu 콘솔에서 앱 실행

애플리케이션 이벤트 로그에서 대부분의 시작 오류는 유용한 정보를 생성하지 않습니다. Kudu 원격 실행 콘솔에서 앱을 실행하여 오류를 검색할 수 있습니다.

1. 개발 도구 영역에서 고급 도구를 엽니다. Go→ 단추를 선택합니다. 새 브라우저 탭 또는 창에서 Kudu 콘솔이 열립니다.
2. 페이지 위쪽의 탐색 모음을 사용하여 디버그 콘솔을 열고 CMD를 선택합니다.

32비트(x86) 앱 테스트

현재 릴리스

1. cd d:\home\site\wwwroot
2. 앱을 실행합니다.

   • 앱이 프레임워크 종속 배포인 경우:

     dotnet .\{ASSEMBLY NAME}.dll
     

   • 앱이 자체 포함 배포인 경우:

     {ASSEMBLY NAME}.exe
     

오류를 표시하는 앱의 콘솔 출력이 Kudu 콘솔로 파이프됩니다.

미리 보기 릴리스에서 실행되는 프레임워크 종속 배포

ASP.NET Core {VERSION}(x86) 런타임 사이트 확장을 설치해야 합니다.

1. cd D:\home\SiteExtensions\AspNetCoreRuntime.{X.Y}.x32({X.Y}는 런타임 버전임)
2. 앱을 실행합니다. dotnet \home\site\wwwroot\{ASSEMBLY NAME}.dll

오류를 표시하는 앱의 콘솔 출력이 Kudu 콘솔로 파이프됩니다.

64비트(x64) 앱 테스트

현재 릴리스

• 앱이 64비트(x64) 프레임워크 종속 배포인 경우:
  1. cd D:\Program Files\dotnet
  2. 앱을 실행합니다. dotnet \home\site\wwwroot\{ASSEMBLY NAME}.dll
• 앱이 자체 포함된 배포인 경우:
  1. cd D:\home\site\wwwroot
  2. 앱을 실행합니다. {ASSEMBLY NAME}.exe

오류를 표시하는 앱의 콘솔 출력이 Kudu 콘솔로 파이프됩니다.

미리 보기 릴리스에서 실행되는 프레임워크 종속 배포

ASP.NET Core {VERSION}(x64) 런타임 사이트 확장을 설치해야 합니다.

1. cd D:\home\SiteExtensions\AspNetCoreRuntime.{X.Y}.x64({X.Y}는 런타임 버전임)
2. 앱을 실행합니다. dotnet \home\site\wwwroot\{ASSEMBLY NAME}.dll

오류를 표시하는 앱의 콘솔 출력이 Kudu 콘솔로 파이프됩니다.

ASP.NET Core 모듈 stdout 로그(Azure App Service)

Warning

stdout 로그를 사용하지 않도록 설정하지 않으면 앱 또는 서버 오류가 발생할 수 있습니다. 로그 파일 크기 또는 생성되는 로그 파일 수에 대한 제한은 없습니다. 앱 시작 문제를 해결하려면 stdout 로깅만 사용합니다.

시작 후 ASP.NET Core 앱의 일반적인 로깅에는 로그 파일 크기를 제한하고 로그를 회전하는 로깅 라이브러리를 사용합니다. 자세한 내용은 타사 로깅 공급자를 참조하세요.

ASP.NET Core 모듈 stdout 로그는 종종 애플리케이션 이벤트 로그에서 찾을 수 없는 유용한 오류 메시지를 기록합니다. stdout 로그를 사용하고 보려면:

1. Azure Portal에서 웹앱으로 이동합니다.
2. App Service 블레이드에서 검색 상자에 kudu를 입력합니다.
3. 고급 도구>Go를 선택합니다.
4. 디버그 콘솔 > CMD를 선택합니다.
5. site/wwwroot로 이동합니다.
6. 연필 아이콘을 선택하여 web.config 파일을 편집합니다.
7. <aspNetCore /> 요소에서 stdoutLogEnabled="true"를 설정하고 저장를 선택합니다.

문제 해결이 완료되면 stdout 로깅을 사용하지 않도록 stdoutLogEnabled="false"를 설정합니다.

자세한 내용은 IIS용 ANCM(ASP.NET Core 모듈)을 참조하세요.

ASP.NET Core 모듈 디버그 로그(Azure App Service)

ASP.NET Core 모듈 디버그 로그는 ASP.NET Core 모듈에서 추가로 심층적인 로깅을 제공합니다. stdout 로그를 사용하고 보려면:

1. 향상된 진단 로그를 사용하도록 설정하려면 다음 중 하나를 수행합니다.
   • 개선된 진단 로그의 지침에 따라 개선된 진단 로깅을 위한 앱을 구성합니다. 앱을 다시 배포합니다.
   • <handlerSettings> Kudu 콘솔을 사용하여 라이브 앱의 web.config 파일에 고급 진단 로그에 표시된 항목을 추가합니다.
     1. 개발 도구 영역에서 고급 도구를 엽니다. Go→ 단추를 선택합니다. 새 브라우저 탭 또는 창에서 Kudu 콘솔이 열립니다.
     2. 페이지 위쪽의 탐색 모음을 사용하여 디버그 콘솔을 열고 CMD를 선택합니다.
     3. 폴더를 site>wwwroot 경로로 엽니다. 연필 단추를 선택하여 web.config 파일을 편집합니다. 개선된 진단 로그에 표시된 대로 <handlerSettings> 섹션을 추가합니다. 저장 단추를 선택합니다.
2. 개발 도구 영역에서 고급 도구를 엽니다. Go→ 단추를 선택합니다. 새 브라우저 탭 또는 창에서 Kudu 콘솔이 열립니다.
3. 페이지 위쪽의 탐색 모음을 사용하여 디버그 콘솔을 열고 CMD를 선택합니다.
4. 폴더를 site>wwwroot 경로로 엽니다. aspnetcore debug.log 파일에 대한 경로를 제공하지 않는 경우 파일이 목록에 나타납니다. 경로를 제공한 경우 로그 파일의 위치로 이동합니다.
5. 파일 이름 옆의 연필 단추를 사용하여 로그 파일을 엽니다.

문제 해결이 완료되면 디버그 로깅을 사용하지 않도록 설정합니다.

향상된 디버그 로그를 사용하지 않도록 설정하려면 다음 중 하나를 수행합니다.

• web.config 파일에서 <handlerSettings>를 로컬에서 제거하고 앱을 다시 배포합니다.
• Kudu 콘솔을 사용하여 web.config 파일을 편집하고 <handlerSettings> 섹션을 제거합니다. 파일을 저장합니다.

자세한 내용은 ASP.NET Core 모듈을 사용하여 로그 만들기 및 리디렉션을 참조하세요.

Warning

디버그 로그를 사용하지 않도록 설정하지 않으면 앱 또는 서버 오류가 발생할 수 있습니다. 로그 파일 크기에는 제한이 없습니다. 앱 시작 문제를 해결하려면 디버그 로깅만 사용합니다.

시작 후 ASP.NET Core 앱의 일반적인 로깅에는 로그 파일 크기를 제한하고 로그를 회전하는 로깅 라이브러리를 사용합니다. 자세한 내용은 타사 로깅 공급자를 참조하세요.

느리거나 중단된 앱(Azure App Service)

앱이 요청 시 느리게 응답하거나 중단될 경우 Azure App Service에서 느린 웹 앱 성능 문제 해결을 참조하세요.

모니터링 블레이드

모니터링 블레이드는 이 항목의 앞부분에서 설명된 방법에 대한 대체 문제 해결 환경을 제공합니다. 이 블레이드를 사용하여 500 시리즈 오류를 진단할 수 있습니다.

ASP.NET Core 확장이 설치되어 있는지 확인합니다. 확장이 설치되어 있지 않으면 수동으로 설치합니다.

1. 개발 도구 블레이드 섹션에서 확장 블레이드를 선택합니다.
2. ASP.NET Core 확장이 목록에 표시됩니다.
3. 확장이 설치되어 있지 않으면 추가 단추를 선택합니다.
4. 목록에서 ASP.NET Core 확장을 선택합니다.
5. 확인을 선택하여 적합한 조건을 적용합니다.
6. 확장 추가 블레이드에서 확인을 선택합니다.
7. 정보 팝업 메시지는 확장이 성공적으로 설치되었음을 나타냅니다.

stdout 로깅을 사용할 수 없는 경우 다음 단계를 따릅니다.

1. Azure Portal에서 개발 도구 영역의 고급 도구 블레이드를 선택합니다. Go→ 단추를 선택합니다. 새 브라우저 탭 또는 창에서 Kudu 콘솔이 열립니다.
2. 페이지 위쪽의 탐색 모음을 사용하여 디버그 콘솔을 열고 CMD를 선택합니다.
3. site>wwwroot 경로로 폴더를 열고 아래로 스크롤하여 목록 아래쪽에 있는 web.config 파일을 표시합니다.
4. web.config 파일 옆에 있는 연필 아이콘을 클릭합니다.
5. stdoutLogEnabled를 true로 설정하고 stdoutLogFile 경로를 \\?\%home%\LogFiles\stdout로 변경합니다.
6. 저장을 선택하여 업데이트된 web.config 파일을 저장합니다.

계속해서 진단 로깅을 활성화합니다.

1. Azure Portal에서 진단 로그 블레이드를 선택합니다.
2. 애플리케이션 로깅(파일 시스템) 및 자세한 오류 메시지에 대해 켜기 스위치를 선택합니다. 블레이드 위쪽에 있는 저장 단추를 선택합니다.
3. FREB(실패한 요청 이벤트 버퍼링) 로깅이라고도 하는 실패한 요청 추적을 포함하려면 실패한 요청 추적에 대해 켜기 스위치를 선택합니다.
4. 포털의 진단 로그 블레이드 바로 아래에 나열된 로그 스트림 블레이드를 선택합니다.
5. 앱에 대한 요청을 실행합니다.
6. 로그 스트림 데이터 내에 오류의 원인이 표시됩니다.

문제 해결이 완료되면 stdout 로깅을 사용하지 않도록 설정해야 합니다.

실패한 요청 추적 로그(FREB 로그)를 보려면:

1. Azure Portal에서 문제 진단 및 해결 블레이드로 이동합니다.
2. 사이드바의 지원 도구 영역에서 실패한 요청 추적 로그를 선택합니다.

Azure App Service에서 웹앱에 대한 진단 로깅 사용 항목의 실패한 요청 추적 섹션 및 Azure의 웹앱에 대한 애플리케이션 성능 FAQ: 실패한 요청 추적을 켜려면 어떻게 해야 하나요?를 참조하세요.

자세한 내용은 Azure App Service에서 웹앱에 대한 진단 로깅 사용을 참조하세요.

Warning

stdout 로그를 사용하지 않도록 설정하지 않으면 앱 또는 서버 오류가 발생할 수 있습니다. 로그 파일 크기 또는 생성되는 로그 파일 수에 대한 제한은 없습니다.

ASP.NET Core 앱의 루틴 로깅에는 로그 파일 크기를 제한하고 로그를 회전하는 로깅 라이브러리를 사용합니다. 자세한 내용은 타사 로깅 공급자를 참조하세요.

IIS에 대한 문제 해결

애플리케이션 이벤트 로그(IIS)

애플리케이션 이벤트 로그에 액세스합니다.

1. 시작 메뉴를 열고 이벤트 뷰어를 검색한 다음, 이벤트 뷰어 앱을 선택합니다.
2. 이벤트 뷰어에서 Windows 로그 노드를 엽니다.
3. 애플리케이션을 선택하여 애플리케이션 이벤트 로그를 엽니다.
4. 실패한 앱과 연결된 오류를 검색합니다. 오류는 ‘소스’ 열에서 ‘IIS AspNetCore 모듈’ 또는 ‘IIS Express AspNetCore 모듈’의 값을 포함합니다.

명령 프롬프트에서 앱 실행

애플리케이션 이벤트 로그에서 대부분의 시작 오류는 유용한 정보를 생성하지 않습니다. 호스팅 시스템의 명령 프롬프트에서 앱을 실행하여 일부 오류의 원인을 찾을 수 있습니다.

프레임워크 종속 배포

앱이 프레임워크 종속 배포인 경우:

1. 명령 프롬프트에서 배포 폴더로 이동하고 dotnet.exe로 앱의 어셈블리를 실행하여 앱을 실행합니다. 다음 명령에서 <assembly_name>: dotnet .\<assembly_name>.dll을 앱 어셈블리의 이름으로 바꿉니다.
2. 오류를 표시하는 앱의 콘솔 출력이 콘솔 창에 기록됩니다.
3. 앱에 대한 요청을 실행할 때 오류가 발생하는 경우에는 Kestrel이 수신 대기하는 호스트 및 포트에 대한 요청을 실행합니다. 기본 호스트 및 게시를 사용하여 http://localhost:5000/에 대한 요청을 실행합니다. 앱이 Kestrel 엔드포인트 주소에서 정상적으로 응답하는 경우 문제는 호스팅 구성과 관련이 있으며 앱 내에서 관련되었을 가능성은 작습니다.

자체 포함 배포

앱이 자체 포함 배포인 경우:

1. 명령 프롬프트에서 배포 폴더로 이동하고 앱의 실행 파일을 실행합니다. 다음 명령에서 <assembly_name>: <assembly_name>.exe을 앱 어셈블리의 이름으로 바꿉니다.
2. 오류를 표시하는 앱의 콘솔 출력이 콘솔 창에 기록됩니다.
3. 앱에 대한 요청을 실행할 때 오류가 발생하는 경우에는 Kestrel이 수신 대기하는 호스트 및 포트에 대한 요청을 실행합니다. 기본 호스트 및 게시를 사용하여 http://localhost:5000/에 대한 요청을 실행합니다. 앱이 Kestrel 엔드포인트 주소에서 정상적으로 응답하는 경우 문제는 호스팅 구성과 관련이 있으며 앱 내에서 관련되었을 가능성은 작습니다.

ASP.NET Core 모듈 stdout 로그(IIS)

stdout 로그를 사용하고 보려면:

1. 호스팅 시스템에서 사이트의 배포 폴더로 이동합니다.
2. logs 폴더가 없으면 폴더를 만듭니다. MSBuild를 사용하여 배포에서 logs 폴더를 자동으로 만드는 방법에 대한 지침은 디렉터리 구조 항목을 참조하세요.
3. web.config 파일을 편집합니다. stdoutLogEnabled를 true로 설정하고 stdoutLogFile 경로가 logs 폴더를 가리키도록 변경합니다(예: .\logs\stdout). 경로의 stdout은 로그 파일 이름 접두사입니다. 로그가 만들어질 때 타임스탬프, 프로세스 ID 및 파일 확장명이 자동으로 추가됩니다. stdout을 파일 이름 접두사로 사용하여 일반적인 로그 파일의 이름은 stdout_20180205184032_5412.log로 지정됩니다.
4. 애플리케이션 풀의 ID에 로그 폴더에 대한 쓰기 권한이 있는지 확인합니다.
5. 업데이트된 web.config 파일을 저장합니다.
6. 앱에 대한 요청을 실행합니다.
7. logs 폴더로 이동합니다. 가장 최근의 stdout 로그를 찾아서 엽니다.
8. 오류에 대한 로그를 검토합니다.

문제 해결이 완료되면 stdout 로깅을 사용하지 않도록 설정합니다.

1. web.config 파일을 편집합니다.
2. stdoutLogEnabled를 false로 설정합니다.
3. 파일을 저장합니다.

자세한 내용은 IIS용 ANCM(ASP.NET Core 모듈)을 참조하세요.

Warning

stdout 로그를 사용하지 않도록 설정하지 않으면 앱 또는 서버 오류가 발생할 수 있습니다. 로그 파일 크기 또는 생성되는 로그 파일 수에 대한 제한은 없습니다.

ASP.NET Core 앱의 루틴 로깅에는 로그 파일 크기를 제한하고 로그를 회전하는 로깅 라이브러리를 사용합니다. 자세한 내용은 타사 로깅 공급자를 참조하세요.

ASP.NET Core 모듈 디버그 로그(IIS)

앱의 web.config 파일에 다음 처리기 설정을 추가하여 ASP.NET Core 모듈 디버그 로그를 사용하도록 설정합니다.

<aspNetCore ...>
  <handlerSettings>
    <handlerSetting name="debugLevel" value="file" />
    <handlerSetting name="debugFile" value="c:\temp\ancm.log" />
  </handlerSettings>
</aspNetCore>

로그에 대해 지정된 경로가 있는지 및 앱 풀의 ID에 해당 위치에 대한 쓰기 권한이 있는지 확인합니다.

자세한 내용은 ASP.NET Core 모듈을 사용하여 로그 만들기 및 리디렉션을 참조하세요.

개발자 예외 페이지 사용

ASPNETCORE_ENVIRONMENT환경 변수를 web.config에 추가하여 개발 환경에서 앱을 실행할 수 있습니다. 앱 시작 시 호스트 작성기의 UseEnvironment에 의해 환경이 재정의되지 않는 한, 환경 변수를 설정하면 앱이 실행될 때 개발자 예외 페이지가 표시될 수 있습니다.

<aspNetCore processPath="dotnet"
      arguments=".\MyApp.dll"
      stdoutLogEnabled="false"
      stdoutLogFile=".\logs\stdout"
      hostingModel="InProcess">
  <environmentVariables>
    <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
  </environmentVariables>
</aspNetCore>

ASPNETCORE_ENVIRONMENT에 대한 환경 변수 설정은 인터넷에 노출되지 않은 스테이징 및 테스트 서버에서만 사용하는 것이 좋습니다. 문제를 해결한 후 web.config 파일에서 환경 변수를 제거합니다. web.config에서 환경 변수를 설정하는 방법에 대한 자세한 내용은aspNetCore의 environmentVariables 자식 요소를 참조하세요.

앱에서 데이터 얻기

앱이 요청에 응답할 수 있는 경우 터미널 인라인 미들웨어를 사용하여 앱에서 요청, 연결 및 추가 데이터를 가져옵니다. 자세한 내용 및 샘플 코드는 ASP.NET Core 프로젝트 문제 해결 및 디버그를 참조하세요.

앱이 느리거나 중단됨(IIS)

크래시 덤프는 시스템 메모리의 스냅샷이며 앱 충돌, 시작 실패 또는 느린 앱의 원인을 확인하는 데 도움이 됩니다.

앱 충돌 또는 예외 발생

WER(Windows 오류 보고)에서 덤프를 얻고 분석합니다.

1. c:\dumps에 크래시 덤프 파일을 저장할 폴더를 만듭니다. 앱 풀에는 폴더에 대한 쓰기 액세스 권한이 있어야 합니다.

2. EnableDumps PowerShell 스크립트 실행:

   • 앱에서 in-process 호스팅 모델을 사용하는 경우 w3wp.exe에 대한 스크립트 실행:

     .\EnableDumps w3wp.exe c:\dumps
     

   • 앱에서 out-of-process 호스팅 모델을 사용하는 경우 dotnet.exe에 대한 스크립트 실행:

     .\EnableDumps dotnet.exe c:\dumps
     

3. 충돌이 발생하는 조건에서 앱을 실행합니다.

4. 충돌이 발생한 후 DisableDumps PowerShell 스크립트 실행:

   • 앱에서 in-process 호스팅 모델을 사용하는 경우 w3wp.exe에 대한 스크립트 실행:

     .\DisableDumps w3wp.exe
     

   • 앱에서 out-of-process 호스팅 모델을 사용하는 경우 dotnet.exe에 대한 스크립트 실행:

     .\DisableDumps dotnet.exe
     

앱이 충돌하고 덤프 수집이 완료되면 앱이 정상적으로 종료될 수 있습니다. PowerShell 스크립트는 앱당 최대 5개의 덤프를 수집하도록 WER을 구성합니다.

Warning

크래시 덤프는 많은 양의 디스크 공간(각각 여러 기가바이트까지)을 차지할 수 있습니다.

앱 중단 시작 중에 실패 또는 정상적으로 실행

앱이 중단되거나(응답이 중지되지만 충돌하지 않음) 시작 중에 실패하거나 정상적으로 실행되면 사용자 모드 덤프 파일: 덤프를 생성할 적절한 도구를 선택하기 위한 최상의 도구 선택을 참조하세요.

덤프 분석

덤프는 여러 방법을 사용하여 분석할 수 있습니다. 자세한 내용은 사용자 모드 덤프 파일 분석을 참조하세요.

패키지 캐시 지우기

개발 컴퓨터의 .NET Core SDK 또는 앱 내의 패키지 버전을 업그레이드하거나 앱 내 패키지 버전을 변경한 후 즉시 작동 중인 앱에서 오류가 발생할 수 있습니다. 경우에 따라 중요한 업그레이드를 수행할 때 일관되지 않은 패키지로 인해 응용 프로그램이 중단될 수 있습니다. 이러한 대부분의 문제는 다음 지침에 따라 수정할 수 있습니다.

1. bin 및 obj 폴더를 삭제합니다.

2. 명령 셸에서 dotnet nuget locals all --clear를 실행하여 패키지 캐시를 지웁니다.

   nuget.exe 도구에서 nuget locals all -clear 명령을 실행하여 패키지 캐시를 지울 수도 있습니다. nuget.exe는 Windows 데스크톱 운영 체제와 함께 제공되는 설치가 아니므로 NuGet 웹 사이트에서 별도로 다운로드해야 합니다.

3. 프로젝트를 복원하고 다시 빌드합니다.

4. 앱을 다시 배포하기 전에 서버의 배포 폴더에 있는 모든 파일을 삭제합니다.

상태 코드 및 로그 항목 수집

IIS에서 실행되는 ASP.NET Core 앱에 오류가 발생하면 문제를 진단하는 데 도움이 되는 정보를 수집합니다. 문제 해결에 유용한 정보는 다음과 같습니다. 다음 정보를 수집합니다.

• 브라우저 동작(상태 코드 및 오류 메시지 등)
• 애플리케이션 이벤트 로그 항목
  • Azure App Service: Azure App Service 및 IIS에서 ASP.NET Core 문제 해결을 참조하세요.
  • IIS
    1. Windows 메뉴에서 시작을 선택하고, 이벤트 뷰어를 입력하고, Enter를 누릅니다.
    2. 이벤트 뷰어가 열리면 사이드바에서 Windows 로그>애플리케이션을 확장합니다.
• ASP.NET 핵심 모듈 stdout 및 디버그 로그 항목
  • Azure App Service: Azure App Service 및 IIS에서 ASP.NET Core 문제 해결을 참조하세요.
  • IIS: ASP.NET Core 모듈 항목의 로그 만들기 및 리디렉션 및 향상된 진단 로그 섹션의 지침을 따릅니다.

오류 정보를 다음 일반 오류와 비교합니다. 일치하는 항목이 발견되면 문제 해결 권장 사항을 따릅니다.

이 항목의 오류 목록은 완전하지 않습니다. 여기에 나열되지 않은 오류가 발생하는 경우 오류를 재현하는 방법에 대한 자세한 지침과 함께 이 항목 하단에 있는 콘텐츠 피드백 단추를 사용하여 새 문제를 엽니다.

Important

Azure App Service를 포함한 ASP.NET Core 미리 보기 릴리스

ASP.NET Core 미리 보기 릴리스는 기본적으로 Azure App Service에 배포되지 않습니다. ASP.NET Core 미리 보기 릴리스를 사용하는 앱을 호스팅하려면 Azure App Service에 ASP.NET Core 미리 보기 릴리스 배포를 참조하세요.

OS 업그레이드에서 32비트 ASP.NET Core 모듈이 제거됨

애플리케이션 로그: 모듈 DLL C:\WINDOWS\system32\inetsrv\aspnetcore.dll을(를) 로드하지 못했습니다. 데이터 오류입니다.

문제 해결:

OS를 업그레이드하는 동안 C:\Windows\SysWOW64\inetsrv 디렉터리에 있는 비OS 파일은 보존되지 않습니다. OS를 업그레이드하기 전에 ASP.NET Core 모듈을 설치한 다음, OS를 업그레이드한 후에 32비트 모드에서 앱 풀을 실행하면 이 문제가 발생합니다. OS를 업그레이드한 후에 ASP.NET Core 모듈을 복구합니다. .NET Core 호스팅 번들 설치를 참조하세요. 설치 관리자가 실행될 때 복구를 선택합니다.

사이트 확장 누락, 32비트(x86) 및 64비트(x64) 사이트 확장이 설치됨 또는 잘못된 프로세스 비트 수가 설정됨

Azure 앱 서비스에서 호스트하는 앱에 적용됩니다.

• 브라우저: HTTP 오류 500.0 - ANCM In-Process 처리기 로드 실패

• 애플리케이션 로그: 네이티브 종속성을 찾지 못한 채 처리기 처리기를 찾기 위해 hostfxr를 호출하지 못했습니다. inprocess 요청 처리기를 찾을 수 없습니다. hostfxr 호출에서 캡처된 출력: 호환되는 프레임워크 버전을 찾을 수 없습니다. 지정된 프레임워크 ‘Microsoft.AspNetCore.App’, 버전 ‘{VERSION}-preview-*’를 찾을 수 없습니다. ‘/LM/W3SVC/1416782824/ROOT’ 애플리케이션을 시작하지 못했습니다. 오류 코드 ‘0x8000ffff’.

• ASP.NET Core Module stdout 로그: 호환되는 프레임워크 버전을 찾을 수 없습니다. 지정된 프레임워크 ‘Microsoft.AspNetCore.App’, 버전 ‘{VERSION}-preview-*’를 찾을 수 없습니다.

• ASP.NET 핵심 모듈 디버그 로그: 네이티브 종속성을 찾지 못한 채 처리기 요청 처리기를 찾기 위해 hostfxr를 호출하지 못했습니다. 이는 앱이 잘못 구성되었음을 의미할 가능성이 높으며, 앱이 대상으로 하고 머신에 설치되어 있는 Microsoft.NetCore.App 및 Microsoft.AspNetCore.App 버전을 확인하세요. 실패한 HRESULT가 반환되었습니다. 0x8000ffff. inprocess 요청 처리기를 찾을 수 없습니다. 호환 가능한 프레임워크 버전을 찾을 수 없습니다. 지정된 프레임워크 ‘Microsoft.AspNetCore.App’, 버전 ‘{VERSION}-preview-*’를 찾을 수 없습니다.

문제 해결:

• 미리 보기 런타임에서 앱을 실행하는 경우 앱의 비트 수 및 앱의 런타임 버전과 일치하는 32비트(x86) 또는 64비트(x64) 사이트 확장을 설치합니다. 두 확장을 모두 설치하거나 확장의 여러 런타임 버전을 설치하지 않습니다.

  • ASP.NET Core {RUNTIME VERSION}(x86) 런타임
  • ASP.NET Core {RUNTIME VERSION}(x64) 런타임

  앱을 다시 시작합니다. 앱이 다시 시작될 때까지 몇 초간 기다립니다.

• 미리 보기 런타임에서 앱을 실행 중이며 32비트(x86) 및 64비트(x64) 사이트 확장이 둘 다 설치된 경우 앱의 비트 수와 일치하지 않는 사이트 확장을 제거합니다. 사이트 확장을 제거한 후 앱을 다시 시작합니다. 앱이 다시 시작될 때까지 몇 초간 기다립니다.

• 미리 보기 런타임에서 앱을 실행 중이며 사이트 확장의 비트 수가 앱의 비트 수와 일치하는 경우 미리 보기 사이트 확장의 ‘런타임 버전’이 앱의 런타임 버전과 일치하는지 확인합니다.

• 애플리케이션 설정에 있는 앱의 플랫폼이 앱의 비트 수와 일치하는지 확인합니다.

자세한 내용은 Azure App Service에 ASP.NET Core 앱 배포를 참조하세요.

x86 앱이 배포되었지만 32비트 앱에 대해 앱 풀이 활성화되어 있지 않습니다.

• 브라우저: HTTP 오류 500.30 - ANCM In-Process 시작 실패

• 애플리케이션 로그: 실제 루트 '{PATH}'가 있는 애플리케이션 '/LM/W3SVC/5/ROOT'가 예기치 않은 관리 예외, 예외 코드 = '0xe0434352'에 도달했습니다. 자세한 내용은 stderr 로그를 확인하세요. 실제 루트'{PATH}'가 있는 애플리케이션 '/LM/W3SVC/5/ROOT'에서 clr 및 관리되는 애플리케이션을 로드하지 못했습니다. CLR 작업자 스레드가 조기에 종료됨

• ASP.NET Core 모듈 stdout 로그: 로그 파일이 만들어지지만 비어 있습니다.

• ASP.NET 핵심 모듈 디버그 로그: 실패한 HRESULT 반환: 0x8007023e

이 시나리오는 자체 포함된 앱을 게시할 때 SDK에 의해 트래핑됩니다. RID가 플랫폼 대상과 일치하지 않으면 SDK에서 오류가 발생합니다(예: 프로젝트 파일에 <PlatformTarget>x86</PlatformTarget>이 있는 win10-x64 RID).

문제 해결:

x86 프레임워크 종속 배포(<PlatformTarget>x86</PlatformTarget>)의 경우 32비트 앱용 IIS 앱 풀을 사용하도록 설정합니다. IIS 관리자에서 앱 풀의 고급 설정을 열고 32비트 앱 사용을 True로 설정합니다.

플랫폼이 RID와 충돌함

• 브라우저: HTTP 오류 502.5 - 프로세스 오류

• 애플리케이션 로그: 실제 루트 'C:{PATH}가 있는 애플리케이션 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}'에서 '"C:{PATH}{ASSEMBLY}.{exe|dll}" ' 명령줄로 프로세스를 시작하지 못했습니다. 오류 코드 = '0x80004005 : ff.

• ASP.NET 핵심 모듈 stdout 로그: 처리되지 않은 예외: System.BadImageFormatException: 파일 또는 어셈블리 '{ASSEMBLY}.dll'를 로드할 수 없습니다. 프로그램을 잘못된 형식으로 로드하려고 했습니다.

문제 해결:

• 앱이 Kestrel에서 로컬로 실행되는지 확인합니다. 프로세스 오류는 앱 내의 문제 때문일 수 있습니다. 자세한 내용은 Azure App Service 및 IIS에서 ASP.NET Core 문제 해결을 참조하세요.

• Azure 앱 배포에서 앱을 업그레이드하고 새 어셈블리를 배포할 때 이 예외가 발생하면 이전 배포에서 모든 파일을 수동으로 삭제합니다. 호환되지 않는 어셈블리가 오랫동안 남아 있으면 업그레이드된 응용 프로그램을 배포할 때 System.BadImageFormatException 예외가 발생할 수 있습니다.

URI 엔드포인트가 잘못되었거나 중지된 웹 사이트

• 브라우저: ERR_CONNECTION_REFUSED --OR-- 연결할 수 없음

• 애플리케이션 로그: 항목 없음

• ASP.NET Core Module stdout 로그: 로그 파일이 만들어지지 않습니다.

• ASP.NET Core 모듈 디버그 로그: 로그 파일이 만들어지지 않습니다.

문제 해결:

• 사용 중인 앱에 대해 올바른 URI 엔드포인트를 확인합니다. 바인딩을 확인합니다.

• IIS 웹 사이트가 ‘중지됨’ 상태가 아닌지 확인합니다.

CoreWebEngine 또는 W3SVC 서버 기능이 사용되지 않음

OS 예외: ASP.NET Core 모듈을 사용하려면 IIS 7.0 CoreWebEngine 및 W3SVC 기능이 설치되어 있어야 합니다.

문제 해결:

적절한 역할 및 기능이 사용 가능한지 확인합니다. IIS 구성을 참조하세요.

잘못된 웹 사이트 실제 경로 또는 누락된 앱

• 브라우저: 403 사용할 수 없음 - 액세스가 거부되었습니다. - 또는 - 403.14 사용할 수 없음 - 웹 서버가 이 디렉터리의 내용을 표시하지 못하도록 구성되었습니다.

• 애플리케이션 로그: 항목 없음

• ASP.NET Core Module stdout 로그: 로그 파일이 만들어지지 않습니다.

• ASP.NET Core 모듈 디버그 로그: 로그 파일이 만들어지지 않습니다.

문제 해결:

IIS 웹 사이트 기본 설정과 실제 앱 폴더를 확인합니다. 앱이 IIS 웹 사이트 실제 경로의 폴더에 있는지 확인합니다.

잘못된 역할, 설치되지 않은 ASP.NET Core 모듈 또는 잘못된 권한

• 브라우저: 500.19 내부 서버 오류 - 요청된 페이지와 관련된 구성 데이터가 잘못되어 해당 페이지에 액세스할 수 없습니다. --또는-- 이 페이지를 표시할 수 없습니다

• 애플리케이션 로그: 항목 없음

• ASP.NET Core Module stdout 로그: 로그 파일이 만들어지지 않습니다.

• ASP.NET Core 모듈 디버그 로그: 로그 파일이 만들어지지 않습니다.

문제 해결:

• 적절한 역할을 사용할 수 있는지 확인합니다. IIS 구성을 참조하세요.

• 프로그램 및 기능 또는 앱 및 기능을 열고 Windows Server 호스팅이 설치되어 있는지 확인합니다. Windows Server 호스팅이 설치된 프로그램 목록에 없는 경우 .NET Core 호스팅 번들을 다운로드하여 설치합니다.

  현재 .NET Core 호스팅 번들 설치 관리자(직접 다운로드)

  자세한 내용은 .NET Core 호스팅 번들 설치를 참조하세요.

• 애플리케이션 풀>프로세스 모델>Identity가 ApplicationPoolIdentity로 설정되어 있는지 또는 사용자 지정 ID에 앱의 배포 폴더에 액세스할 수 있는 올바른 권한이 있는지를 확인합니다.

• ASP.NET Core 호스팅 번들을 제거하고 이전 버전의 호스팅 번들을 설치하는 경우 applicationHost.config 파일에는 ASP.NET Core 모듈에 대한 섹션이 포함되지 않습니다. %windir%/System32/inetsrv/config에서 applicationHost.config를 열고 <configuration><configSections><sectionGroup name="system.webServer"> 섹션 그룹을 찾습니다. ASP.NET Core 모듈에 대한 섹션이 섹션 그룹에서 누락된 경우 섹션 요소를 추가합니다.

  <section name="aspNetCore" overrideModeDefault="Allow" />
  

  또는 최신 버전의 ASP.NET Core 호스팅 번들을 설치합니다. 최신 버전은 지원되는 이전 버전의 ASP.NET Core 앱과 호환 가능합니다.

잘못된 processPath, 누락된 PATH 변수, 설치되지 않은 호스팅 번들, 다시 시작되지 않은 시스템/IIS, 설치되지 않은 VC++ 재배포 가능 패키지 또는 dotnet.exe 액세스 위반

• 브라우저: HTTP 오류 500.0 - ANCM In-Process 처리기 로드 실패

• 애플리케이션 로그: 실제 루트 'C:{PATH}'가 있는 애플리케이션 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}'에서 '"{...}" ' 명령줄로 프로세스를 시작하지 못했습니다. 오류 코드 = '0x80070002 : 0. 애플리케이션 '{PATH}'를 시작할 수 없습니다. '{PATH}'에서 실행 파일을 찾을 수 없습니다. 애플리케이션 '/LM/W3SVC/2/ROOT'를 시작하지 못했습니다. 오류 코드 '0x8007023e'.

• ASP.NET Core Module stdout 로그: 로그 파일이 만들어지지 않습니다.

• ASP.NET 핵심 모듈 디버그 로그: 이벤트 로그: '애플리케이션 '{PATH}'을(를) 시작할 수 없습니다. '{PATH}'에서 실행 파일을 찾을 수 없습니다. 실패한 HRESULT 반환: 0x8007023e

문제 해결:

• 앱이 Kestrel에서 로컬로 실행되는지 확인합니다. 프로세스 오류는 앱 내의 문제 때문일 수 있습니다. 자세한 내용은 Azure App Service 및 IIS에서 ASP.NET Core 문제 해결을 참조하세요.

• web.config의 <aspNetCore> 요소에서 processPath 특성을 확인하여 FDD(프레임워크 종속 배포)에 대한 dotnet인지 또는 SCD(자체 포함 배포)에 대한 .\{ASSEMBLY}.exe인지 확인합니다.

• FDD의 경우 dotnet.exe에서 PATH 설정을 통해 액세스하지 못할 수 있습니다. 시스템 PATH 설정에 C:\Program Files\dotnet\이 있는지 확인합니다.

• FDD의 경우 dotnet.exe에서 앱 풀의 사용자 ID에 액세스하지 못할 수 있습니다. 앱 풀 사용자 ID에 C:\Program Files\dotnet 디렉터리에 대한 액세스 권한이 있는지 확인합니다. C:\Program Files\dotnet 및 앱 디렉터리에 앱 풀 사용자 ID에 대해 구성된 거부 규칙이 없는지 확인합니다.

• IIS를 다시 시작하지 않은 상태로 FDD를 배포하고 .NET Core를 설치했을 수 있습니다. 서버를 다시 시작하거나 명령 프롬프트에서 net stop was /y에 이어 net start w3svc를 실행하여 IIS를 다시 시작합니다.

• 호스팅 시스템에 .NET Core 런타임을 설치하지 않고 FDD를 배포했을 수 있습니다. .NET Core 런타임이 설치되어 있지 않으면 시스템에서 .NET Core 호스팅 번들 설치 관리자를 실행합니다.

  현재 .NET Core 호스팅 번들 설치 관리자(직접 다운로드)

  자세한 내용은 .NET Core 호스팅 번들 설치를 참조하세요.

  특정 런타임이 필요한 경우 .NET 다운로드 페이지에서 런타임을 다운로드하여 시스템에 설치합니다. 설치를 완료하려면 시스템을 다시 시작하거나 명령 프롬프트에서 net stop was /y에 이어 net start w3svc를 실행하여 IIS를 다시 시작합니다.

<aspNetCore> 요소의 잘못된 인수

• 브라우저: HTTP 오류 500.0 - ANCM In-Process 처리기 로드 실패

• 애플리케이션 로그: 네이티브 종속성을 찾지 못한 채 처리기 처리기를 찾기 위해 hostfxr를 호출하지 못했습니다. 이는 앱이 잘못 구성되었음을 의미할 가능성이 높으며, 앱이 대상으로 하고 머신에 설치되어 있는 Microsoft.NetCore.App 및 Microsoft.AspNetCore.App 버전을 확인하세요. inprocess 요청 처리기를 찾을 수 없습니다. hostfxr 호출에서 캡처된 출력: dotnet SDK 명령을 실행하시겠습니까? 에서 dotnet SDK를 https://go.microsoft.com/fwlink/?LinkID=798306&설치하세요. clcid=0x409 애플리케이션 '/LM/W3SVC/3/ROOT', ErrorCode '0x8000ffff'을 시작하지 못했습니다.

• ASP.NET Core 모듈 stdout 로그: dotnet SDK 명령을 실행하시겠습니까? 에서 dotnet SDK를 https://go.microsoft.com/fwlink/?LinkID=798306&설치하세요. clcid=0x409

• ASP.NET 핵심 모듈 디버그 로그: 네이티브 종속성을 찾지 못한 채 처리기 요청 처리기를 찾기 위해 hostfxr를 호출하지 못했습니다. 이는 앱이 잘못 구성되었음을 의미할 가능성이 높으며, 앱이 대상으로 하고 머신에 설치되어 있는 Microsoft.NetCore.App 및 Microsoft.AspNetCore.App 버전을 확인하세요. 실패한 HRESULT가 반환되었습니다. 0x8000ffff 인프로세스 요청 처리기를 찾을 수 없습니다. hostfxr 호출에서 캡처된 출력: dotnet SDK 명령을 실행하시겠습니까? 에서 dotnet SDK를 https://go.microsoft.com/fwlink/?LinkID=798306&설치하세요. clcid=0x409 실패한 HRESULT가 반환되었습니다. 0x8000ffff

문제 해결:

• 앱이 Kestrel에서 로컬로 실행되는지 확인합니다. 프로세스 오류는 앱 내의 문제 때문일 수 있습니다. 자세한 내용은 Azure App Service 및 IIS에서 ASP.NET Core 문제 해결을 참조하세요.

• web.config의 <aspNetCore> 요소에서 인수 특성을 검사하여 (a) FDD(프레임워크 종속 배포)에 대한 .\{ASSEMBLY}.dll인지, 또는 (b) 없는 경우 빈 문자열(arguments="")이거나 SCD(자체 포함 배포)에 대한 앱의 인수(arguments="{ARGUMENT_1}, {ARGUMENT_2}, ... {ARGUMENT_X}") 목록인지 확인합니다.

.NET Core 공유 프레임워크 누락

• 브라우저: HTTP 오류 500.0 - ANCM In-Process 처리기 로드 실패

• 애플리케이션 로그: 네이티브 종속성을 찾지 못한 채 처리기 처리기를 찾기 위해 hostfxr를 호출하지 못했습니다. 이는 앱이 잘못 구성되었음을 의미할 가능성이 높으며, 앱이 대상으로 하고 머신에 설치되어 있는 Microsoft.NetCore.App 및 Microsoft.AspNetCore.App 버전을 확인하세요. inprocess 요청 처리기를 찾을 수 없습니다. hostfxr 호출에서 캡처된 출력: 호환되는 프레임워크 버전을 찾을 수 없습니다. 지정된 프레임워크 'Microsoft.AspNetCore.App', 버전 '{VERSION}'을 찾을 수 없습니다.

애플리케이션 '/LM/W3SVC/5/ROOT'를 시작하지 못했습니다. 오류 코드 '0x8000ffff'.

• ASP.NET Core Module stdout 로그: 호환되는 프레임워크 버전을 찾을 수 없습니다. 지정된 프레임워크 'Microsoft.AspNetCore.App', 버전 '{VERSION}'을 찾을 수 없습니다.

• ASP.NET 핵심 모듈 디버그 로그: 실패한 HRESULT 반환: 0x8000ffff

문제 해결:

FDD(프레임워크 종속 배포)의 경우 시스템에 올바른 런타임이 설치되어 있는지 확인합니다.

중지된 애플리케이션 풀

• 브라우저: 503 서비스를 사용할 수 없음

• 애플리케이션 로그: 항목 없음

• ASP.NET Core Module stdout 로그: 로그 파일이 만들어지지 않습니다.

• ASP.NET Core 모듈 디버그 로그: 로그 파일이 만들어지지 않습니다.

문제 해결:

애플리케이션 풀이 ‘중지됨’ 상태가 아닌지 확인합니다.

하위 애플리케이션에 <handlers> 섹션이 포함되어 있음

• 브라우저: HTTP 오류 500.19 - 내부 서버 오류

• 애플리케이션 로그: 항목 없음

• ASP.NET 핵심 모듈 stdout 로그: 루트 앱의 로그 파일이 만들어지고 정상적인 작업이 표시됩니다. 하위 앱의 로그 파일이 생성되지 않습니다.

• ASP.NET 핵심 모듈 디버그 로그: 루트 앱의 로그 파일이 만들어지고 정상적인 작업이 표시됩니다. 하위 앱의 로그 파일이 생성되지 않습니다.

문제 해결:

하위 앱의 web.config 파일에 <handlers> 섹션이 포함되어 있지 않거나 하위 앱이 부모 앱의 처리기를 상속하지 않았는지 확인합니다.

web.config의 부모 앱 <system.webServer> 섹션은 <location> 요소 내부에 배치되어 있습니다. InheritInChildApplications 속성이 false로 설정되어 <location> 요소 내에서 지정된 설정이 부모 앱의 하위 디렉터리에 있는 앱에 상속되지 않음을 나타냅니다. 자세한 내용은 IIS용 ANCM(ASP.NET Core 모듈)을 참조하세요.

stdout 로그 경로가 올바르지 않음

• 브라우저: 앱이 정상적으로 응답합니다.

• 애플리케이션 로그: C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll stdout 리디렉션을 시작할 수 없습니다. 예외 메시지: HRESULT 0x80070005 {PATH}\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp:84에 반환됩니다. C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll에서 stdout 리디렉션을 중지하지 못했습니다. 예외 메시지: HRESULT 0x80070002 {PATH}에서 반환됩니다. {PATH}\aspnetcorev2_inprocess.dll에서 stdout 리디렉션을 시작할 수 없습니다.

• ASP.NET Core Module stdout 로그: 로그 파일이 만들어지지 않습니다.

• ASP.NET Core 모듈 디버그 로그: C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll stdout 리디렉션을 시작할 수 없습니다. 예외 메시지: HRESULT 0x80070005 {PATH}\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp:84에 반환됩니다. C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll에서 stdout 리디렉션을 중지하지 못했습니다. 예외 메시지: HRESULT 0x80070002 {PATH}에서 반환됩니다. {PATH}\aspnetcorev2_inprocess.dll에서 stdout 리디렉션을 시작할 수 없습니다.

문제 해결:

• web.config의 <aspNetCore> 요소에 지정된 stdoutLogFile 경로가 없습니다. 자세한 내용은 ASP.NET 핵심 모듈: 로그 만들기 및 리디렉션을 참조 하세요.

• 앱 풀 사용자는 stdout 로그 경로에 대한 쓰기 액세스 권한이 없습니다.

일반적인 애플리케이션 구성 문제

• 브라우저: HTTP 오류 500.0 - ANCM In-Process 처리기 로드 오류 --OR-- HTTP 오류 500.30 - ANCM In-Process 시작 실패

• 애플리케이션 로그: 변수

• ASP.NET Core Module stdout 로그: 로그 파일이 만들어지지만 비어 있거나 앱 지점이 실패할 때까지 일반 항목으로 생성됩니다.

• ASP.NET 핵심 모듈 디버그 로그: 변수

문제 해결:

앱 구성 또는 프로그래밍 문제로 인해 프로세스를 시작하지 못했습니다.

자세한 내용은 아래 항목을 참조하세요.

• Azure App Service 및 IIS에서 ASP.NET Core 문제 해결
• 핵심 프로젝트 ASP.NET 문제 해결 및 디버그

추가 리소스

• Visual Studio에서 .NET 및 ASP.NET Core 소스 코드 디버그
• 핵심 프로젝트 ASP.NET 문제 해결 및 디버그
• ASP.NET Core에서 오류 처리
• IIS용 ANCM(ASP.NET Core 모듈)

Azure 설명서

• ASP.NET Core용 Application Insights
• Visual Studio를 사용하여 Azure App Service에서 웹앱 문제 해결의 원격 디버깅 웹앱 섹션
• Azure App Service 진단 개요
• 방법: Azure App Service에서 앱 모니터링
• Visual Studio를 사용하여 Azure App Service의 웹앱 문제 해결
• Azure 웹앱에서 “502 잘못된 게이트웨이” 및 “503 서비스를 사용할 수 없음”의 HTTP 오류 문제 해결
• Azure App Service에서 느린 웹앱 성능 문제 해결
• Azure의 웹앱에 대한 애플리케이션 성능 FAQ
• Azure Web App sandbox (App Service runtime execution limitations)(Azure 웹앱 샌드박스(App Service 런타임 실행 제한))

Visual Studio 설명서

• Visual Studio 2017의 Azure에서 IIS의 원격 디버그 ASP.NET Core
• Visual Studio 2017의 원격 IIS 컴퓨터에서 원격 디버그 ASP.NET Core
• Visual Studio를 사용하여 디버깅하는 자세한 내용

Visual Studio Code 설명서

• Debugging with Visual Studio Code(Visual Studio Code를 사용한 디버깅)