Índice

  1. Introducción

  2. ¿Por qué ocurren errores después de una actualización?

  3. Mejores prácticas para evitar fallos de actualización

  4. Error 500 - Error Interno del Servidor

  5. Pantalla en blanco después de iniciar sesión

  6. Módulo no mostrado o faltante

  7. Generación de PDF dañado

  8. Problemas de idioma o traducción

  9. Distorsión del tema/diseño o iconos faltantes

  10. Problemas de permisos posteriores a la actualización

  11. Conflictos de migración de bases de datos

  12. Configuraciones erróneas de Conf.php

  13. Errores de acceso y reescritura de Apache/Nginx

  14. Funciones obsoletas en módulos personalizados

  15. Incompatibilidad de módulos externos

  16. Registros de errores: dónde encontrarlos y cómo leerlos

  17. Estrategia de depuración paso a paso

  18. Revertir a una versión funcional anterior

  19. Informar errores a la comunidad de Dolibarr

  20. Conclusión


1. Introducción

Actualizar Dolibarr puede ser un proceso sencillo si se planifica bien, pero en muchos casos, los problemas posteriores a la actualización interrumpen los flujos de trabajo. Ya sea que se trate de pantallas en blanco, errores de acceso o archivos PDF dañados, esta guía le ayuda a resolver problemas comunes y a estabilizar su instancia de ERP/CRM.


2. ¿Por qué ocurren errores después de una actualización?

Las causas típicas incluyen:

  • Reemplazo de archivo incompleto

  • Módulos/temas antiguos incompatibles con la nueva estructura

  • Los scripts de actualización de la base de datos no se ejecutan completamente

  • Entorno de servidor mal configurado (versión PHP, extensiones)

  • Configuraciones en caché que causan problemas de interfaz de usuario

Comprender la causa raíz ayuda a resolver los problemas más rápidamente.


3. Mejores prácticas para evitar fallos de actualización

Antes de actualizar:

  • Haga una copia de seguridad de todo (base de datos y sistema de archivos)

  • Actualizar primero en un servidor de prueba

  • Deshabilitar módulos no esenciales

  • Busque problemas conocidos en GitHub o foros

  • Lea el registro de cambios y las notas de la versión

Nunca actualice directamente en una instancia de producción sin probarla.


4. Error 500: Error interno del servidor

Este es un error general. Posibles causas:

  • Permisos de archivo incorrectos (chmod)

  • Errores de sintaxis en archivos PHP personalizados

  • Módulos de terceros incompatibles

Solución:

  • Consulte los registros de errores del servidor web (/var/log/apache2/error.log)

  • Establecer permisos de archivo a 644 y carpetas a 755

  • Deshabilite temporalmente todos los módulos personalizados y vuelva a intentarlo


5. Pantalla en blanco después de iniciar sesión

Causas comunes:

  • Error de PHP suprimido (display_errors = Off)

  • Archivos de sesión o caché dañados

Solución:

  • Habilitar informes de errores en conf.php

ini_set('display_errors', 1);
error_reporting(E_ALL);
  • Limpiar la caché del navegador y la carpeta de caché de Dolibarr /documents/temp


6. Módulo no mostrado o faltante

Sintomas:

  • Un módulo que anteriormente estaba activo ya no está

Solución:

  • Vaya al Configuración > Módulos y volver a habilitarlo

  • Si es personalizado, verifique que esté ubicado en /custom/module/

  • Comprobar compatibilidad con la versión actual de Dolibarr


7. Generación de PDF defectuosa

Sintomas:

  • Las salidas PDF están en blanco o malformadas

Solución:

  • Comprobar si faltan bibliotecas TCPDF

  • Asegúrese de que /documents/ tiene permisos de escritura adecuados

  • Confirmar archivos de idioma (langs/) no están dañados

Inspeccione también la lógica de la plantilla personalizada para detectar funciones TCPDF obsoletas.


8. Problemas de idioma o traducción

Sintomas:

  • Interfaz no traducida o se muestra un galimatías

Solución:

  • Comprobar problemas de codificación UTF-8

  • Vuelva a guardar los archivos de idioma con la codificación adecuada

  • Verificar que la carpeta de traducciones exista en /htdocs/langs/

  • Usar Configuración > Traducción > Reconstruir diccionario


9. Distorsión del tema/diseño o iconos faltantes

Sintomas:

  • El diseño parece roto después de la actualización

  • Faltan iconos

Solución:

  • Borrar caché del navegador

  • Volver a un tema compatible como Oblyon

  • Comprueba las rutas de carga de archivos CSS/JS en las herramientas de desarrollo del navegador

  • Asegúrese de que no se hayan perdido ni dañado archivos CSS personalizados


10. Problemas de permisos posteriores a la actualización

Sintomas:

  • Los usuarios ven "Acceso denegado" en los módulos a los que accedieron anteriormente

Solución:

  • Restablecer permisos de usuario en Usuarios y grupos > Permisos

  • Comprobar la herencia del grupo de usuarios

  • Comparar la estructura de permisos del módulo antiguo y el nuevo


11. Conflictos de migración de bases de datos

Sintomas:

  • Error al cargar páginas que hacen referencia a tablas o columnas faltantes

Solución:

  • Vuelva a ejecutar el asistente de actualización en /install/

  • Comparar esquemas usando herramientas como phpMyAdmin

  • Aplicar manualmente los cambios faltantes de install/mysql/upgrade guiones


12. Configuraciones erróneas de Conf.php

Sintomas:

  • Dolibarr no se carga en absoluto

Solución:

  • Comprobar $dolibarr_main_url_root, $dolibarr_main_document_root y líneas de conexión DB

  • Asegúrese de que las comillas sean correctas y que no haya espacios finales.


13. Errores de reescritura y acceso de Apache/Nginx

Sintomas:

  • Error 404 o 403 al acceder a los módulos

Solución:

  • Asegúrese de que .htaccess está intacto (Apache)

  • Confirmar que mod_rewrite esté habilitado

  • Para Nginx, actualice las reglas de reescritura según corresponda


14. Funciones obsoletas en módulos personalizados

Sintomas:

  • Los registros muestran advertencias o fallas debido a código obsoleto

Solución:

  • Compare el código de su módulo con la lógica central actualizada

  • Reemplazar llamadas de funciones obsoletas

  • Lea las notas de migración en las versiones de GitHub de Dolibarr


15. Incompatibilidad de módulos externos

Sintomas:

  • Los módulos de Dolistore ya no funcionan

Solución:

  • Consulte el sitio del proveedor para obtener una versión actualizada

  • Comuníquese con el autor del módulo para obtener ayuda

  • Desactivar el módulo temporalmente


16. Registros de errores: dónde encontrarlos y cómo leerlos

  • APACHE: /var/log/apache2/error.log

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

  • PHP: /var/log/php_errors.log

  • Dolibarr: /documents/admin/system.log (si está habilitado)

Lea siempre de abajo a arriba para conocer los últimos acontecimientos.


17. Estrategia de depuración paso a paso

  1. Activar el informe de errores en conf.php

  2. Aislar el problema (¿qué módulo, usuario, archivo?)

  3. Comprobar los registros del servidor web y de Dolibarr

  4. Deshabilitar módulos no esenciales

  5. Revertir a una copia de seguridad si es necesario

No se asuste: la mayoría de los problemas pueden resolverse siguiendo pasos metódicos.


18. Revertir a una versión funcional anterior

Si todo falla:

  • Restaure su última copia de seguridad tanto de la base de datos como de los archivos

  • Bajar de categoría solo si es absolutamente necesario

  • Documente qué causó la actualización fallida

Utilice la función de reversión solo cuando esté atascado y planifique volver a intentarlo después de la depuración.


19. Informar errores a la comunidad de Dolibarr

Si encuentra un error genuino:

Los informes claros aumentan sus posibilidades de obtener ayuda rápidamente.


20. Conclusión

Los errores posteriores a las actualizaciones son comunes, pero controlables. Con un registro claro, copias de seguridad y un enfoque sistemático de depuración, la mayoría de los problemas se pueden resolver rápidamente. Utilice entornos de prueba, mantenga actualizados los módulos de terceros y aporte correcciones para fortalecer la comunidad.