Se rendre au contenu

L'impression PDF bloque Odoo : le blocage des workers et la solution

L'impression PDF bloque Odoo : le blocage des workers et la solution
Benjamin Akboka Apengu
novembre 16, 2026 · 8 min de lecture

La réponse courte

Quand Odoo imprime un PDF, il se rappelle lui-même pour charger le CSS, les polices et les images du rapport. En mode multi-workers, cet appel a besoin d'un deuxième worker libre. Si tous les workers sont occupés à imprimer, chacun attend un worker qui ne se libère jamais. Odoo se fige pour tout le monde, jusqu'à ce qu'il tue ces workers, environ deux minutes plus tard.

Il y a deux solutions. Ajouter des workers, pour qu'il en reste toujours un de libre. Ou faire pointer report.url vers le processus gevent d'Odoo, qui peut répondre à ces appels même quand tous les workers sont occupés. La deuxième solution supprime le blocage pour de bon.

Ce que vous voyez

  • Quelqu'un clique sur Imprimer et la roue continue de tourner.
  • Les autres utilisateurs voient Odoo arrêter de charger au même moment, même s'ils n'impriment rien.
  • Après environ deux minutes, l'impression échoue, ou le PDF revient sans mise en page : pas de logo, pas de polices, le texte tassé sur une seule colonne.
  • Votre log Odoo montre des lignes comme celle-ci :
ERROR ? odoo.service.server: WorkerHTTP (12345) timeout after 120s

Cela arrive souvent au pire moment de la journée. La facturation de fin de mois, une série de bons de livraison, ou trois personnes au comptoir qui impriment des tickets en même temps.

Pourquoi cela arrive

Avec workers au-dessus de 0, Odoo fait tourner un nombre fixe de workers HTTP. Chacun traite une requête à la fois.

Une impression PDF se passe ainsi :

  1. Un worker reçoit la demande d'impression. Il construit le rapport en HTML.
  2. Il passe le HTML à wkhtmltopdf et attend.
  3. wkhtmltopdf ouvre le HTML et charge le CSS, les polices et les images liés. Il les charge depuis Odoo, en HTTP, à l'adresse du paramètre système report.url. S'il n'existe pas, il utilise web.base.url.
  4. Ces requêtes HTTP ont elles aussi besoin d'un worker.

Une impression a donc besoin de deux workers : un qui attend, et un qui sert les fichiers. Disons que vous avez 3 workers et que 3 personnes impriment au même moment. Les 3 workers attendent wkhtmltopdf. wkhtmltopdf attend un worker. Plus rien ne bouge.

Odoo met une limite de temps sur chaque requête, limit_time_real, de 120 secondes par défaut. Quand elle est atteinte, Odoo tue les workers bloqués et en lance de nouveaux. C'est le "timeout after 120s" de votre log, et c'est pour cela que le blocage dure environ deux minutes.

Les actions planifiées qui envoient des factures par e-mail impriment aussi des PDF. Elles n'utilisent pas de worker HTTP pour l'impression elle-même, mais leurs appels wkhtmltopdf en ont besoin d'un. Une grosse série de factures envoyées par e-mail allonge donc la file.

Si Odoo tourne avec workers = 0 (un seul processus avec des threads), cela n'arrive pas. Ce mode traite les requêtes en même temps. Mais il est trop lent pour une équipe en production, donc la plupart des installations touchées ne devraient pas y revenir.

Vérifiez que c'est bien votre problème

Cherchez les timeouts de workers dans le log :

grep -E "WorkerHTTP .* timeout after" /var/log/odoo/odoo-server.log

Sur Docker :

docker logs your-odoo-container 2>&1 | grep -E "WorkerHTTP .* timeout after"

Puis regardez combien de workers vous avez :

grep -E "^\s*(workers|gevent_port|dbfilter)\s*=" /etc/odoo/odoo.conf

Si les timeouts tombent aux moments où les gens imprimaient, et que vous avez peu de workers (2 à 4, c'est courant), c'est très probablement la cause.

Solution 1 : ajouter des workers

Gardez plus de workers que le nombre de PDF imprimés au même moment, avec de la place pour tous ceux qui utilisent Odoo à côté. Si trois personnes peuvent imprimer en même temps et que cinq autres travaillent dans Odoo, 3 workers ne suffisent pas.

[options]
workers = 6

Redémarrez Odoo après le changement.

Cela marche, mais avec des limites. Chaque worker utilise de la mémoire, donc la RAM de votre serveur limite leur nombre. Notre guide sur le nombre de workers Odoo dont vous avez besoin montre comment le calculer. Et cela ne fait que déplacer la limite. Un jour chargé, assez d'impressions en même temps bloquent encore tout.

Solution 2 : envoyer wkhtmltopdf vers le processus gevent

En mode multi-workers, Odoo lance aussi un processus gevent sur gevent_port (8072 par défaut). On le connaît surtout comme le port websocket du chat et des notifications. Mais il sert toute l'application Odoo, et il peut traiter beaucoup de requêtes en même temps. Si wkhtmltopdf charge ses fichiers par là, il n'attend jamais de worker HTTP. Le blocage ne peut plus arriver.

Étape 1 : vérifiez que gevent répond

Le processus gevent ne tourne que si workers est au-dessus de 0. Sur le serveur, ou dans le conteneur Odoo :

curl -s -o /dev/null -w "%{http_code} %{redirect_url}\n" http://127.0.0.1:8072/web/login

Vous voulez 200 et rien après. Si la connexion est refusée, vérifiez que workers est au-dessus de 0 et que gevent_port n'a pas une autre valeur. Sur Odoo 15 et avant, l'option s'appelle longpolling_port.

Étape 2 : assurez-vous qu'Odoo trouve votre base depuis cette adresse

wkhtmltopdf va appeler 127.0.0.1, pas votre domaine. Si votre dbfilter utilise %d ou %h, Odoo choisit la base d'après le nom de domaine, et 127.0.0.1 ne correspond à aucune. Le PDF sort alors sans mise en page.

Si le test de l'étape 1 a redirigé vers /web/database/selector, ou a renvoyé une erreur, c'est pour cela. Avec une seule base par Odoo, mettez le nom de la base dans le filtre :

[options]
dbfilter = ^votre_base$

Redémarrez Odoo et refaites le test de l'étape 1.

Si un même Odoo sert plusieurs bases choisies par domaine, cette solution ne convient pas telle quelle. Utilisez la solution 1 pour ce cas.

Étape 3 : réglez report.url

Dans Odoo, activez le mode développeur. Allez dans Paramètres, puis Technique, puis Paramètres système. Créez-en un nouveau :

  • Clé : report.url
  • Valeur : http://127.0.0.1:8072

Ou en ligne de commande :

odoo shell -c /etc/odoo/odoo.conf -d votre_base <<'EOF'
env['ir.config_parameter'].set_param('report.url', 'http://127.0.0.1:8072')
env.cr.commit()
EOF

Odoo n'utilise report.url que pour charger les fichiers pendant l'impression. Les liens dans vos PDF, comme le lien vers une facture sur le portail client, utilisent toujours votre vrai domaine.

Étape 4 : testez

Imprimez une facture. Elle doit être identique à avant, avec votre logo et vos polices.

Puis essayez de tout bloquer. Ouvrez autant d'onglets que vous avez de workers, et imprimez un PDF dans chacun au même moment. Avant la solution, cela figeait Odoo pendant deux minutes. Après, chaque PDF revient.

Si un PDF sort maintenant sans mise en page, revenez à l'étape 2. Odoo n'a pas trouvé votre base depuis 127.0.0.1.

Quelle solution choisir ?

Les deux. La solution 2 supprime le blocage. La solution 1 décide toujours de la vitesse d'Odoo quand beaucoup de gens l'utilisent, car chaque impression garde un worker pendant qu'elle attend. Avec la solution 2 en place, trop peu de workers veut dire une impression lente, pas un Odoo figé.

Pensez à l'étape 2 quand vous copiez la production vers le staging, ou que vous restaurez une sauvegarde sous un nouveau nom de base. Le dbfilter et le report.url doivent correspondre à la nouvelle installation, sinon l'impression ne marche plus sur la copie.

Comment Skysize s'en occupe

Sur Skysize, c'est réglé pour vous. Chaque Odoo avec plus d'un worker imprime via le processus gevent, et le réglage est revérifié après chaque déploiement, restauration et copie vers le staging. L'impression ne peut pas bloquer votre Odoo, et vous n'avez aucune de ces étapes à retenir.

Cela marche de la même façon avec notre infogérance Odoo, sur votre propre serveur et dans votre propre réseau, pour Community et Enterprise.

Skysize est conçu par d'anciens ingénieurs d'Odoo et certifié ISO 27001.

Essayez avec votre propre base grâce à l'essai gratuit de 7 jours. Aucune carte bancaire demandée.

Parlez à un expert en hébergement Odoo

FAQ

Pourquoi Odoo se fige-t-il quand plusieurs personnes impriment en même temps ? Chaque impression PDF garde un worker et en demande un deuxième pour servir son CSS, ses polices et ses images. Quand tous les workers impriment, aucun n'est libre pour servir ces fichiers, et ils attendent tous jusqu'à ce qu'Odoo les tue après 120 secondes.

Pourquoi mon PDF Odoo sort-il sans styles ni logo ? wkhtmltopdf n'a pas pu charger le CSS et les images du rapport depuis Odoo. Soit aucun worker n'était libre pour les servir, soit l'adresse dans report.url (ou web.base.url) n'atteint pas votre base. Vérifiez les deux.

Qu'est-ce que report.url dans Odoo ? Un paramètre système qui indique à Odoo où wkhtmltopdf doit charger les fichiers du rapport. S'il n'existe pas, Odoo utilise web.base.url. Odoo ne s'en sert pour rien d'autre.

Quel port utilise le processus gevent d'Odoo ? 8072 par défaut, réglé avec gevent_port (longpolling_port sur Odoo 15 et avant). Il ne tourne que si workers est au-dessus de 0.

Faut-il simplement augmenter limit_time_real ? Non. Une limite plus longue fait durer le blocage plus longtemps. Les workers s'attendent les uns les autres, ils ne travaillent pas lentement.

L'impression PDF bloque Odoo : le blocage des workers et la solution
Benjamin Akboka Apengu
Écrit sur l'infrastructure Odoo chez Skysize, un hébergeur Odoo basé en Belgique, créé par d'anciens ingénieurs Odoo et certifié ISO 27001, servant des entreprises et des agences dans le monde entier.