Dépannage
Cette page couvre les problèmes les plus courants rencontrés dans les installations auto-hébergées de Gäld et comment les résoudre. Pour la version cloud (EE), contactez le support si un problème persiste après avoir suivi ces étapes.
Le worker de file d'attente ne traite pas les tâches
Symptômes : Factures récurrentes non générées, e-mails de rappel non envoyés, export fiduciaire bloqué.
Cause : Le worker de file d'attente (Laravel Horizon ou le processus queue:work) n'est pas en cours d'exécution.
Correction :
# Vérifier le statut
sudo systemctl status gaeld-worker
# Redémarrer le worker
sudo systemctl restart gaeld-worker
# Voir les échecs récents
php artisan queue:failed
Si vous voyez des tâches échouées, relancez-les :
php artisan queue:retry all
Pour vider la liste des tâches échouées après avoir résolu le problème sous-jacent :
php artisan queue:flush
Voir Auto-hébergement pour la configuration complète du service systemd.
MeiliSearch indisponible / la recherche ne retourne aucun résultat
Symptômes : Les contacts, factures ou dépenses ne sont pas trouvables via la barre de recherche ; message d'erreur « Recherche indisponible ».
Cause : MeiliSearch n'est pas en cours d'exécution ou l'index n'a pas été peuplé.
Correction :
# Vérifier le statut de MeiliSearch
sudo systemctl status meilisearch
# Redémarrer MeiliSearch
sudo systemctl restart meilisearch
# Réindexer toutes les données (exécuter depuis le répertoire de l'application)
php artisan scout:import "App\Domains\Invoicing\Models\Invoice"
php artisan scout:import "App\Domains\Contacts\Models\Contact"
php artisan scout:import "App\Domains\Expenses\Models\Expense"
Si MeiliSearch est indisponible, Gäld bascule automatiquement sur la recherche en base de données. Les résultats peuvent être plus lents et moins approximatifs, mais l'application continue de fonctionner.
L'import CAMT.053 échoue ou ne produit aucune transaction
Symptômes : Le téléchargement d'un relevé bancaire produit une erreur ou importe 0 transaction.
Causes courantes et corrections :
| Cause | Correction |
|---|---|
| Le fichier n'est pas un XML CAMT.053 valide | Vérifiez l'extension du fichier et confirmez que votre banque exporte du CAMT.053, pas du CAMT.054 ou MT940 |
| Le fichier contient des transactions pour un autre IBAN | Ajoutez cet IBAN comme compte bancaire dans Paramètres → Comptes bancaires, puis réimportez |
| Le fichier a déjà été importé | Gäld détecte les doublons par hash de fichier — téléchargez un nouvel export depuis votre banque couvrant une plage de dates différente |
| Le XML est malformé | Ouvrez le fichier dans un éditeur de texte et vérifiez qu'il commence par <?xml et contient <Document> |
Si l'erreur persiste, conservez le fichier et contactez le support — incluez le message d'erreur affiché par Gäld.
Le PDF de facture ne se génère pas / le téléchargement est vide
Symptômes : Cliquer sur Télécharger le PDF sur une facture finalisée produit une page blanche ou une erreur.
Cause : Généralement un problème de configuration TCPDF ou une police manquante.
Correction :
- Vérifiez le journal applicatif pour les erreurs PDF :
tail -n 50 storage/logs/laravel.log | grep -i pdf
- Assurez-vous que le répertoire
storage/est accessible en écriture :
chmod -R 775 storage/
chown -R www-data:www-data storage/
- Exécutez les commandes artisan post-installation :
php artisan storage:link
php artisan config:clear
php artisan cache:clear
Les e-mails ne sont pas envoyés (invitations, rappels, fiches de paie)
Symptômes : Les utilisateurs invités ne reçoivent pas les e-mails d'invitation ; les rappels de paiement ne sont pas délivrés.
Cause : La configuration d'envoi d'e-mails est incorrecte ou le worker de file d'attente n'est pas en cours d'exécution.
Correction :
- Vérifiez Paramètres → E-mail pour votre configuration SMTP (hôte, port, identifiant, mot de passe, chiffrement)
- Cliquez sur Envoyer un e-mail de test pour vérifier la connexion
- Vérifiez que le worker de file d'attente est en cours d'exécution (voir ci-dessus)
- Consultez
storage/logs/laravel.logpour les erreurs SMTP :
grep -i "swift\|smtp\|mail" storage/logs/laravel.log | tail -20
Paramètres SMTP courants pour les fournisseurs suisses :
| Fournisseur | Hôte | Port | Chiffrement |
|---|---|---|---|
| Infomaniak | mail.infomaniak.com | 587 | STARTTLS |
| Hostpoint | mail.hostpoint.ch | 587 | STARTTLS |
| GMX | mail.gmx.net | 587 | STARTTLS |
| Mailgun | smtp.mailgun.org | 587 | STARTTLS |
« Ces identifiants ne correspondent à aucun compte » à la connexion
Symptômes : Impossible de se connecter malgré la saisie de l'e-mail et du mot de passe corrects.
Causes possibles :
- Le mot de passe a été modifié par un autre admin
- La 2FA est activée et vous ne saisissez pas le code TOTP
- Le compte est sur le sous-domaine d'une autre organisation
Correction :
- Utilisez Mot de passe oublié sur la page de connexion
- Si la 2FA est le problème et que vous avez perdu votre appareil, utilisez un code de récupération (émis lors de l'activation de la 2FA)
- Si vous n'avez pas de codes de récupération, le Propriétaire de votre organisation doit désactiver la 2FA pour votre compte sous Paramètres → Utilisateurs → [votre nom] → Désactiver la 2FA
La clôture annuelle est grisée / indisponible
Symptômes : Le bouton Clôture annuelle dans Comptabilité n'est pas cliquable.
Cause : Un ou plusieurs contrôles préalables n'ont pas été satisfaits. Gäld exige :
- Aucune transaction bancaire non réconciliée pour l'exercice fiscal
- Aucune facture en statut Brouillon avec une date dans l'exercice fiscal
- L'utilisateur actuel a le rôle Propriétaire ou Admin
Correction :
- Allez dans Banque → Réconciliation et soldez tous les éléments non réconciliés
- Allez dans Factures et finalisez ou annulez tous les brouillons datés de l'année de clôture
- Vérifiez votre rôle dans Paramètres → Utilisateurs
Commandes Artisan (référence rapide auto-hébergement)
# Vider tous les caches
php artisan optimize:clear
# Relancer les migrations (peut être exécuté plusieurs fois)
php artisan migrate
# Vérifier le statut de l'application
php artisan about
# Réindexer la recherche
php artisan scout:import "App\Domains\Invoicing\Models\Invoice"