Ir al contenido

La impresión de PDF congela Odoo: el bloqueo de workers y la solución

La impresión de PDF congela Odoo: el bloqueo de workers y la solución
Benjamin Akboka Apengu
noviembre 16, 2026 · 7 min leído

La respuesta corta

Cuando Odoo imprime un PDF, se llama a sí mismo para cargar el CSS, las fuentes y las imágenes del informe. En modo multi-worker, esa llamada necesita un segundo worker libre. Si todos los workers están ocupados imprimiendo, cada uno espera un worker que nunca se libera. Odoo se congela para todos hasta que mata esos workers, unos dos minutos después.

Hay dos soluciones. Añadir más workers, para que siempre quede uno libre. O apuntar report.url al proceso gevent de Odoo, que puede atender esas llamadas aunque todos los workers estén ocupados. La segunda solución elimina el bloqueo para siempre.

Lo que ves

  • Alguien hace clic en Imprimir y la rueda sigue girando.
  • Otros usuarios ven que Odoo deja de cargar al mismo tiempo, aunque no estén imprimiendo.
  • Después de unos dos minutos, la impresión falla, o el PDF vuelve sin diseño: sin logo, sin fuentes, con el texto apretado en una sola columna.
  • Tu log de Odoo muestra líneas como esta:
ERROR ? odoo.service.server: WorkerHTTP (12345) timeout after 120s

Suele pasar en el peor momento del día. La facturación de fin de mes, una tanda de notas de entrega, o tres personas en el mostrador imprimiendo tickets a la vez.

Por qué pasa

Con workers por encima de 0, Odoo ejecuta un número fijo de workers HTTP. Cada uno atiende una petición cada vez.

Una impresión de PDF funciona así:

  1. Un worker recibe la petición de impresión. Construye el informe en HTML.
  2. Pasa el HTML a wkhtmltopdf y espera.
  3. wkhtmltopdf abre el HTML y carga el CSS, las fuentes y las imágenes enlazadas. Las carga desde Odoo, por HTTP, en la dirección del parámetro del sistema report.url. Si no existe, usa web.base.url.
  4. Esas peticiones HTTP también necesitan un worker.

Así que una impresión necesita dos workers: uno que espera y otro que sirve los archivos. Supón que tienes 3 workers y 3 personas imprimen en el mismo momento. Los 3 workers esperan a wkhtmltopdf. wkhtmltopdf espera un worker. Nada se mueve.

Odoo pone un límite de tiempo a cada petición, limit_time_real, de 120 segundos por defecto. Cuando se acaba, Odoo mata los workers atascados y arranca otros nuevos. Ese es el "timeout after 120s" de tu log, y por eso el bloqueo dura unos dos minutos.

Las acciones planificadas que envían facturas por correo también imprimen PDF. No usan un worker HTTP para la impresión en sí, pero sus llamadas de wkhtmltopdf sí necesitan uno. Así que una tanda grande de facturas por correo alarga la cola.

Si ejecutas Odoo con workers = 0 (un solo proceso con hilos), esto no pasa. Ese modo atiende peticiones a la vez. Pero es demasiado lento para un equipo en producción, así que la mayoría de las instalaciones con este problema no deberían volver a él.

Comprueba que este es tu problema

Busca timeouts de workers en el log:

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

En Docker:

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

Luego mira cuántos workers tienes:

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

Si los timeouts coinciden con momentos en que la gente imprimía, y tienes pocos workers (de 2 a 4 es lo normal), es muy probable que esta sea la causa.

Solución 1: añadir más workers

Ten más workers que el número de PDF que se imprimen en el mismo momento, con espacio para todos los demás que usan Odoo. Si tres personas pueden imprimir a la vez y otras cinco trabajan en Odoo, 3 workers no bastan.

[options]
workers = 6

Reinicia Odoo después del cambio.

Esto funciona, pero tiene límites. Cada worker usa memoria, así que la RAM de tu servidor limita cuántos puedes tener. Nuestra guía sobre cuántos workers de Odoo necesitas muestra cómo calcularlo. Y solo mueve la línea. En un día con mucho trabajo, suficientes impresiones a la vez lo vuelven a bloquear.

Solución 2: enviar wkhtmltopdf al proceso gevent

En modo multi-worker, Odoo también arranca un proceso gevent en gevent_port (8072 por defecto). Casi todos lo conocen como el puerto websocket del chat y las notificaciones. Pero sirve toda la aplicación Odoo, y puede atender muchas peticiones a la vez. Si wkhtmltopdf carga sus archivos desde ahí, nunca espera un worker HTTP. El bloqueo ya no puede pasar.

Paso 1: comprueba que gevent responde

El proceso gevent solo se ejecuta si workers está por encima de 0. En el servidor, o dentro del contenedor de Odoo:

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

Quieres ver 200 y nada más. Si la conexión se rechaza, comprueba que workers está por encima de 0 y que gevent_port no tiene otro valor. En Odoo 15 y anteriores, la opción se llama longpolling_port.

Paso 2: asegúrate de que Odoo encuentra tu base de datos desde esa dirección

wkhtmltopdf va a llamar a 127.0.0.1, no a tu dominio. Si tu dbfilter usa %d o %h, Odoo elige la base de datos según el nombre de dominio, y 127.0.0.1 no coincide con ninguna. El PDF sale entonces sin diseño.

Si la prueba del paso 1 redirigió a /web/database/selector, o devolvió un error, este es el motivo. Con una sola base de datos por Odoo, pon su nombre en el filtro:

[options]
dbfilter = ^tu_base$

Reinicia Odoo y vuelve a hacer la prueba del paso 1.

Si un mismo Odoo sirve varias bases de datos elegidas por dominio, esta solución no encaja tal cual. Usa la solución 1 en ese caso.

Paso 3: configura report.url

En Odoo, activa el modo desarrollador. Ve a Ajustes, luego Técnico, luego Parámetros del sistema. Crea uno nuevo:

  • Clave: report.url
  • Valor: http://127.0.0.1:8072

O desde la línea de comandos:

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

Odoo usa report.url solo para cargar archivos mientras imprime. Los enlaces dentro de tus PDF, como el enlace a una factura en el portal de clientes, siguen usando tu dominio real.

Paso 4: pruébalo

Imprime una factura. Debe verse igual que antes, con tu logo y tus fuentes.

Luego intenta romperlo. Abre tantas pestañas como workers tengas, e imprime un PDF en cada una en el mismo momento. Antes de la solución, esto congelaba Odoo dos minutos. Después, cada PDF vuelve.

Si ahora un PDF sale sin diseño, vuelve al paso 2. Odoo no encontró tu base de datos desde 127.0.0.1.

¿Qué solución usar?

Las dos. La solución 2 elimina el bloqueo. La solución 1 sigue decidiendo lo rápido que va Odoo cuando mucha gente lo usa, porque cada impresión ocupa un worker mientras espera. Con la solución 2 en marcha, pocos workers significa imprimir lento, no un Odoo congelado.

Ten en cuenta el paso 2 cuando copies producción a staging, o restaures una copia de seguridad con otro nombre de base de datos. El dbfilter y el report.url tienen que encajar con la nueva instalación, o la impresión falla en la copia.

Cómo lo resuelve Skysize

En Skysize, esto ya está configurado. Cada Odoo con más de un worker imprime a través del proceso gevent, y el ajuste se vuelve a comprobar después de cada despliegue, restauración y copia a staging. Imprimir no puede bloquear tu Odoo, y no tienes que recordar ninguno de estos pasos.

Funciona igual en nuestro hosting gestionado de Odoo, en tu propio servidor y dentro de tu propia red, para Community y Enterprise.

Skysize está hecho por ex ingenieros de Odoo y tiene la certificación ISO 27001.

Pruébalo con tu propia base de datos en la prueba gratis de 7 días. Sin tarjeta.

Habla con un experto en hosting de Odoo

Preguntas frecuentes

¿Por qué Odoo se congela cuando varias personas imprimen a la vez? Cada impresión de PDF ocupa un worker y necesita otro para servir su CSS, sus fuentes y sus imágenes. Cuando todos los workers están imprimiendo, ninguno está libre para servir esos archivos, y todos esperan hasta que Odoo los mata a los 120 segundos.

¿Por qué mi PDF de Odoo sale sin estilos ni logo? wkhtmltopdf no pudo cargar el CSS y las imágenes del informe desde Odoo. O no había ningún worker libre para servirlos, o la dirección de report.url (o de web.base.url) no llega a tu base de datos. Revisa las dos cosas.

¿Qué es report.url en Odoo? Un parámetro del sistema que le dice a Odoo desde dónde debe cargar wkhtmltopdf los archivos del informe. Si no existe, Odoo usa web.base.url. Odoo no lo usa para nada más.

¿Qué puerto usa el proceso gevent de Odoo? El 8072 por defecto, configurado con gevent_port (longpolling_port en Odoo 15 y anteriores). Solo se ejecuta si workers está por encima de 0.

¿Basta con subir limit_time_real? No. Un límite más largo hace que el bloqueo dure más. Los workers se están esperando entre sí, no trabajando despacio.

La impresión de PDF congela Odoo: el bloqueo de workers y la solución
Benjamin Akboka Apengu
Escribe sobre la infraestructura de Odoo en Skysize, un proveedor de hosting de Odoo con sede en Bélgica, creado por exingenieros de Odoo y certificado ISO 27001, que sirve a empresas y agencias en todo el mundo.