Identifier la source d'une exportation PDF ONLYOFFICE ayant échoué

Commencez par enregistrer le document source, puis déterminez si l'erreur se produit lors de la conversion PDF par ONLYOFFICE ou lors du téléchargement final par le navigateur. Si l'éditeur signale une erreur de conversion, consultez les journaux du serveur de documents et vérifiez que le serveur peut accéder au fichier source. Si la conversion réussit mais que le navigateur affiche « Échec du téléchargement », vérifiez plutôt l'état du téléchargement, les autorisations du site et l'espace disque disponible.

Scénario illustratif : Imaginons que Jordan, un administrateur utilisant un éditeur ONLYOFFICE Docs auto-hébergé, sélectionne Fichier > Télécharger au format > PDF pour un rapport de projet. L’éditeur affiche une erreur et aucun fichier PDF n’apparaît. Il s’agit d’un exemple hypothétique, et non d’un incident testé ; le même symptôme peut se produire à différentes étapes, c’est pourquoi les vérifications ci-dessous prennent suite à l’étape où le processus s’interrompt.

1. Protégez la source et reproduisez la panne une seule fois.

Avant de tenter de résoudre le problème, utilisez la fonction Enregistrer ou Ctrl+S pour sauvegarder vos modifications. Dans l'éditeur de documents en ligne, ONLYOFFICE indique que le chemin d'exportation PDF est : Fichier > Télécharger au format > PDF. L'éditeur peut d'abord préparer le PDF, puis transmettre le résultat au navigateur ; un échec de téléchargement par le navigateur n'indique donc pas forcément un échec de la conversion.

Utilisez le même rapport pour effectuer une nouvelle tentative contrôlée. Notez si l'éditeur affiche une boîte de dialogue d'erreur, si le navigateur crée une entrée de téléchargement ayant échoué et si le problème affecte uniquement ce fichier ou tous les fichiers. Évitez de cliquer plusieurs fois sur Exporter : les tâches dupliquées compliquent l'association d'un horodatage à l'entrée correspondante du journal du serveur.

2. Si le navigateur affiche un échec de téléchargement du PDF

Ouvrez la page Téléchargements de votre navigateur et examinez l'élément qui a échoué. Réessayez. Vérifiez si votre navigateur bloque les téléchargements depuis le site ONLYOFFICE, si une confirmation de téléchargement est en attente dans un autre onglet et si le disque de destination dispose de suffisamment d'espace libre. Si vous administrez votre navigateur, testez le même document enregistré dans un autre navigateur récent ou avec un profil utilisateur vierge. Si cela fonctionne, concentrez-vous sur les paramètres de votre navigateur, ses extensions ou votre logiciel de sécurité local ; ne modifiez pas encore la configuration du serveur de documents.

Le cas hypothétique de Jordan indiquerait que le problème vient du navigateur : lorsque l’éditeur termine la préparation du PDF, la liste de téléchargement signale une erreur de réseau ou d’autorisation. Une solution de contournement consiste à utiliser Fichier > Imprimer et à choisir l’option « Enregistrer au format PDF » du navigateur ou du système d’exploitation, si elle est disponible. Vérifiez les pages, les polices et les liens, car le résultat imprimé peut différer de l’exportation PDF directe de l’éditeur. Cette solution ne corrige pas les erreurs de conversion côté serveur.

3. En cas d'échec de la conversion ou de la récupération de la source

Pour une installation auto-hébergée, demandez à un administrateur de consulter les journaux du serveur de documents au moment de la nouvelle tentative. ONLYOFFICE enregistre les journaux Linux sous le répertoire `/usr/local/documents/logs`. /var/log/onlyoffice/documentserverPour Docker, les journaux sont disponibles à l'intérieur du conteneur à cet emplacement, et la sortie Docker peut également être consultée avec `docker logs` docker logs <container>. Le composant exact et la formulation des journaux dépendent de l'installation et de la version. Recherchez les erreurs de conversion, les délais d'attente, les requêtes ayant échoué, les codes d'état HTTP, ainsi que les erreurs DNS et de connexion. Ne publiez pas publiquement des lignes de journal complètes si elles contiennent des URL privées, des jetons d'accès, des noms d'utilisateur ou des noms de documents.

Lorsqu'un problème de téléchargement de source est détecté par les journaux ou l'API, vérifiez que le serveur de documents peut accéder à l'URL du document source depuis son espace de noms réseau. Un administrateur peut tester l'URL autorisée depuis le serveur ou le conteneur et vérifier le DNS, le routage, les règles de pare-feu, les paramètres de proxy, les certificats TLS et la réponse de l'application de stockage. Une URL qui s'ouvre dans votre navigateur peut rester inaccessible depuis le serveur de documents. À l'inverse, si le téléchargement de la source réussit mais que la conversion échoue, examinez l'erreur du convertisseur plutôt que de modifier l'accès réseau.

Pour les flux de conversion basés sur une API, utilisez le code d'erreur renvoyé pour identifier le problème. ONLYOFFICE définit une erreur de conversion -4comme une erreur de téléchargement du fichier d'entrée, -2un délai d'attente dépassé, -3une erreur de conversion ou -8un jeton invalide. Ces codes sont spécifiques à la réponse de l'API de conversion ; le message générique « Échec du téléchargement » dans l'éditeur ne prouve pas à lui seul qu'une conversion PDF a renvoyé l'un de ces codes.

4. Vérifiez l'accès, les autorisations et la taille uniquement lorsque des preuves le démontrent.

Si seuls les fichiers stockés sur une plateforme connectée échouent, vérifiez l'adresse du serveur de documents du connecteur et ses paramètres d'accès internes. Le service d'édition doit pouvoir récupérer le fichier depuis son système de stockage. La documentation de dépannage d'ONLYOFFICE explique l'erreur « Échec du téléchargement » lors du chargement de l'éditeur par l'impossibilité pour le service d'édition d'accéder à l'URL du fichier. Cette information est utile lorsque le rapport ne s'ouvre pas ou ne se charge pas ; si l'éditeur s'ouvre normalement et que seule l'exportation PDF échoue, examinez d'abord l'étape d'exportation ou de téléchargement.

Si l'API signale un jeton invalide, comparez la clé secrète JWT, l'en-tête et la configuration du jeton des deux côtés. Ne désactivez pas JWT pour contourner le problème. Si l'API indique une limite de taille, comparez le fichier avec les limites configurées dans votre déploiement. Un fichier volumineux ou une source non prise en charge/corrompue peut nécessiter une autre solution ; changer de navigateur ou de réseau ne résoudra pas un problème de limite de conversion ou un document endommagé.

N'activez la journalisation de débogage que si les journaux ordinaires n'indiquent pas où la requête s'arrête, et désactivez-la une fois les preuves nécessaires recueillies. Les journaux de débogage peuvent contenir des informations sensibles sur les requêtes. Suivez les instructions d'ONLYOFFICE correspondant à votre type d'installation et partagez un extrait de journal expurgé avec votre administrateur ou votre équipe de support plutôt que de divulguer les URL des documents ou les jetons.

Vérifier le résultat

• Vérifiez que le fichier téléchargé existe, qu'il a une taille non nulle et qu'il s'ouvre dans un lecteur PDF.
• Vérifiez la première et la dernière page, le nombre de pages et quelques polices ou images clés par rapport à la source.
• Répétez l'exportation une fois après la correction. Si l'opération échoue toujours, notez l'heure, la version d'ONLYOFFICE Docs, l'étape d'exportation et le code d'erreur (masqué) ou un extrait du journal.

La documentation d'ONLYOFFICE fait la distinction entre les étapes de téléchargement de PDF et les erreurs de conversion. Consultez les instructions de téléchargement et d'impression de l'éditeur de documents , le guide de dépannage officiel de l'intégration , les codes d'erreur de l'API de conversion et le guide de journalisation de débogage pour obtenir des informations détaillées correspondant à votre configuration.