Dépannage

Résolution des problèmes courants : API, CORS, Traccar, auth, e-mail.

Sur cette pageAfficher

Vérifier la santé système

GET /api/health doit retourner status=UP avec détails :

  • database : UP — PostgreSQL ou H2 accessible
  • traccarConnected : true — Traccar répond sur TRACCAR_URL
  • apiAuthRequired : true/false — clé API obligatoire ?
  • userAuthEnabled : true/false — login JWT activé ?

Script complet : ./scripts/smoke-test-local.sh (48+ checks avec auth).

VPS : ./scripts/verify-vps.sh

Erreurs CORS

Symptôme : « blocked by CORS policy » dans la console navigateur.

  1. 1Identifier l'origine exacte (ex. http://localhost:3290)
  2. 2Ajouter à CORS_ORIGINS dans .env ou trakcar.env
  3. 3Inclure https://www.fleetyapp.com et https://fleetyapp.com en prod
  4. 4Redémarrer trakcar-api : systemctl restart trakcar-api

Traccar indisponible

  • Vérifier TRACCAR_URL et TRACCAR_TOKEN dans /var/www/fleetyapp/trakcar-api/trakcar.env
  • UI admin : http://VPS:3290 — créer compte admin + token
  • Boîtier GT06 : port 5023 ouvert (ufw allow 5023)
  • PostgreSQL traccar : role login autorisé (fix-postgres.sql)
  • Sans Traccar : mocks en dev, WebSocket silencieux, badge rouge Paramètres GPS

Connexion impossible

SymptômeCauseSolution
Mode démo, pas de loginVITE_API_URL absentConfigurer web/.env
Redirect /connectapiAuthRequired sans cléSaisir clé ou config.js
Redirect /loginuserAuthEnabled sans sessionSe connecter admin@trakcar.local
401 invalid credentialsMauvais mot de passeReset via admin ou dev seed
Session expiréeJWT expiréReconnecter — toast « Session expirée »

E-mails non envoyés

  1. 1Vérifier MAIL_HOST, MAIL_USERNAME, MAIL_PASSWORD, MAIL_FROM=support@fleetyapp.com
  2. 2Consulter /api/notifications/recent — statut simulated = SMTP absent
  3. 3Tester invitation utilisateur depuis Paramètres
  4. 4Vérifier logs : journalctl -u trakcar-api -n 50

Contacter le support

Si le problème persiste, contactez support@fleetyapp.com avec :

  • Résultat de GET /api/health (JSON)
  • URL et navigateur utilisés
  • Capture d'écran de l'erreur console
  • Version déployée et environnement (dev/prod)