Unity Hub 실행 안됨 해결: 빈 화면·무한 로딩 원인 점검부터 로그(info-log.json)·캐시 초기화까지

최종 업데이트: 2025년 9월 20일 · Unity Hub가 실행되지 않거나 무응답, 빈 화면, 로그인 무한로딩 문제를 점검부터 초기화까지 단계별로 해결하는 가이드

빠른 해결 요약

1. 중복 실행 및 잔존 프로세스 종료 — 작업 관리자나 활동 모니터에서 Unity Hub 관련 프로세스를 모두 종료
2. 네트워크·버전·로그인 재확인 — 인터넷 연결 상태 점검, Hub 최신 버전 업데이트, 계정 로그아웃 후 재로그인
3. 로그 파일 확인 — Unity Hub 로그 파일에서 에러 원인 파악
4. Hub 데이터 초기화 — 사용자 폴더의 Unity Hub 캐시 및 설정 파일 정리
5. 완전 재설치 — 문제가 지속되면 Hub 제거 후 공식 페이지에서 최신 버전으로 재설치

목차

• 주요 증상
• 사전 점검사항
• 해결 방법
  • 프로세스 종료
  • 네트워크·업데이트·로그인 재확인
  • 로그 파일 확인
  • Hub 데이터 초기화
  • 완전 재설치
• 이미지 가이드
• 자주 묻는 질문
• 참고 자료

Unity Hub 주요 증상

• 더블클릭해도 아무 반응이 없거나 잠깐 로딩 후 사라짐
• 검은 화면이나 빈 화면(Blank Screen)만 표시됨
• 로그인 화면에서 무한 로딩이 계속됨
• Hub가 실행되다가 갑자기 종료됨

사전 점검사항 (10초 체크)

• 운영체제와 그래픽 드라이버가 최신 버전인지 확인
• 회사 네트워크나 VPN, 프록시, 보안 프로그램이 Unity Hub를 차단하지 않는지 확인
• 최근 Hub 업데이트 후 문제가 발생했다면 재로그인 및 업데이트 상태 재확인

해결 방법

1. 프로세스 종료 (중복 실행 방지)

Unity Hub가 백그라운드에서 실행 중이거나 잔존 프로세스가 남아있을 수 있습니다.

Windows:
Ctrl+Shift+Esc → 작업 관리자 실행 → 프로세스 탭에서 Unity Hub, Unity 관련 항목 모두 종료

macOS:
Cmd+Space → Spotlight 실행 → "활동 모니터" 검색 → Unity Hub 검색 후 모든 관련 프로세스 강제 종료

2. 네트워크·업데이트·로그인 재확인

• 네트워크 연결: 다른 웹사이트 접속으로 인터넷 안정성 확인, 회사망·프록시 사용 시 Unity 관련 도메인 예외 처리
• Hub 업데이트: Unity Hub 메뉴에서 업데이트 확인 후 재시작. 공식 설치 가이드 참고
• 계정 재로그인: Unity Hub에서 로그아웃 후 다시 로그인

3. 로그 파일 확인

Unity 공식 문서에 명시된 Hub 로그 경로를 통해 에러 원인을 파악할 수 있습니다:

• Windows: %UserProfile%\AppData\Roaming\UnityHub\logs\info-log.json
• macOS: ~/Library/Application Support/UnityHub/logs/info-log.json

해당 파일을 메모장이나 텍스트 에디터로 열어 network, license, update, permission 등의 키워드를 확인하세요.

이미지 가이드

Windows · Unity Hub 로그 폴더 (경로: %UserProfile%\AppData\Roaming\UnityHub\logs)

4. Hub 데이터 초기화

Windows 초기화 방법

1. Win+R → %UserProfile%\AppData\Roaming 입력 후 엔터
2. UnityHub 폴더를 찾아 UnityHub.bak으로 이름 변경
3. %LocalAppData% 경로의 UnityHub 폴더도 동일하게 처리

macOS 초기화 방법

1. Finder → "이동" → "폴더로 이동"
2. ~/Library/Application Support 입력 후 이동
3. UnityHub 폴더를 UnityHub.bak으로 이름 변경

주의: 삭제하지 말고 이름만 변경하세요. 필요 시 원래 이름으로 복구할 수 있습니다.

5. 완전 재설치

1. 제거: 운영체제의 표준 절차로 Unity Hub 완전 제거
2. 재부팅: 시스템 재시작으로 잔존 파일 정리
3. 재설치: Unity 공식 페이지에서 최신 Hub 다운로드

자주 묻는 질문

Q1. Hub가 아예 실행되지 않을 때 가장 먼저 확인해야 할 것은?

작업 관리자/활동 모니터로 잔존 프로세스를 모두 종료하고, 인터넷 연결 및 Hub 최신 버전을 확인하세요. 이후 로그 파일(info-log.json)을 열어 에러 내용을 확인하세요.

Q2. 캐시와 설정을 초기화해도 안전한가요?

안전합니다. 로그인 정보·환경설정만 재설정되고 프로젝트에는 영향이 없습니다. 초기화 전 .bak으로 이름 변경해두면 복구 가능합니다.

Q3. Editor 문제가 아닌데도 패키지 캐시를 정리해야 하나요?

대부분 Hub 데이터·네트워크 문제입니다. 다만 Editor 패키지 캐시(UPM) 손상 시 프로젝트 실행에 영향을 줄 수 있으므로 에러가 반복되면 점검하세요.

Q4. 회사 네트워크에서 문제가 잦을 때는?

회사 방화벽/프록시가 Unity 서버를 차단할 수 있습니다. IT 부서에 unity.com, unity3d.com 도메인 예외 처리를 요청하거나 개인 핫스팟으로 테스트해보세요.

참고 자료 (공식 문서)

1. Unity Hub 로그 위치 — Help | Unity Hub
2. Unity Hub 실행 문제 해결 — Unity Support: I cannot open the Unity Hub

마무리

Unity Hub 실행 문제는 주로 프로세스 충돌, 네트워크 문제, 캐시 손상으로 발생합니다. 위 방법들을 순서대로 시도하면 대부분의 케이스에서 해결됩니다. 지속될 경우 로그 파일을 첨부해 Unity 공식 지원팀에 문의하세요.