Comment réparer un document VirtualBox vide

Si VirtualBox refuse de démarrer et affiche une erreur critique « Document vide », il est probable que le fichier de configuration principal, VirtualBox.xml, soit corrompu. Ce fichier stocke les paramètres de votre machine virtuelle ; lorsqu’il est endommagé, VirtualBox se comporte comme s’il ne trouvait pas votre configuration, d’où les messages d’erreur. Cela peut se produire après un plantage, un arrêt brutal ou même un simple dysfonctionnement. Heureusement, il existe plusieurs solutions pour résoudre ce problème sans tout réinstaller, mais il faut parfois procéder par essais et erreurs.

Voici ce qui se passe généralement : VirtualBox tente de lire le fichier VirtualBox.xml et constate qu’il est manquant, vide ou corrompu, ce qui provoque une erreur. La solution consiste généralement à restaurer ce fichier à partir d’une sauvegarde ou à le recréer en ajoutant à nouveau les machines virtuelles. L’objectif est de remettre VirtualBox en marche, avec votre liste de machines virtuelles intacte ou au moins reconstruite sans perte de données.

Solution : Impossible d’acquérir l’objet COM VirtualBox – Le document est vide dans le Gestionnaire VirtualBox

Méthode 1. Restaurer le fichier VirtualBox.xml à partir d’une sauvegarde

Pourquoi c’est utile : Si vous avez déjà sauvegardé votre fichier VirtualBox.xml, sa restauration permet de retrouver la configuration de votre machine virtuelle à l’identique, sans avoir à tout reconfigurer. Cette méthode s’applique si votre fichier de configuration fonctionnait correctement et qu’il est devenu vide ou corrompu.

Quand essayer : Après un plantage ou si le fichier VirtualBox.xml semble anormalement vide ou en grande partie invalide. Vous trouverez ce fichier à l’emplacement suivant :

C:\Utilisateurs\votre_nom_d’utilisateur\.VirtualBox\

À quoi s’attendre : VirtualBox devrait démarrer normalement et la liste de vos machines virtuelles devrait réapparaître. Si ce n’est pas le cas, passez à la méthode 2.

Mesures:

Ouvrez le Gestionnaire des tâches ( Ctrl + Shift + Esc) et vérifiez si des processus VirtualBox sont en cours d’exécution. Si c’est le cas, terminez-les ou redémarrez simplement l’ordinateur pour supprimer tout fichier résiduel.
Dans l’Explorateur de fichiers, accédez à C:\Utilisateurs\votre_nom_d’utilisateur\.VirtualBox\.
Trouvez VirtualBox.xml et renommez-le en VirtualBox. OLD.
Si vous disposez d’une sauvegarde, copiez le fichier VirtualBox.xml-prev depuis le même dossier et renommez-le en VirtualBox.xml.
Essayez de relancer VirtualBox. Il devrait se charger avec votre liste de machines virtuelles restaurée.

Remarque : Si tout fonctionne correctement, vous pouvez supprimer les fichiers VirtualBox. OLD et VirtualBox.xml-prev pour plus de clarté. Il s’agit parfois de simples sauvegardes destinées à être remplacées.

Méthode 2. Supprimez le fichier VirtualBox.xml et réimportez les machines virtuelles.

Pourquoi ça aide : Si le fichier de configuration est complètement corrompu et qu’aucune sauvegarde n’est disponible, supprimer puis réimporter les configurations des machines virtuelles peut vous sauver la mise. C’est une sorte de réinitialisation, mais il vous suffira ensuite d’ajouter à nouveau vos machines virtuelles, ce qui n’est pas trop compliqué si vous êtes préparé.

Quand procéder : Si la restauration du fichier précédent ne fonctionne pas ou si le fichier de configuration est vide, une réinitialisation s’impose. Notez que certains paramètres de la machine virtuelle devront peut-être être reconfigurés par la suite, mais vos fichiers de machine virtuelle (.vdi, .vbox) seront préservés.

Mesures:

Vérifiez une fois de plus qu’aucun processus VirtualBox ne soit actif dans le Gestionnaire des tâches.
Accédez à C:\Users\votre_nom_d’utilisateur\.VirtualBox\.
Renommez VirtualBox.xml en VirtualBox. OLD.
Renommez VirtualBox.xml-prev en VirtualBox.xml-prev. OLD.
Lancez VirtualBox. Il s’ouvrira probablement avec une liste de machines virtuelles vide, en gros « nouvelles ».
Dans le gestionnaire de machines virtuelles, cliquez sur le bouton Ajouter (l’icône avec un plus vert).Accédez ensuite aux dossiers de vos machines virtuelles, généralement situés à :

C:\Utilisateurs\votre_nom_d’utilisateur\Machines virtuelles VirtualBox

Sélectionnez les fichiers .vbox correspondants à vos machines virtuelles et ouvrez-les. Répétez l’opération pour chaque machine virtuelle que vous souhaitez récupérer.
Après avoir ajouté toutes vos machines virtuelles, vous pouvez supprimer les fichiers VirtualBox. OLD et VirtualBox.xml-prev. OLD pour garder les choses propres.

Et voilà, c’est tout. Si les fichiers sont corrects, tout devrait rentrer dans l’ordre. Il faudra peut-être parfois reconfigurer certains paramètres réseau ou d’affichage, surtout si vous aviez des réglages personnalisés.

C’est un peu fastidieux, mais généralement, ça va une fois qu’on a compris le truc. Parfois, sur certaines configurations, il faut s’y reprendre à plusieurs fois, voire redémarrer une ou deux fois, avant que VirtualBox ne fonctionne. Parce que, bien sûr, Windows et VirtualBox ont la fâcheuse habitude de compliquer les choses inutilement.

J’espère que ça facilitera la tâche à certains. Ce n’est pas toujours simple, mais au moins c’est faisable sans tout réinstaller.

Résumé

Sauvegardez ou renommez le fichier VirtualBox.xml corrompu.
Essayez de restaurer à partir de VirtualBox.xml-prev.
Si nécessaire, supprimez et réimportez manuellement vos machines virtuelles.
Fermez toujours complètement VirtualBox et redémarrez-le si quelque chose ne va pas.

Conclure

La plupart du temps, restaurer ou reconstruire le fichier de configuration suffit, surtout si vous avez détecté le problème rapidement. Sinon, rajouter vos machines virtuelles n’est pas un souci majeur tant que les fichiers sont présents. Pensez simplement à noter cette astuce ou à sauvegarder le fichier XML pour la prochaine fois : perdre complètement la configuration de vos machines virtuelles est vraiment pénible. J’espère que cela évitera à certains une réinstallation complète ou des heures de frustration ; ça a fonctionné pour moi, j’espère que ça fonctionnera pour vous aussi.