VirtualBox를 실행할 때 '문서가 비어 있습니다(Document is empty)'라는 치명적인 오류로 인해 프로그램이 시작되지 않는다면, VirtualBox의 기본 설정 파일이 손상되었을 가능성이 높습니다. 이 경우 아래의 해결 방법을 순서대로 따라 하면 문제를 쉽게 해결할 수 있습니다.
오류 상세 내용
VirtualBox Manager가 시작되지 않고 다음과 같은 오류 메시지가 표시됩니다:
Failed to acquire the VirtualBox COM object.
The application will now terminate
Document is Empty
Location: 'C:\Users\user\.VirtualBox\VirtualBox.xml', line 1 (0), column 1.
F:\tinderbox\win-6.1\src\VBox\Main\src-server\VirtualBoxImpl.cpp[740] (long __cdecl VirtualBox::init(void)).
Result Code: E_FAIL (0x80004005)
Component: VirtualBoxWrap
Interface: IVirtualBox {d0a0163f-e254-4e5b-a1f2-011cf991c38d}
Callee: IVirtualBoxClient {d2937a8e-cb8d-4382-90ba-b7da78a74573}
이 오류는 주로 시스템 강제 종료, 디스크 오류 또는 프로그램 충돌로 인해 VirtualBox.xml 파일의 내용이 손실되거나 비워졌을 때 발생합니다. 다행히도 VirtualBox는 자동 백업 파일(VirtualBox.xml-prev)을 생성해 두기 때문에 대부분 간단하게 복구할 수 있습니다.
방법 1. 백업 파일에서 VirtualBox.xml 복원하기
가장 먼저 시도해야 할 방법은 자동 백업 파일을 활용하여 손상된 설정 파일을 복원하는 것입니다.
1. 작업 관리자(Task Manager)를 열고 VirtualBox 관련 프로세스가 모두 종료되어 있는지 확인합니다. (또는 PC를 재시작하세요)
2. 파일 탐색기를 열고 오류 메시지에 표시된 경로로 이동합니다:
- C:\Users\user\.VirtualBox\
3. VirtualBox.xml 파일을 찾아 이름을 VirtualBox.OLD로 변경합니다.
4. 그다음 VirtualBox.xml-prev 파일(자동 백업본)의 이름을 VirtualBox.xml로 변경합니다.
5. 이제 VirtualBox를 다시 실행해 봅니다. 정상적으로 작동한다면 문제가 해결된 것입니다. 만약 여전히 오류가 발생한다면 아래의 방법 2를 진행하세요.
방법 2. VirtualBox.xml 삭제 후 가상 머신 다시 등록하기
백업 파일마저 손상되었거나 방법 1로 해결되지 않은 경우, 설정 파일을 초기화하고 가상 머신(VM) 목록을 수동으로 다시 등록하는 방법입니다.
1. 작업 관리자를 열고 VirtualBox 프로세스가 실행 중이지 않은지 확인합니다. (필요시 PC 재시작)
2. 파일 탐색기를 통해 다음 경로로 이동합니다:
- C:\Users\user\.VirtualBox\
3. VirtualBox.xml 파일의 이름을 VirtualBox.OLD로 변경하고, VirtualBox.xml-prev 파일도 VirtualBox.xml-prev.OLD로 변경합니다.
4. VirtualBox를 실행합니다. 이제 오류 없이 프로그램이 열리지만, 가상 머신 목록은 비어 있을 것입니다. 아래 단계에 따라 VM을 다시 추가합니다:
a. VirtualBox Manager에서 [추가(Add)] 버튼을 클릭합니다.
b. 가상 머신 파일이 저장된 디스크 위치로 이동합니다. 예:
- C:\Users\user\VirtualBox VMs
c. 해당 폴더 안에서 .vbox 확장자 파일을 선택하고 [열기(Open)]를 클릭합니다.
d. 나머지 가상 머신도 동일한 방법으로 하나씩 추가하면 완료됩니다! *
* 참고: 모든 것이 정상적으로 작동하는 것을 확인한 후에는 VirtualBox.OLD 및 VirtualBox.xml-prev.OLD 파일을 삭제해도 됩니다.
마무리
이상으로 VirtualBox '문서가 비어 있습니다' 오류를 해결하는 두 가지 방법을 알아보았습니다. 어떤 방법이 효과적이었나요? 이 가이드가 도움이 되었다면 아래 댓글로 경험을 공유해 주세요. 더 많은 분들이 도움받을 수 있도록 좋아요와 공유 부탁드립니다!