Índice
-
Introducción
-
Por qué es importante comprender los errores en Dolibarr
-
Categorías de errores en Dolibarr
-
Error n.° 1: “Acceso prohibido” o “No tienes permiso”
-
Error n.° 2: “Módulo no encontrado” después de la actualización o instalación
-
Error n.° 3: Pantalla blanca o página en blanco
-
Error n.° 4: Falla la generación de PDF (errores TCPDF o DOMPDF)
-
Error n.° 5: Error de conexión de SQL o base de datos
-
Error n.° 6: Los trabajos cron no se ejecutan
-
Error n.° 7: Falta de coincidencia de fecha o zona horaria
-
Error n.° 8: tiempo de espera de sesión o cierre de sesión automático
-
Error n.° 9: Falla la carga o descarga de archivos
-
Error n.° 10: errores de autenticación o token de API
-
Herramientas de depuración y mejores prácticas
-
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:
-
Vaya al Inicio > Usuarios y grupos > Usuarios > [Seleccionar usuario]
-
Verificar que su grupo tenga los derechos adecuados bajo Permisos.
-
Compruebe si el módulo está habilitado en Configuración > Módulos/Aplicaciones.
-
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:
-
Compruebe si el módulo está colocado en el directorio correcto:
/htdocs/custom/[module_name]/ -
Confirme que el archivo de clase principal del módulo tenga el nombre correcto.
-
Limpiar la caché de Dolibarr mediante Admin > Herramientas > Borrar caché.
-
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:
-
Revise sus registros de errores de PHP (por ejemplo,
/var/log/php/error.log). -
Habilite la visualización de errores agregando a
htdocs/main.inc.php: -
Aumentar el límite de memoria en
php.ini: -
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:
-
Cambiar a un modelo de PDF diferente en Configuración > Diccionarios > Plantillas
-
Compruebe si hay espacios en blanco accidentales en los archivos PHP de plantilla (especialmente antes
<?phpo después?>) -
Establecer permisos correctos en
/documents/: -
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:
-
Comprobar el estado de la base de datos:
-
Abra
htdocs/conf/conf.phpy confirme el nombre de la base de datos, el usuario y la contraseña. -
Pruebe las credenciales de la base de datos manualmente a través de la CLI:
-
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.phpno accesible debido a las reglas del servidor web -
Tiempos de espera de script o errores de permisos
Soluciones:
-
Confirme la configuración de cron con:
Ejemplo de trabajo cron:
-
Asegúrese de que los permisos sean correctos en
cron.php(755 o 644). -
Revisar los registros de cron:
/var/log/syslogor/var/log/cron.log -
Usar
cronjob.class.phpregistros 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:
-
En la configuración de PHP (
php.ini), configure la zona horaria correcta: -
En Dolibarr, confirme la zona horaria en:
Inicio > Configuración > Varios > Configuración regional
-
Sincronizar la zona horaria de MySQL:
-
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:
-
In
php.ini, colocar: -
Habilite sesiones persistentes con configuraciones de ruta adecuadas.
-
Evite utilizar múltiples instalaciones de Dolibarr bajo el mismo dominio sin una separación clara de cookies.
-
Utilice el Forzar HTTPS Opción y habilitar
SameSite=Noneencabezados 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_filesizedemasiado pequeño -
Carpeta temporal no escribible
-
Restricciones de tipo MIME o límites de archivos del servidor
Soluciones:
-
Establecer permisos correctos en el
documentsdirectorio: -
In
php.ini, aumentar los límites: -
Confirme que los tipos de archivos estén permitidos en la configuración de Dolibarr (en la configuración del módulo).
-
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:
-
Confirme que la API esté habilitada en:
Inicio > Configuración > Módulos > Servicios web (API)
-
Cree un usuario técnico con los derechos de API adecuados.
-
Asegúrese de que el token se pase en el
DOLAPIKEYencabezado o parámetro de consulta. -
Utilice el formato de punto final correcto:
-
Habilitar registros de depuración de API en
conf.phpconfigurando: -
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:
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.logorphp-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.
