Solucion de Problemas¶

Guia para resolver problemas comunes.

Errores de Conexión¶

502 Bad Gateway¶

Causa: Traefik no puede conectar con Odoo.

Solucion:

# Verificar contenedores
docker compose ps

# Si Odoo no esta running
docker compose logs odoo
docker compose restart odoo

No se puede acceder al sitio¶

Verificar:

Dominio apunta al servidor correcto
Puertos 80/443 abiertos en firewall
Contenedores corriendo

# Verificar puertos
netstat -tlnp | grep -E "80|443"

# Verificar contenedores
docker compose ps

Errores de Base de Datos¶

Database connection failed¶

Causa: Odoo no puede conectar a PostgreSQL.

Solucion:

# Verificar PostgreSQL
docker compose ps postgresql
docker compose logs postgresql

# Probar conexión
docker compose exec odoo pg_isready -h postgresql -U odoo

No database selected¶

Causa: dbfilter no esta configurado.

Verificar:

# Ver configuración
docker compose exec odoo cat /etc/odoo/odoo.conf | grep dbfilter

# Debe mostrar:
# dbfilter = odoo_full3d

Errores de SSL¶

Certificate not valid¶

Causa: Certificado no generado aun.

Solucion:

# Verificar permisos
ls -la config/acme.json
# Debe ser: -rw------- (600)

# Verificar logs de Traefik
docker compose logs traefik | grep -i acme

Let's Encrypt rate limit¶

Causa: Demasiados intentos fallidos.

Solucion: Esperar 1 hora y reintentar.

Errores de Módulos¶

Module not found¶

Causa: Addon no esta en la ruta correcta.

Verificar:

ls -la addons/extra/
ls -la addons/custom/

View error after update¶

Causa: Cache de vistas obsoleto.

Solucion:

# Limpiar cache de vistas
docker compose exec postgresql psql -U odoo -d odoo_full3d -c \
  "DELETE FROM ir_ui_view WHERE name LIKE '%full3d%';"

# Reinstalar módulo
docker compose run --rm odoo odoo -d odoo_full3d -i full3d_repairs --stop-after-init
docker compose restart odoo

Field does not exist¶

Causa: Modelo cambio pero DB no actualizada.

Solucion:

docker compose run --rm odoo odoo -d odoo_full3d -u full3d_repairs --stop-after-init
docker compose restart odoo

Errores de Performance¶

Sitio lento¶

Verificar:

# Uso de recursos
docker stats

# Espacio en disco
df -h

Soluciones:

Aumentar workers en odoo.conf.template
Limpiar logs antiguos
Ejecutar vacuum en PostgreSQL

Out of memory¶

Causa: Workers exceden memoria.

Solucion:

Ajustar en config/odoo.conf.template:

workers = 2
limit_memory_soft = 2147483648
limit_memory_hard = 3221225472

Errores de Backup¶

Backup failed¶

Verificar:

# Ver log
tail -50 /var/log/odoo-backup.log

Causas comunes:

Disco lleno
PostgreSQL no responde
Permisos incorrectos

Restore failed¶

Verificar:

Archivo de backup existe y no corrupto
Suficiente espacio en disco
PostgreSQL corriendo

Comandos de Diagnóstico¶

Ver logs en tiempo real¶

docker compose logs -f odoo
docker compose logs -f postgresql
docker compose logs -f traefik

Ver uso de recursos¶

docker stats

Ver espacio en disco¶

df -h
du -sh data/*

Verificar conexión a DB¶

docker compose exec odoo pg_isready -h postgresql -U odoo

Ver configuración actual¶

docker compose exec odoo cat /etc/odoo/odoo.conf

Reinicio Completo¶

Si nada funcióna:

# Detener todo
docker compose down

# Verificar qué no hay contenedores huérfanos
docker ps -a

# Iniciar de nuevo
docker compose up -d

# Ver logs
docker compose logs -f

Contactar Soporte¶

Si el problema persiste:

Recopilar logs relevantes
Documentar pasos para reproducir
Anotar cuándo empezo el problema
Contactar al equipo de desarrollo