500 errors in ASP.NET Core

증상

IIS에서 실행되는 ASP.NET Core 애플리케이션에 500 오류가 발생합니다.

확인 및 조사

1. Event Viewer를 열고 Windows Logs에서 Application을 선택합니다.

2. 실패한 애플리케이션과 연결된 오류를 찾습니다. 원문은 오류의 Source 값으로 IIS AspNetCore Module 또는 IIS Express AspNetCore Module을 확인하도록 안내합니다.

3. 인터넷에 노출되지 않은 스테이징 또는 테스트 서버에서만 web.config의 <aspNetCore> 요소에 다음 환경 변수를 추가합니다.

   ASPNETCORE_ENVIRONMENT=Development

4. 애플리케이션 시작 코드가 호스트 빌더의 UseEnvironment 메서드로 환경 설정을 재정의하지 않는 경우, 애플리케이션 실행 시 Developer Exception Page가 표시되는지 확인합니다.

5. 조사 후 web.config에서 추가한 환경 변수를 제거합니다.

주의사항

• 이 환경 변수 설정은 인터넷에 노출되지 않은 스테이징 및 테스트 서버에서만 사용합니다.
• 변경 전 현재 web.config 값과 변경 대상을 기록합니다.
• 가능한 경우 변경 전 web.config를 백업하거나 내보냅니다.
• 한 번에 한 항목만 변경합니다.
• 장애 또는 오류가 발생하면 기록한 이전 값으로 복구합니다.
• 문제 해결 후 web.config에서 해당 환경 변수를 제거합니다.