Índice
-
Introducción
-
¿Por qué ocurren errores después de una actualización?
-
Mejores prácticas para evitar fallos de actualización
-
Error 500 - Error Interno del Servidor
-
Pantalla en blanco después de iniciar sesión
-
Módulo no mostrado o faltante
-
Generación de PDF dañado
-
Problemas de idioma o traducción
-
Distorsión del tema/diseño o iconos faltantes
-
Problemas de permisos posteriores a la actualización
-
Conflictos de migración de bases de datos
-
Configuraciones erróneas de Conf.php
-
Errores de acceso y reescritura de Apache/Nginx
-
Funciones obsoletas en módulos personalizados
-
Incompatibilidad de módulos externos
-
Registros de errores: dónde encontrarlos y cómo leerlos
-
Estrategia de depuración paso a paso
-
Revertir a una versión funcional anterior
-
Informar errores a la comunidad de Dolibarr
-
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
644y carpetas a755 -
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/upgradeguiones
12. Configuraciones erróneas de Conf.php
Sintomas:
-
Dolibarr no se carga en absoluto
Solución:
-
Comprobar
$dolibarr_main_url_root,$dolibarr_main_document_rooty 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
.htaccessestá 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
-
Activar el informe de errores en
conf.php -
Aislar el problema (¿qué módulo, usuario, archivo?)
-
Comprobar los registros del servidor web y de Dolibarr
-
Deshabilitar módulos no esenciales
-
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:
-
Busque en la Problemas de GitHub con Dolibarr
-
Envíe un nuevo problema con:
-
Tu versión
-
pasos para reproducir
-
Registros o capturas de pantalla
-
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.
