Le preguntamos a Gemini, la inteligencia artificial de Google cómo solucionar problemas de UVDesk en linux
Explicanos detallaente cómo solucionar problemas de UVDesk en linuxSolucionar problemas en UVDesk puede sentirse como un nivel avanzado de administración de sistemas, principalmente porque Symfony (el framework sobre el que está construido) es extremadamente estricto con la configuración. Cuando algo falla, suele lanzar errores de "Doctrine" o de "Caché" que pueden parecer jeroglíficos.
Aquí tienes el mapa de diagnóstico para reparar UVDesk en Linux y no morir en el intento.
1. Localiza al "Culpable" (Los Logs)
En UVDesk, los errores de Apache o Nginx son solo la punta del iceberg. El verdadero detalle está en los logs de Symfony.
Ruta de logs de la App: /var/www/uvdesk/var/log/
Archivos: Verás dev.log (si estás en modo desarrollo) o prod.log (en producción).
Comando útil:
Bash
tail -f /var/www/uvdesk/var/log/prod.log
[!NOTE]
Si el archivo de log no existe o está vacío, es una señal clara de que el servidor web no tiene permisos para escribir en esa carpeta.
2. El "Clásico de Symfony": Permisos de Escritura
UVDesk necesita escribir constantemente en var/cache, var/log y public/uploads. Si la interfaz se queda en blanco o los cambios no se guardan, los permisos son el primer sospechoso.
La solución definitiva:
Ejecuta estos comandos (asumiendo que tu usuario web es www-data):
Bash
sudo chown -R www-data:www-data /var/www/uvdesk
sudo find /var/www/uvdesk -type d -exec chmod 775 {} \;
sudo find /var/www/uvdesk -type f -exec chmod 644 {} \;
# Específicos para Symfony
sudo chmod -R 777 /var/www/uvdesk/var
sudo chmod -R 777 /var/www/uvdesk/public/uploads
3. Errores de Conexión a Base de Datos (Doctrine)
Si ves un error que menciona "Doctrine" o "Connection Refused", el problema está en tu archivo de configuración ambiental.
Archivo: /var/www/uvdesk/.env
Busca la línea: DATABASE_URL="mysql://usuario:password@127.0.0.1:3306/uvdesk"
Cosas que revisar:
Que el usuario y password sean correctos.
Que el servidor de base de datos (MariaDB/MySQL) esté corriendo: sudo systemctl status mariadb.
Si usas caracteres especiales en la contraseña, asegúrate de que estén codificados para URL.
4. El "Fantasma" de Mailparse
Este es el problema más específico de UVDesk. Para que el sistema pueda "leer" los correos entrantes y convertirlos en tickets, necesita la extensión mailparse de PHP.
Cómo verificarlo: php -m | grep mailparse
Si no aparece:
Bash
sudo apt install php-dev php-pear -y
sudo pecl install mailparse
# Luego habilítalo en tu php.ini y reinicia Apache/PHP-FPM
5. Limpieza de Caché (El "Reset" Maestro)
A veces, UVDesk se queda "atascado" con una configuración vieja. En Symfony, borrar la caché manualmente suele solucionar comportamientos erráticos.
Desde la carpeta raíz de UVDesk, ejecuta:
Bash
sudo -u www-data php bin/console cache:clear --env=prod
sudo -u www-data php bin/console cache:warmup --env=prod
6. Los Tickets no se actualizan (Cron Jobs)
Si los tickets se crean pero las notificaciones no salen o el buzón no se refresca solo, el sistema de tareas programadas ha fallado.
Verifica el Cron: sudo crontab -u www-data -l
Asegúrate de tener la tarea de refresco:
Bash
* * * * * php /var/www/uvdesk/bin/console uvdesk:refresh-mailbox
Tabla de Errores Comunes
UVDesk es una herramienta poderosa, pero su arquitectura basada en componentes significa que si una pequeña pieza (como el SwiftMailer o el Mailbox bundle) está mal configurada, todo el flujo se detiene. Mi consejo: Nunca hagas cambios directamente en el código del "vendor"; usa siempre el archivo .env y los comandos de la consola de Symfony (bin/console).
¿Te está lanzando algún error específico de "Internal Server Error" o el problema es que no logra conectar con tu cuenta de correo corporativa?