Rastrea el origen de una exportación fallida de PDF de ONLYOFFICE.

Primero, guarda el documento original y, a continuación, determina si el error se produce durante la conversión a PDF de ONLYOFFICE o durante la descarga final en el navegador. Si el editor informa de un error de conversión, revisa los registros del servidor de documentos y confirma que este pueda acceder al archivo original. Si la conversión se realiza correctamente, pero el navegador muestra el mensaje «Error de descarga», comprueba el estado de descarga del navegador, los permisos del sitio y el espacio disponible en disco.

Escenario ilustrativo: Imaginemos que Jordan, un administrador que utiliza un editor de ONLYOFFICE Docs autohospedado, selecciona Archivo > Descargar como > PDF para un informe de proyecto. El editor muestra un error y no aparece el PDF. Este es un ejemplo hipotético, no un incidente real; el mismo síntoma puede presentarse en diferentes etapas, por lo que las comprobaciones que se describen a continuación se realizan a partir del punto en que se detiene el proceso.

1. Proteja la fuente y reproduzca el fallo una vez.

Antes de solucionar problemas, utilice Guardar o Ctrl+S para guardar los cambios actuales. En el editor de documentos en línea, ONLYOFFICE documenta la ruta de exportación a PDF como Archivo > Descargar como > PDF. El editor puede preparar primero el PDF y luego enviar el resultado al navegador, por lo que un error en la descarga del navegador no siempre significa que la conversión haya fallado.

Utilice el mismo informe para realizar un reintento controlado. Observe si el editor muestra un cuadro de diálogo de error, si el navegador crea una entrada de descarga fallida y si el problema afecta solo a este archivo o a todos. Evite hacer clic repetidamente en Exportar: las tareas duplicadas dificultan la vinculación de la marca de tiempo con la entrada correspondiente del registro del servidor.

2. Si el navegador muestra un error al descargar el PDF

Abra la página de Descargas del navegador e inspeccione el elemento que falló. Inténtelo de nuevo. Compruebe si el navegador bloqueó las descargas del sitio de ONLYOFFICE, si hay una confirmación de descarga en otra pestaña y si la unidad de destino tiene suficiente espacio libre. Si administra el navegador, pruebe el mismo documento guardado en un navegador alternativo o en un perfil de navegador nuevo. Si funciona, concéntrese en la configuración del navegador, las extensiones o el software de seguridad local; no modifique aún la configuración del servidor de documentos.

El caso hipotético de Jordan apuntaría al navegador cuando el editor termina de preparar el PDF, pero la lista de descargas informa de un fallo de red o de permisos. Una solución práctica es usar Archivo > Imprimir y seleccionar la opción "Guardar como PDF" del navegador o del sistema operativo, si está disponible. Compruebe las páginas, las fuentes y los enlaces resultantes, ya que la impresión puede diferir de la exportación directa a PDF del editor. Esta solución no corrige un error de conversión del servidor.

3. Si falla la conversión o la recuperación de la fuente

Para una instalación autohospedada, pida a un administrador que revise los registros del servidor de documentos en el momento del reintento. ONLYOFFICE documenta los registros de Linux en /var/log/onlyoffice/documentserver; para Docker, los registros están disponibles dentro del contenedor en esa ruta, y la salida de Docker también se puede revisar con docker logs <container>. El componente exacto y la redacción del registro dependen de la instalación y la versión. Busque errores de conversión, tiempos de espera, solicitudes fallidas, códigos de estado HTTP o errores de DNS y de conexión. No publique públicamente líneas de registro completas si contienen URL privadas, tokens de acceso, nombres de usuario o nombres de documentos.

Cuando los registros o la API identifiquen un problema de descarga de origen, verifique que el servidor de documentos pueda acceder a la URL del documento de origen desde su propio espacio de nombres de red. Un administrador puede probar la URL autorizada desde el servidor o contenedor y comprobar el DNS, el enrutamiento, las reglas del firewall, la configuración del proxy, los certificados TLS y la respuesta de la aplicación de almacenamiento. Una URL que se abre en el navegador de su escritorio puede seguir siendo inaccesible desde el servidor de documentos. Por el contrario, si la descarga de origen se realiza correctamente, pero la conversión falla, investigue el error del convertidor en lugar de modificar el acceso a la red.

Para flujos de trabajo de conversión basados ​​en API, utilice el código de error devuelto para identificar el problema. ONLYOFFICE define un error de conversión -4como un error al descargar el archivo de entrada, -2un tiempo de espera agotado, -3un error de conversión o -8un token no válido. Estos códigos son específicos de la respuesta de la API de conversión; el mensaje genérico "Error de descarga" en el editor no demuestra por sí solo que la conversión a PDF haya devuelto uno de estos códigos.

4. Compruebe el acceso, los permisos y el tamaño solo cuando haya evidencia que lo indique.

Si solo fallan los archivos almacenados en una plataforma conectada, verifique la dirección del servidor de documentos del conector y la configuración de acceso interno. El servicio de edición debe poder recuperar el archivo de su sistema de almacenamiento. La documentación de solución de problemas de ONLYOFFICE describe el error "Error de descarga" durante la carga del editor como la imposibilidad del servicio de edición para acceder a la URL del archivo. Esta información es útil cuando el informe no se abre o no se carga; si el editor se abre normalmente y solo falla la exportación a PDF, primero revise la etapa de exportación o descarga.

Si la API informa de un token no válido, compare la configuración del secreto, el encabezado y el token JWT en ambos lados. No desactive JWT como solución rápida. Si la API indica un límite de tamaño, compare el archivo con los límites configurados en su implementación. Un archivo grande o una fuente no compatible o dañada pueden requerir una solución diferente; cambiar el navegador o la red no solucionará un límite de conversión ni un documento dañado.

Active el registro de depuración solo si los registros normales no muestran dónde se detiene la solicitud y desactívelo después de recopilar la evidencia necesaria. Los registros de depuración pueden contener detalles confidenciales de la solicitud. Siga las instrucciones de ONLYOFFICE para su tipo de instalación y comparta un extracto del registro anonimizado con su administrador o equipo de soporte en lugar de exponer las URL de los documentos o los tokens.

Verificar el resultado

• Confirme que el archivo descargado existe, tiene un tamaño distinto de cero y se abre en un lector de PDF.
• Comprueba la primera y la última página, el número de páginas y algunas fuentes o imágenes clave comparándolas con la fuente original.
• Repita la exportación una vez después de aplicar la corrección correspondiente. Si aún así falla, registre la hora, la versión de ONLYOFFICE Docs, la etapa de exportación y el código de error (o un fragmento del registro) censurado.

La documentación de ONLYOFFICE distingue entre los pasos de descarga de PDF y los errores de conversión. Consulte las instrucciones de descarga e impresión del Editor de documentos , la guía oficial de solución de problemas de integración , los códigos de error de la API de conversión y la guía de registro de depuración para obtener información específica para su implementación.