Assistenten- und Startprobleme
Letzte Aktualisierung: 14.10.2026Port wird bereits verwendet
Mögliche Ursache
Eine andere Instanz von QV2QS oder eine andere Anwendung verwendet denselben Netzwerkport. Die Konsole zeigt an ERROR: Port [number] is already in use.
Vorgeschlagene Aktion
Schließen Sie die andere Anwendung, oder geben Sie einen anderen Port mit --port an. Verwenden Sie --port 0, damit das System automatisch einen verfügbaren Port auswählen kann.
Der Assistent öffnet sich im Internet Explorer oder wird nicht korrekt dargestellt
Mögliche Ursache
Internet Explorer ist der Standardbrowser auf dem Computer. Die QV2QS-Benutzeroberfläche erfordert einen modernen Browser und funktioniert nicht im Internet Explorer.
Vorgeschlagene Aktion
Installieren Sie Google Chrome, Microsoft Edge oder Mozilla Firefox. QV2QS erkennt den Standardbrowser beim Start und öffnet automatisch einen unterstützten Browser, wenn einer verfügbar ist. Wenn kein unterstützter Browser gefunden wird, zeigt die Konsole Herunterladen-Links an.
Auf Windows Server 2019 ist Internet Explorer der einzige standardmäßig installierte Browser. Installieren Sie einen unterstützten Browser, bevor Sie QV2QS im Assistentenmodus ausführen. Alternativ verwenden Sie die Befehlszeilenschnittstelle, die keinen Browser erfordert. Siehe Argumentreferenz für die vollständige Liste der CLI-Argumente.
Konvertierung schlägt fehl oder liefert unerwartete Ergebnisse im Assistenten
Mögliche Ursache
Der Assistent zeigt einen zusammenfassenden Fehler an, legt aber nicht die vollständigen Diagnosedetails offen, die zur Identifizierung der Grundursache erforderlich sind.
Vorgeschlagene Aktion
Führen Sie dieselbe Konvertierung über die Befehlszeile mit aktiviertem Debug-Logging erneut aus. Gehen Sie folgendermaßen vor:
- Navigieren Sie im Assistenten zum Schritt Überprüfung.
- Klicken Sie auf Befehl kopieren, um den vollständigen CLI-Befehl in die Zwischenablage zu kopieren.
- Öffnen Sie ein Terminalfenster und fügen Sie den kopierten Befehl ein.
- Hängen Sie
--logLevel DEBUGan das Ende des Befehls an und drücken Sie die Eingabetaste.
Die Konsole zeigt eine ausführliche Ausgabe an, die jede Konvertierungsentscheidung, jeden Cloud-API-Aufruf und jeden Objekverarbeitungsschritt abdeckt. Das vollständige Debug-Protokoll wird auch in den logs/ Unterordner im Ausgabeverzeichnis geschrieben.
Der kopierte Befehl enthält alle im Assistenten konfigurierten Einstellungen. Das Anhängen von --logLevel DEBUG ist die einzige Änderung, die erforderlich ist, um die vollständige Diagnose zu aktivieren.
Siehe Protokollierung und Diagnose für Details zum Protokolldateiformat und Standort.
QV2QS wurde beendet
Modalfenster erscheint im Browser
Mögliche Ursache
Der QV2QS-Prozess wurde geschlossen, ist abgestürzt oder wurde beendet, während der Assistent noch im Browser geöffnet war. Die Benutzeroberfläche überwacht den Backend-Dienst mit einer regelmäßigen Zustandsprüfung und zeigt das Modal an, wenn der Dienst nicht erreichbar wird.
Vorgeschlagene Aktion
Gehen Sie folgendermaßen vor:
- Verbindung zur aktuellen Sitzung wiederherstellen. Kopieren Sie den Befehl, der im Modal angezeigt wird, und führen Sie ihn in einem Terminal aus. Der Befehl enthält
--portund--noBrowserum sich auf demselben Browser-Tab am selben Port wieder anzuhängen. Nach dem Serverstart klicken Sie im Modal auf Neu verbinden. Der Assistent wird mit allen zuvor eingegebenen Einstellungen fortgesetzt. - Schließen Sie den Browser-Tab. Klicken Sie auf Fenster schließen im Modal. Alle nicht gespeicherten Einstellungen in der aktuellen Assistentensitzung gehen verloren.
Beispielprojektdatei fehlt oder ist beschädigt
Mögliche Ursache
Die Beispiel-QVW-Datei in %TEMP%\QV2QS\examples\ wurde gelöscht, verschoben oder außerhalb von QV2QS geändert.
Vorgeschlagene Aktion
Löschen Sie die betroffene Datei aus %TEMP%\QV2QS\examples\ und starten Sie QV2QS neu. Eine neue Kopie wird beim Start automatisch extrahiert. Um eine dauerhafte Kopie einer Beispieldatei zu behalten, kopieren Sie die Datei vor dem Ändern in einen lokalen Arbeitsordner. Siehe Beispielprojekte.