Windows D3D12 GPU 크래시 문제 해결
Windows 개발 시 D3D12 GPU 크래시를 식별하고 수정합니다.
읽는 시간 7분최근 업데이트: 9일 전
GPU 크래시로 인해 Unity 에디터가 예기치 않게 닫히고 그래픽스 오류(예: )를 반환할 수 있습니다. 이러한 크래시를 진단하기 어려운 경우가 많습니다. 원인은 프로젝트의 코드에 있지 않기 때문입니다. 이 페이지에서는 GPU 크래시 소스를 식별하는 방법과 GPU 크래시 문제를 해결하는 일련의 단계를 제공합니다.
Unrecoverable D3D12 device error! Run with -force-d3d12-debug and see logs for more info크래시 타입
Unity 개발할 때 GPU 크래시라고 부르는 다음과 같은 오류가 발생할 수 있습니다.
-
GPU timeout: 그래픽스 커맨드를 실행하는 데 시간이 너무 오래 걸리면 Windows 작업을 시간 초과하고 그래픽스 드라이버를 재설정하여 크래시를 일으킵니다. 예제는 아래와 같습니다.
- 예기치 않은 데이터 또는 초기화되지 않은 데이터로 인해 발생하는 셰이더 무한 루프입니다.
- 컴퓨트 셰이더 코드의 동기화 프리미티브(예: 컴퓨트 스레드가 호출을 누락했을 때의 )
GroupMemoryBarrierWithGroupSync
-
GPU 페이지 오류: 그래픽스 커맨드가 더 이상 사용할 수 없는 GPU 메모리에 액세스하려고 할 때 발생합니다(예: GPU가 사용을 완료하기 전에 해제된 버퍼). 이 작업으로 인해 크래시가 발생합니다.
-
그래픽 드라이버 크래시: Unity 셰이더 컴파일 및 리소스 할당과 같은 작업을 처리하기 위해 호출하는 타사 동적 링크 라이브러리(.dll 파일)에 오류가 발생합니다.
-
GPU 크래시: HDR(전용 비디오 메모리)가 부족한 GPU로 인해 발생하는 하드웨어 레벨 오류입니다.
드라이버 스택 이해
Unity GPU와 직접 통신하지 않습니다. 대신 프로젝트와 하드웨어 간의 레이어드 드라이버 스택에 의존합니다. 이 스택에는 다수의 동적 링크 라이브러리(DLL)가 들어 있습니다. 각 라이브러리는 셰이더 컴파일, 리소스 관리, 명령 변환과 같은 작업을 처리하는 렌더링 파이프라인의 다리 역할을 합니다.
이러한 DLL 중 하나에서 문제가 발생하면 영향이 심각할 수 있습니다. 시스템 레벨에서 작동하므로 기존의 디버깅 메서드는 종종 부적절합니다. 드라이버 기호 서버에서는 여전히 중요한 인사이트를 얻을 수 있지만, 자체 코드로 하는 것처럼 드라이버 코드를 살펴볼 수는 없습니다.
따라서 그래픽스 드라이버 아키텍처를 이해하는 것이 중요합니다. 플로는 다음과 같습니다.
- 크래시 로그에 있는 DLL은 거의 항상 UMD(사용자 모드 드라이버)입니다. 애플리케이션의 프로세스 공간에서 실행되고 셰이더 컴파일, 커맨드 버퍼 생성 및 리소스 관리를 처리합니다. 크래시가 발생하면 애플리케이션에 크래시가 발생하므로 Unity 갑자기 종료됩니다.
- 커널 모드 드라이버(KMD)는 더 낮은 수준에서 작동하며 모든 애플리케이션에서 하드웨어 액세스를 관리합니다. KMD 크래시는 더 심각하며 파란색 화면이 발생할 수 있지만, 최신 Windows 드라이버를 재시작하여 복구할 수 있습니다.
사용자 모드 드라이버는 셰이더 컴파일, GPU 메모리 및 리소스를 관리하고, 종종 애플리케이션의 버그를 해결하기 때문에 복잡합니다.
크래시는 일반적으로 드라이버가 다음과 같은 예기치 않은 상황에 직면할 때 발생합니다.
- 컴파일러 버그를 트리거하는 비정상적인 패턴이 포함된 셰이더.
- 애플리케이션에서 API 호출이 테스트되지 않은 시퀀스입니다.
- 드라이버의 자체 셰이더 캐시가 손상되었습니다.
- 특정 조건에서만 나타나는 하드웨어 관련 버그입니다.
시스템 레벨 문제 제외
드라이버 문제를 직접 해결하기 전에 다른 시스템 레벨 문제를 제외해야 합니다.
다음 확인을 수행합니다.
- 오버레이 비활성화: Discord, Steam, MSI Afterburner와 같은 오버레이를 표시하는 애플리케이션은 Unity 렌더링 프로세스를 방해할 수 있습니다. 에디터를 실행하기 전에 이 소프트웨어를 비활성화하거나 닫습니다.
- GPU를 기본 상태로 초기화합니다. GPU를 오버클러킹하면 기본 출하 시점 속도로 되돌립니다. 또한 GPU의 제어판을 열고 모든 설정을 기본값으로 복원합니다. 일부 노트북의 경우 기본 설정을 복원하면 특히 노트북이 전원에 연결되어 있지 않거나 배터리가 부족한 경우 시스템이 전용 GPU 대신 통합 GPU를 사용하게 됩니다. 통합된 GPU는 일반적으로 처리 성능이 적고 호환성 문제가 많을 수 있으므로 전용 GPU에서 실행되도록 Unity 에디터 플레이어를 구성해야 합니다.
- 운영체제 업데이트 확인: 운영체제가 완전히 최신 상태인지 확인합니다. Microsoft는 DirectX와 같은 핵심 컴포넌트의 안정성 문제를 해결할 수 있는 패치를 자주 출시합니다.
- 그래픽스 드라이버 업데이트: 오래된 드라이버는 일반적으로 크래시와 렌더링 문제를 일으킵니다. NVIDIA GeForce Experience 또는 AMD 소프트웨어와 같은 도구를 사용하여 드라이버를 최신 버전으로 업데이트하는 것이 좋습니다. 아드레날린 에디션
- 시스템 파일 검색 실행: 손상된 Windows 파일을 확인하고 복구하려면 관리자로 명령 프롬프트를 열고 를 실행한 다음
sfc /scannow를 실행합니다.DISM /Online /Cleanup-Image /RestoreHealth
크래시 유형을 파악합니다.
일반적으로 크래시는 그래픽스 드라이버 문제 또는 GPU 하드웨어 문제입니다.
원인을 찾으려면 크래시 로그를 검사해야 합니다. 컴퓨터의 크래시 리포트 위치는 로그 파일 레퍼런스를 참조하십시오.
증상을 관찰하고 에디터 로그를 분석합니다.
GPU 관련 오류의 일반적인 증상은 다음과 같습니다.
- 크래시 이전의 높은 GPU 로드입니다.
- 에디터에서 글리치 또는 고정이 보입니다.
- 갑자기 에디터가 종료됩니다.
- Windows 디스플레이 드라이버 재설정.
Unity가 크래시를 인식하면 파일 끝에 있는 스택 추적을 확인할 수 있습니다. 그래픽스 관련 오류는 일반적으로 Unity 렌더링 스레드와 그래픽스 API 관련된 특정 스택 추적을 나타냅니다. 다음 키 마커를 찾습니다.
Editor.log- 렌더링 스레드 실패: 스택 추적에는 가 포함됩니다. 이는 일반 게임 로직이 아닌 GPU에 명령을 전달하는 동안 엔진이 실패했음을 나타냅니다.
GfxDeviceWorker::RunGfxDeviceWorker - 그래픽스 API 호출: 스택 추적은 그래픽스 API 레이어(예: )를 언급합니다.
D3D12Fence::Wait - 기기 오류 코드: 로그에는 또는
Device failed error (887a0006)와 같은 오류가 포함되어 있습니다.Device removal - GPU 메모리 상태: 로그는 메모리 상태를 나타낼 수 있습니다(예: ).
d3d12: GfxDevice was not out of Local memory
호출 스택은 다음 예제와 같습니다.
========== 출력 스택 추적 ==================0x00007FFF7F3580DA(KERNELBASE) RaiseException0x00007FFDF037F596(Unity) LaunchBugReporter0x00007FFDF0BC03A7(Unity) EditorMonoConsole::LogToConsole구현0x00007FFDF0BC0EE3(Unity) EditorMonoConsole::LogToConsole구현0x00007FFDF2AA2ED8 (Unity) DebugStringToFilePostprocessedStacktrace0x00007FFDF2AA26E1 (Unity) DebugStringToFile0x00007FFDF21608F5(Unity) CheckDeviceStatus0x00007FFDF21CB7A2(Unity) CheckCompletedValue0x00007FFDF21D1E70(Unity) D3D12Fence::Wait0x00007FFDF2195721 (Unity) GfxDeviceD3D12::QueuePresent0x00007FFDF21C20DE(Unity) D3D12창::엔드 렌더링0x00007FFDF1D077CD (Unity) GfxDeviceWorker::RunCommand0x00007FFDF1D09FCC (Unity) GfxDeviceWorker::RunExt0x00007FFDF1D0A0FF (Unity) GfxDeviceWorker::RunGfxDeviceWorker0x00007FFDF2AC12FC(Unity) 스레드::RunThreadWrapper0x00007FFF80CBE8D7 (KERNEL32) BaseThreadInitThunk0x00007FFF81F2C53C (ntdll) RtlUserThreadStart========== STACKTRACE 종료 ===========
또한 로그는 GPU가 사망 상태로 전환된 정확한 스크립트나 에셋을 가리킬 수 있습니다. 예를 들어 로그에서 에 대한 레퍼런스는 특정 스크립트와 행 번호로 추적될 수 있습니다.
CreateResourcesCreateResources...GPUCrash:CreateResources ()(Assets/GPUCrash.cs:25)GPUCrash:Update ()(Assets/GPUCrash.cs:47)
상세한 크래시 로그
자세한 로그를 보려면 다음 선행 조건을 확인하십시오.
-
Windows 11이 설치되어 있어야 합니다.
-
다음 인자로 에디터를 시작합니다.
-force-d3d12-debug-force-d3d12-editor-pix-events
이러한 인수를 사용하면 크래시 시점의 GPU 상태에 대한 더 많은 인사이트를 제공하는 Microsoft의 디바이스 제거 확장 데이터(DRED) API가 활성화됩니다.
로그에는 다음 포맷의 오류가 표시됩니다.
- 확인 오류
- DXGI 오류:
d3d12 DXGI error: <message>
DLL 레퍼런스
대부분의 크래시의 경우 크래시 로그에 있는 .dll 파일의 이름이 소스를 식별하는 키입니다. 대부분은 DirectX와 같은 그래픽스 API의 커맨드를 GPU가 이해할 수 있는 명령으로 변환하는 UMD(사용자 모드 드라이버)에서 발생합니다.
DLL 파일 | Manufacturer | Type | Description |
|---|---|---|---|
| AMD | UMD | DirectX, OpenGL 또는 Vulkan 그래픽스 API 사용 중인지 여부를 감지합니다. |
| AMD | UMD | DirectX API 호출, 셰이더 및 리소스를 GPU 전용 구조로 변환합니다. |
| Intel | UMD | HLSL 또는 GLSL Intel GPU 아키텍처에 최적화된 기계어 코드 컴파일합니다. 여기서 크래시는 종종 셰이더 컴파일 문제를 나타냅니다. 예를 들어 예기치 않은 방식으로 기능을 사용하거나 컴파일러 버그가 발생하는 셰이더 의해 발생할 수 있습니다. |
| Intel | UMD | DirectX API 호출, 셰이더 및 리소스를 이전 Intel GPU(예: 11세대 이전 Intel HD/UHD 그래픽)의 GPU 전용 구조로 변환합니다. |
| Intel | UMD | DirectX API 호출, 셰이더 및 리소스를 최신 Xe 아키텍처(Arc GPU를 포함한 11세대 Core 이상)를 위한 GPU 전용 구조로 변환합니다. |
| NVIDIA | UMD | DirectX API 호출, 셰이더 및 리소스를 GPU 전용 구조로 변환합니다. |
| NVIDIA | UMD | DirectX 대신 OpenGL을 대상으로 하는 경우 OpenGL API 호출을 변환하고 GLSL 셰이더를 컴파일하고 전체 OpenGL 렌더링 파이프라인을 관리합니다. |
그래픽스 드라이버 크래시 문제 해결
드라이버를 식별한 후 다음 단계에 따라 문제를 해결합니다.
1. 클린 드라이버 설치 수행
드라이버를 업데이트해도 크래시를 해결하는 데는 항상 충분하지 않습니다. 새 버전을 설치하기 전에 클린 설치 시 모든 예전 파일과 손상될 수 있는 파일이 제거됩니다.
-
AMD:
- 공식 AMD 클린업 유틸리티 또는 디스플레이 드라이버 제거기(DDU)와 같은 타사 도구를 사용하여 모든 기존 드라이버 파일을 완전히 제거하십시오.
- 공식 AMD 웹사이트에서 최신 안정적인 드라이버를 다운로드하여 설치합니다. 업데이트 후에 크래시가 시작되면 이전에 안정적인 버전으로 롤백하는 것이 좋습니다.
-
NVIDIA:
- NVIDIA 웹 사이트에서 최신 Game Ready 또는 Studio 드라이버를 다운로드하십시오.
- 설치 프로그램을 실행하고 **Custom (고급)**을 선택합니다.
- 다음 화면에서 클린 설치 수행 상자를 선택하고 진행합니다. 지속적인 문제의 경우 다시 설치하기 전에 DDU를 사용하십시오.
-
Intel
- DDU 같은 정리 툴을 사용하여 기존 드라이버 파일을 모두 제거합니다.
- 공식 Intel 다운로드 센터 또는 컴퓨터 제조사 웹사이트에서 최신 그래픽스 드라이버를 다운로드하여 설치합니다.
크래시가 지속되면 이전 버전의 드라이버를 설치해 보십시오.
2. 셰이더 캐시 지우기
Unity 그래픽스 드라이버에서 유지하는 셰이더 캐시가 손상되면 반복적인 컴파일 크래시가 발생할 수 있습니다. 캐시를 완전히 지우려면 다음 폴더의 콘텐츠를 삭제합니다.
캐시의 유형 | 위치 | 설명 |
|---|---|---|
| Unity의 셰이더 캐시 | | 이 폴더의 콘텐츠를 삭제하여 Unity 에디터 프로젝트 라이브러리 셰이더 캐시를 지웁니다. |
| 드라이버 셰이더 캐시 | | 이 폴더의 콘텐츠를 삭제하여 빌드된 플레이어의 드라이버 셰이더 캐시를 지웁니다. |
캐시를 지우고 나면 캐시된 셰이더가 메모리에 남지 않도록 컴퓨터를 다시 시작합니다.
Unity 크래시 신고
이 문서에서 해결 방법을 시도했지만 크래시가 계속 발생하면 버그 리포트를 제출할 수 있습니다. 리포트를 제출할 때 최대한 세부 정보를 포함하고 문제를 재현하는 단계를 나열하십시오.
버그 신고에 대한 자세한 내용은 버그 신고 방법을 참조하십시오.