Fehlerbehebung
Probleme mit Ports, Anbieter, Import, Fortschritt und Export lösen.
Port 8000 oder 2499 ist bereits belegt
Ein alter Prozess läuft noch oder eine andere Anwendung verwendet den Port. Beende die vorherige TraDoc-Instanz sauber oder starte:
.\.venv\Scripts\python.exe main.py dev --api-port 8001 --web-port 2500403 beim Verbindungstest
Verwende die von der Instanz ausgelieferte Oberfläche, nicht einen alten Tab oder einen anderen Ursprung. Prüfe ALLOWED_ORIGINS und den gewählten LAN-Modus.
Anbieter nicht erreichbar
Prüfe Prozess, URL, Schlüssel, Modell, Firewall und Netzwerkzugriff. In Docker bezeichnet localhost nicht den Host.
Import abgelehnt
Prüfe Erweiterung, Größe, Archivintegrität und bei PDF das Vorhandensein einer Textebene. Kontrolliere MAX_UPLOAD_BYTES, MAX_ARCHIVE_ENTRIES und MAX_ARCHIVE_UNCOMPRESSED_BYTES.
Keine Vorschau verfügbar
Mindestens ein Segment muss abgeschlossen sein. Wurde noch nichts übersetzt, antwortet der Server mit einem Konflikt statt mit einem falschen Ergebnis.
Rekonstruktion nicht möglich
Ein Block kann fehlen, die Quellstruktur kann sich geändert haben oder die Eingabedatei kann fehlen. Lösche data/jobs/ nicht manuell. Stelle bei Bedarf ein konsistentes Backup wieder her.
Server stoppt nach einer Änderung
Mit --reload startet Uvicorn nach einer Python-Änderung neu. Wenn der gesamte Supervisor endet, starte nur eine Instanz und prüfe, ob ein Kindprozess den Port weiterhin belegt.