25. Troubleshooting

Asset 핸들이 해제되지 않음

Asset.ActiveHandleCount가 계속 증가하면 Release/ReleaseAll 호출 누락입니다. 08_AssetSystem 참고.

씬 전환 중 예외가 발생

OperationCanceledException은 정상 흐름입니다. catch 후 반드시 재전파해야 합니다. 09_SceneSystem, MCP_Rules.md #3 참고.

저장이 실패하는데 예외가 안 남

SaveSystem은 예외 대신 Result<T>를 반환합니다. IsSuccess를 확인하세요. Save.FailCount Diagnostics 카운터도 확인하세요.

카메라가 흔들리다 멈춤

FinalSolver 이외 단계에서 camera.transform을 직접 수정하는 코드가 있는지 확인하세요. 13_CameraSystem 참고.

Diagnostics 카운터가 사라지지 않음

Dispose()에서 DiagnosticsCounters.Unregister()를 호출하지 않았을 가능성이 큽니다.

Release 빌드에서 컴파일 에러

FRAMEWORK_MULTIPLAYER 등 심볼 없이 관련 API를 호출하면 컴파일에서 제거된 코드를 참조하게 됩니다. 심볼 설정을 확인하세요.

이전 문서 / 다음 문서

이전: 24_FAQ.md 다음: 26_First_Game_Tutorial.md