Índice

  1. Introducción

  2. Por qué es importante comprender los errores en Dolibarr

  3. Categorías de errores en Dolibarr

  4. Error n.° 1: “Acceso prohibido” o “No tienes permiso”

  5. Error n.° 2: “Módulo no encontrado” después de la actualización o instalación

  6. Error n.° 3: Pantalla blanca o página en blanco

  7. Error n.° 4: Falla la generación de PDF (errores TCPDF o DOMPDF)

  8. Error n.° 5: Error de conexión de SQL o base de datos

  9. Error n.° 6: Los trabajos cron no se ejecutan

  10. Error n.° 7: Falta de coincidencia de fecha o zona horaria

  11. Error n.° 8: tiempo de espera de sesión o cierre de sesión automático

  12. Error n.° 9: Falla la carga o descarga de archivos

  13. Error n.° 10: errores de autenticación o token de API

  14. Herramientas de depuración y mejores prácticas

  15. Conclusión


1. Introducción

Dolibarr ERP & CRM es una potente plataforma modular de código abierto diseñada para gestionar todo, desde la facturación y la contabilidad hasta los recursos humanos, el inventario y la relación con los clientes. Su simplicidad, extensibilidad y rentabilidad la han convertido en una de las opciones preferidas por pymes y autónomos de todo el mundo.

Sin embargo, como cualquier sistema web complejo, Dolibarr no es inmune a errores ocasionales, fallos y configuraciones incorrectasYa sea administrador de sistemas, desarrollador o usuario empresarial, encontrar un error puede interrumpir su flujo de trabajo y reducir su confianza en la plataforma.

Este artículo explora el Errores más frecuentes de Dolibarr, sus causas subyacentes y soluciones prácticas y rápidas. El objetivo no es solo solucionar los problemas, sino también capacitar a los usuarios para que comprendan mejor Cómo funciona Dolibarr entre bastidores.


2. Por qué es importante comprender los errores en Dolibarr

Los errores ocurren, ya sea durante la instalación, las actualizaciones, la configuración o el uso diario. Algunos errores se deben a:

  • Mala configuración del servidor

  • Problemas de permisos de archivos

  • Módulos o plantillas incompatibles

  • Desajuste de versiones de PHP o MySQL

  • Mala gestión de los derechos de acceso de los usuarios

  • Problemas de cron o caché

La clave para una resolución de problemas eficiente es reconocer la patrón de error, sabiendo donde mirar, y aplicando la solución correcta rápidamenteAprender de estos errores también ayuda a prevenir futuras incidencias, aumenta el tiempo de actividad del sistema y mejora la confianza del usuario.


3. Categorías de errores en Dolibarr

Los errores de Dolibarr generalmente se dividen en las siguientes categorías:

  • Autenticación y permisos: Denegación de acceso, problemas de inicio de sesión

  • Problemas con módulos y complementos:Archivos faltantes, versiones incompatibles

  • Interfaz de usuario y renderizado: Pantallas blancas, diseños rotos

  • Backend/ServidorErrores de PHP, límites de memoria, problemas con la base de datos

  • Cron y automatización: Tareas en segundo plano fallidas

  • Herramientas externas: Generación de PDF, carga y descarga de archivos

  • API e integración:Errores de autenticación y conexión

Exploremos ahora los errores individuales más comunes y cómo solucionarlos de manera eficiente.


4. Error n.° 1: “Acceso prohibido” o “No tienes permiso”

Sintomas:

  • Mensaje: “Acceso prohibido” o “No tienes permiso para acceder a esta página”.

  • Afecta a los usuarios habituales que intentan acceder a módulos a los que deberían tener acceso.

Causas:

  • El rol del usuario no tiene los derechos correctos asignados.

  • El módulo está deshabilitado o no se inicializó correctamente.

  • Conflicto con permisos personalizados o módulos de terceros.

Soluciones:

  1. Vaya al Inicio > Usuarios y grupos > Usuarios > [Seleccionar usuario]

  2. Verificar que su grupo tenga los derechos adecuados bajo Permisos.

  3. Compruebe si el módulo está habilitado en Configuración > Módulos/Aplicaciones.

  4. Reinicialice los permisos del módulo si se realizaron cambios personalizados.

Consejo rápido: utilice el usuario administrador para verificar el acceso y garantizar que no haya ninguna restricción global habilitada.


5. Error n.° 2: “Módulo no encontrado” después de la actualización o instalación

Sintomas:

  • Mensaje de error al acceder a una página del módulo

  • Entradas faltantes en la lista de módulos

  • Los menús desaparecen después de habilitar un módulo

Causas:

  • Estructura de carpetas de módulos incorrecta

  • La versión del módulo no es compatible con la versión actual de Dolibarr

  • Archivos descriptores de módulo faltantes o incorrectos (modXXX.class.php)

Soluciones:

  1. Compruebe si el módulo está colocado en el directorio correcto:
    /htdocs/custom/[module_name]/

  2. Confirme que el archivo de clase principal del módulo tenga el nombre correcto.

  3. Limpiar la caché de Dolibarr mediante Admin > Herramientas > Borrar caché.

  4. Si actualizó recientemente Dolibarr, actualice el módulo a una versión compatible.


6. Error n.° 3: Pantalla blanca o página en blanco

Sintomas:

  • Una pantalla completamente en blanco y sin errores.

  • Sucede después de iniciar sesión o al abrir ciertos módulos

Causas:

  • Error fatal de PHP (a menudo no se muestra debido a la configuración del servidor)

  • Agotamiento de la memoria

  • Actualización incompleta

  • Problemas de permisos de archivos

Soluciones:

  1. Revise sus registros de errores de PHP (por ejemplo, /var/log/php/error.log).

  2. Habilite la visualización de errores agregando a htdocs/main.inc.php:

    php

    ini_set('display_errors', 1); error_reporting(E_ALL);
  3. Aumentar el límite de memoria en php.ini:

    ini

    memory_limit = 512M
  4. Vuelva a cargar o reemplace los archivos faltantes o dañados.


7. Error n.° 4: Falla la generación de PDF (errores TCPDF o DOMPDF)

Sintomas:

  • Las facturas o propuestas no se generan en formato PDF

  • Archivos PDF en blanco o con formato dañado

  • Mensajes como “ERROR TCPDF: ya se han generado algunos datos” o excepciones DOMPDF

Causas:

  • Plantillas PDF corruptas

  • Salida enviada antes de los encabezados

  • Fuentes faltantes o permisos incorrectos en /documents/ directorio

  • Configuración incorrecta de DOMPDF

Soluciones:

  1. Cambiar a un modelo de PDF diferente en Configuración > Diccionarios > Plantillas

  2. Compruebe si hay espacios en blanco accidentales en los archivos PHP de plantilla (especialmente antes <?php o después ?>)

  3. Establecer permisos correctos en /documents/:

    golpear

    chmod -R 755 /dolibarr/documents/
  4. Si utiliza DOMPDF, asegúrese de que estén instaladas las fuentes y las extensiones PHP necesarias.


8. Error n.° 5: Error de conexión de SQL o base de datos

Sintomas:

  • Mensajes de “Error de conexión a la base de datos” o “Error de SQL”

  • Aparecen errores después de la migración o cambios de configuración

Causas:

  • Credenciales de base de datos incorrectas en conf.php

  • Servicio MySQL/MariaDB inactivo

  • Límites de recursos del servidor (por ejemplo, conexiones máximas)

Soluciones:

  1. Comprobar el estado de la base de datos:

    golpear

    systemctl status mysql
  2. Abra htdocs/conf/conf.php y confirme el nombre de la base de datos, el usuario y la contraseña.

  3. Pruebe las credenciales de la base de datos manualmente a través de la CLI:

    golpear

    mysql -u dolibarr_user -p
  4. Verifique los registros para detectar consultas fallidas o errores de permisos.


9. Error n.° 6: Los trabajos cron no se ejecutan

Sintomas:

  • Tareas programadas no ejecutadas

  • Los recordatorios por correo electrónico, las facturas recurrentes y las copias de seguridad no se activan

Causas:

  • Trabajo cron mal configurado

  • cron.php no accesible debido a las reglas del servidor web

  • Tiempos de espera de script o errores de permisos

Soluciones:

  1. Confirme la configuración de cron con:

    golpear

    crontab -l

    Ejemplo de trabajo cron:

    golpear

    */10 * * * * wget -qO- https://yourdomain.com/public/cron/cron.php
  2. Asegúrese de que los permisos sean correctos en cron.php (755 o 644).

  3. Revisar los registros de cron: /var/log/syslog or /var/log/cron.log

  4. Usar cronjob.class.php registros para depurar la ejecución de tareas.

10. Error n.° 7: Falta de coincidencia de fecha o zona horaria

Sintomas:

  • Fechas incorrectas en facturas, registros o entradas de calendario

  • Discrepancias entre la entrada del usuario y el almacenamiento del sistema

  • Comportamiento inesperado al exportar datos a sistemas externos

Causas:

  • Desajuste entre la zona horaria de PHP y la configuración de Dolibarr

  • El servidor utiliza UTC mientras los usuarios esperan la hora local

  • La zona horaria de MySQL no está alineada con PHP

Soluciones:

  1. En la configuración de PHP (php.ini), configure la zona horaria correcta:

    ini
    date.timezone = "Africa/Casablanca"
  2. En Dolibarr, confirme la zona horaria en:

    Inicio > Configuración > Varios > Configuración regional

  3. Sincronizar la zona horaria de MySQL:

    sql
    SET GLOBAL time_zone = 'Africa/Casablanca';
  4. Reinicie los servidores web y de base de datos para aplicar la configuración de manera consistente.


11. Error n.° 8: Tiempo de espera de sesión o cierre de sesión automático

Sintomas:

  • Los usuarios cierran sesión inesperadamente después de períodos cortos

  • Las sesiones no persisten entre cambios de pestaña

  • Los mensajes “Debes iniciar sesión nuevamente” aparecen con frecuencia

Causas:

  • Tiempo de espera de sesión corto en PHP

  • Conflictos de almacenamiento de sesiones (especialmente con múltiples usuarios)

  • Problemas de caché o cookies en el navegador

  • Varias instancias de Dolibarr en conflicto en el mismo dominio

Soluciones:

  1. In php.ini, colocar:

    ini
    session.gc_maxlifetime = 3600
  2. Habilite sesiones persistentes con configuraciones de ruta adecuadas.

  3. Evite utilizar múltiples instalaciones de Dolibarr bajo el mismo dominio sin una separación clara de cookies.

  4. Utilice el Forzar HTTPS Opción y habilitar SameSite=None encabezados si se utilizan cookies seguras en subdominios.


12. Error n.° 9: Falla la carga o descarga de archivos

Sintomas:

  • No se pueden cargar documentos, imágenes o logotipos de proveedores.

  • Las descargas dan como resultado archivos vacíos o corruptos

  • Error: “Archivo no encontrado” o “No se ha cargado ningún archivo”

Causas:

  • Permisos de archivo incorrectos en /documents/ carpeta

  • PHP upload_max_filesize demasiado pequeño

  • Carpeta temporal no escribible

  • Restricciones de tipo MIME o límites de archivos del servidor

Soluciones:

  1. Establecer permisos correctos en el documents directorio:

    golpear
    chown -R www-data:www-data /dolibarr/documents chmod -R 755 /dolibarr/documents
  2. In php.ini, aumentar los límites:

    ini
    upload_max_filesize = 20M post_max_size = 25M
  3. Confirme que los tipos de archivos estén permitidos en la configuración de Dolibarr (en la configuración del módulo).

  4. Primero pruebe cargar archivos pequeños para descartar otros problemas.


13. Error n.° 10: Errores de autenticación o token de API

Sintomas:

  • Las llamadas a la API REST devuelven "Token no autorizado" o "Token no válido".

  • Las integraciones externas no se conectan

  • Problemas de expiración de tokens después de períodos cortos

Causas:

  • Credenciales de API incorrectas

  • La autenticación basada en tokens no se implementó correctamente

  • API deshabilitada o permisos de usuario demasiado limitados

  • Rutas de URL o puntos finales desalineados

Soluciones:

  1. Confirme que la API esté habilitada en:

    Inicio > Configuración > Módulos > Servicios web (API)

  2. Cree un usuario técnico con los derechos de API adecuados.

  3. Asegúrese de que el token se pase en el DOLAPIKEY encabezado o parámetro de consulta.

  4. Utilice el formato de punto final correcto:

    rubí
    https://yourdomain.com/api/index.php/<resource>?DOLAPIKEY=xxx
  5. Habilitar registros de depuración de API en conf.php configurando:

    php
    $dolibarr_main_prod = 0;
  6. Validar que el usuario tenga acceso al módulo que está intentando consultar (por ejemplo, facturas, productos).


14. Herramientas de depuración y mejores prácticas

Para manejar errores rápidamente y reducir problemas futuros, implemente un plan proactivo. estrategia de depuración y monitoreo.

Habilitar el modo desarrollador

Agregue esto a htdocs/conf/conf.php:

php
define('DOL_DEVELOPER_MODE', true);

Esto muestra los tiempos de ejecución, las consultas SQL y el uso de memoria en la parte inferior de cada página.

Usar registros de errores

  • Registros de PHP: /var/log/php/error.log or php-fpm.log

  • Registros de Apache: /var/log/apache2/error.log

  • Registros de Nginx: /var/log/nginx/error.log

  • Registros de MySQL: /var/log/mysql/error.log

Revise estos puntos periódicamente, especialmente después de:

  • Instalaciones de módulos

  • Actualizaciones de la versión de Dolibarr

  • Reconfiguración del servidor

Utilice Git para personalizaciones

Si está modificando archivos o módulos personalizados:

  • Versionarlos con Git

  • Seguimiento de cambios antes y después de las actualizaciones

  • Revertir rápidamente si surgen errores

Crear un entorno de prueba

  • Pruebe siempre los nuevos módulos, plantillas o configuraciones en una copia de su instancia de Dolibarr

  • Utilice la puesta en escena para simular actualizaciones y encontrar funciones obsoletas

  • Utilice copias de seguridad (tanto de la base de datos como /documents/) antes de cambios importantes


15. Pensamientos finales

Los errores son parte de cualquier sistema de software, especialmente en un entorno tan personalizable y modular como DolibarrLo que distingue a una implementación exitosa no es la ausencia de errores, Pero el Capacidad de resolverlos con rapidez y confianza.

A continuación, un breve resumen de las mejores prácticas:

  • Entender la fuente¿Está relacionado con el servidor, la aplicación, los derechos de usuario o el módulo?

  • Utilizar registros y modos de depuración para obtener información significativa

  • Mantener el sistema eficiente: deshabilite los módulos no utilizados y mantenga su instalación limpia

  • Plan de crecimiento:establecer límites realistas y prepararse para más usuarios o registros

  • No temas a los errores: documéntalos e integrarlos en su estrategia de gestión de TI

Al dominar estos errores comunes y sus soluciones, reducirá el tiempo de inactividad, mejorará la satisfacción del usuario y mantendrá un Entorno Dolibarr rápido, seguro y confiable.