Solución de problemas
Resuelve problemas de puertos, proveedor, importación, progreso y exportación.
El puerto 8000 o 2499 ya está utilizado
Un proceso anterior sigue activo u otra aplicación utiliza el puerto. Detén correctamente la instancia anterior de TraDoc o ejecuta:
.\.venv\Scripts\python.exe main.py dev --api-port 8001 --web-port 2500Error 403 en la prueba de conexión
Comprueba que utilizas la interfaz servida por la instancia, no una pestaña antigua u otro origen. Revisa ALLOWED_ORIGINS y el modo LAN elegido.
Proveedor desconectado
Comprueba el proceso, la URL, la clave, el modelo, el cortafuegos y el acceso a la red. En Docker, localhost no designa el host.
Importación rechazada
Comprueba la extensión, el tamaño, la integridad del archivo y la presencia de una capa de texto en los PDF. Revisa MAX_UPLOAD_BYTES, MAX_ARCHIVE_ENTRIES y MAX_ARCHIVE_UNCOMPRESSED_BYTES.
No hay vista previa
Debe haberse completado al menos un segmento. Si no se ha traducido nada, el servidor devuelve un conflicto en lugar de un resultado falso.
Reconstrucción imposible
Puede faltar un bloque, haber cambiado la estructura original o no existir el archivo de entrada. No borres manualmente data/jobs/. Restaura una copia coherente si es necesario.
El servidor se detiene tras un cambio
Con --reload, Uvicorn se reinicia después de un cambio en Python. Si se cierra el supervisor completo, inicia una sola instancia y comprueba que ningún proceso hijo conserve el puerto.