Si ONLYOFFICE muestra el mensaje "Error de descarga" después de exportar un documento como PDF, primero averigüe qué parte falló: la generación del PDF, la transferencia de ONLYOFFICE a su dispositivo o el guardado final en el navegador. Una exportación exitosa debería generar un PDF no vacío que se abra correctamente y conserve los saltos de página, las tablas y las fuentes importantes. Pruebe las siguientes comprobaciones en orden; cada una ayuda a identificar la causa sin modificar el documento original.
Comience por identificar su versión de ONLYOFFICE.
En el editor de documentos en línea, la ruta documentada es Archivo > Descargar como > PDF . La opción "Guardar copia como" guarda una copia en el portal en lugar de descargarla a su computadora. En los editores de escritorio, use Archivo > Guardar como y seleccione PDF. Las etiquetas y las opciones disponibles varían según la aplicación y la versión, por lo que no dé por sentado que existe un menú en línea en la aplicación de escritorio. Consulte las instrucciones de descarga e impresión de documentos de ONLYOFFICE y la guía de la pestaña Archivo .
Si está editando un PDF existente en el editor de PDF en línea, el proceso de descarga también se encuentra en Archivo, pero se trata de un editor diferente. Siga las instrucciones de la aplicación que tiene abierta.
1. Proteja sus ediciones antes de solucionar problemas.
Antes de exportar de nuevo, guarda el documento original. En el editor en línea, usa Ctrl+S o Archivo > Guardar (si está disponible) y espera a que aparezca el indicador de guardado. ONLYOFFICE guarda automáticamente los cambios en su editor en línea, pero aun así debes confirmar que se hayan guardado antes de actualizar o cerrar la sesión. En los editores de escritorio, guarda primero el archivo de trabajo de forma habitual.
Luego, haz una copia del documento e intenta exportarlo desde esa copia. Esto te permite realizar una prueba segura sin arriesgar el original. Evita hacer clic repetidamente en Exportar mientras se esté ejecutando una solicitud; las descargas superpuestas pueden dificultar la identificación del archivo que se exportó correctamente.
2. Utilice un documento de prueba pequeño para aislar el fallo.
Crea un nuevo documento de una página con una línea de texto corta y expórtalo como PDF usando la misma aplicación y dispositivo. Comprueba si el PDF aparece en la lista de descargas del navegador o en la carpeta seleccionada en el cuadro de diálogo para guardar en el escritorio, y confirma que el tamaño del archivo sea mayor que cero. Ábrelo con un lector de PDF y asegúrate de que el texto sea visible.
- El PDF de prueba funciona: la ruta de exportación está disponible. El archivo original puede contener contenido o formato que provoque un problema de conversión, o su descarga puede ser inusualmente grande o lenta. Continúe con una copia del original y simplifique temporalmente las imágenes pesadas, los objetos incrustados o el diseño complejo, una categoría a la vez.
- El PDF de prueba también falla en el editor en línea: compruebe las descargas del navegador e intente la alternativa que se indica a continuación. Si el problema persiste en diferentes navegadores o usuarios, es posible que el servicio en línea o su integración requieran atención.
- El PDF de prueba funciona en editores de escritorio, pero no en línea: es más probable que el problema esté relacionado con el navegador, la sesión en línea, el portal o la conexión al servidor de documentos que con la exportación de PDF en general.
Esta comparación es una pista diagnóstica, no una prueba de la causa raíz. Registre la aplicación, el navegador, la hora, el tamaño del documento y si el fallo afecta a un solo archivo o a todos.
3. Generación de PDF independiente de la descarga del navegador.
En el editor en línea, seleccione Archivo > Descargar como > PDF una vez y, a continuación, revise el panel de descargas del navegador. Si aparece un archivo, utilice la opción "Mostrar en carpeta" o similar del navegador y compruebe su tamaño. Si el archivo se abre correctamente, significa que la generación del PDF se realizó con éxito; el problema restante podría estar en la ubicación donde el navegador lo guardó o en cómo gestionó la descarga.
Si la descarga se bloquea, se interrumpe o no se completa, revise las notificaciones de descarga del navegador y el espacio disponible en el disco del sistema operativo. Si su navegador u organización bloquea las descargas del sitio, pregunte al administrador si el sitio tiene permiso para descargar archivos. Para una prueba única, utilice otro navegador compatible en el mismo dispositivo o en otro dispositivo con la misma cuenta. Si funciona, concéntrese en la configuración de descarga, las extensiones, el software de seguridad o el almacenamiento local del primer navegador, en lugar de modificar el documento.
La navegación privada puede ayudar a determinar si una extensión o los datos almacenados del sitio están involucrados, pero solo si puedes iniciar sesión y abrir el mismo documento allí. No soluciona un error de exportación del servidor y puede no ser apropiada para cuentas administradas. No borres todos los datos del navegador como primer paso; esto puede cerrar tu sesión en servicios no relacionados.
4. Prueba una ruta alternativa y compara el resultado.
Para un documento en el editor de documentos en línea, vaya a Archivo > Guardar copia como y seleccione PDF si este formato está disponible. Esto guarda una copia en el portal; no comprueba la misma ruta de descarga del navegador al ordenador. Si se abre la copia del portal, es probable que la exportación haya generado un PDF y que la ruta de descarga directa sea el problema principal.
También puedes intentar imprimir en PDF como solución temporal. ONLYOFFICE documenta una opción de impresión e indica que Firefox puede imprimir sin descargar primero el PDF. Selecciona una ubicación para el PDF en el cuadro de diálogo de impresión si tu navegador o sistema operativo lo permite. En los editores de escritorio, usa la opción PDF del cuadro de diálogo de impresión si está disponible. Compara el número de páginas, los saltos de página y cualquier contenido cerca de los márgenes con el original.
Imprimir a PDF no es lo mismo que exportar. Puede aplicar ajustes de maquetación y modificar el tamaño de la página u omitir contenido fuera del área imprimible. Úselo solo cuando el archivo resultante cumpla con sus estándares de calidad, especialmente para formularios, hojas de cálculo o documentos con paginación precisa.
5. Si utiliza editores de escritorio, guarde en una ruta local sencilla.
En los editores de escritorio, seleccione Archivo > Guardar como, elija PDF y guarde una copia en una carpeta donde tenga permisos de escritura, como la carpeta Documentos. Asígnele un nombre de archivo corto con letras y números comunes. No guarde directamente en un recurso compartido de red, una carpeta sincronizada, una unidad extraíble o un directorio protegido del sistema durante la primera prueba. Si la copia local funciona, vuelva a intentarlo con la ubicación deseada; esta comparación indica un problema con la ubicación o los permisos.
Si el cuadro de diálogo para guardar se completa pero no aparece ningún PDF utilizable, compruebe que la carpeta tenga permisos de escritura y espacio libre. Cierre el visor de PDF que pueda tener bloqueado el archivo de destino, elija un nombre de archivo nuevo e inténtelo de nuevo. Si solo falla un documento de origen, mientras que una prueba básica se realiza correctamente, cree una copia de trabajo y realice la prueba después de retirar o reemplazar cualquier soporte de almacenamiento inusualmente grande o dañado. Conserve el original sin cambios hasta que haya verificado la copia.
6. Cuándo debe un administrador inspeccionar el servidor
Si todos los usuarios experimentan el fallo en el editor en línea, o si fallan tanto la descarga directa como la copia desde el portal, proporcione a su administrador de ONLYOFFICE la hora del intento, el tamaño aproximado del documento afectado, el navegador y su versión, e indique si también falla un documento de prueba pequeño. En el caso de una instalación integrada o autoalojada, el administrador debe revisar los registros del servidor de documentos y de la plataforma en torno a esa hora, confirmar que el editor y la plataforma de almacenamiento pueden comunicarse entre sí y revisar los cambios recientes en el proxy o la red.
La guía de solución de problemas de ONLYOFFICE relaciona ciertos errores del editor con tokens de seguridad caducados, sesiones interrumpidas o errores al guardar, y recomienda a los administradores que revisen los registros de DocService y la accesibilidad de la devolución de llamada para detectar fallos al guardar. Estos mensajes son diagnósticos relacionados, no una explicación universal para cada alerta de "Error de descarga". Si la instancia se encuentra detrás de un proxy inverso, verifique los encabezados de host y protocolo reenviados según la guía de configuración de proxy de ONLYOFFICE vigente . Los administradores pueden seguir las instrucciones de registro de depuración de ONLYOFFICE para obtener más detalles y, posteriormente, restablecer el registro a su nivel normal tras el diagnóstico.
No modifique las claves JWT, no desactive la autenticación ni exponga el servidor de documentos públicamente para realizar pruebas. Estos cambios pueden generar problemas de seguridad e integración, además de dejar sin resolver el error de exportación.
Cómo confirmar que el problema está solucionado
Exporte un documento de prueba pequeño y, a continuación, la copia de trabajo del original. Confirme que cada PDF tenga un tamaño distinto de cero, se abra sin errores, contenga el número de páginas esperado y conserve el texto, las tablas, las imágenes y los saltos de página importantes. Si utilizó «Guardar copia como» o «Imprimir a PDF», verifique que el archivo se encuentre en el portal o carpeta local correspondiente y compare su formato con la exportación normal. Si solo funciona una de las opciones, registre esta diferencia para su administrador; esto indica la etapa que aún requiere investigación.
Referencias oficiales