Erreurs courantes
Erreurs HTTP
401 Unauthorized
| Symptôme | Les demandes API renvoient 401, ou l'interface vous redirige vers la page de connexion de manière inattendue |
| Cause | Votre session OAuth2 a expiré ou le jeton n'est pas valide |
| Correction | Déconnectez-vous et reconnectez-vous. Si le problème persiste après reconnexion, videz les cookies du navigateur et le localStorage pour le domaine OpSee, puis reconnectez-vous. Voir Problèmes de connexion pour plus de détails. |
403 Forbidden
| Symptôme | La page se charge mais les données n'apparaissent pas, ou une action renvoie une erreur 403 |
| Cause | Votre compte Keycloak n'a pas le rôle requis pour cette ressource |
| Correction | Contactez votre administrateur Keycloak pour vérifier vos attributions de rôles. Vérifiez vos rôles actuels dans Profil → Rôles et permissions. Rôles courants nécessaires : menu:production, equipment:view, menu:admin. |
404 Not Found
| Symptôme | Une page ou un point de terminaison API renvoie 404 |
| Cause | L'URL n'existe pas (typo, signet obsolète) ou le module n'est pas déployé dans cette instance |
| Correction | Accédez à la page depuis le menu principal. Si l'élément de menu lui-même est absent, la fonctionnalité peut ne pas être activée dans votre déploiement. Contactez votre administrateur. |
500 Internal Server Error
| Symptôme | Une action échoue avec un message d'erreur générique du serveur |
| Cause | Une exception non traitée dans l'API du serveur principal |
| Correction | Vérifiez les journaux du conteneur principal (docker logs opsee-fastapi). Si l'erreur est reproductible, notez l'action exacte qui la déclenche et signalez-la à votre administrateur avec l'horodatage pour qu'il puisse corréler l'entrée du journal. |
502 Bad Gateway / 503 Service Unavailable
| Symptôme | L'application entière affiche une page d'erreur 502 ou 503 |
| Cause | Le service principal ou l'une de ses dépendances (base de données, Keycloak) est arrêté ou n'a pas encore démarré |
| Correction | Exécutez docker ps sur le serveur pour voir quels conteneurs s'exécutent. Redémarrez les conteneurs arrêtés avec docker compose up -d. Si la base de données est le problème, vérifiez l'épuisement de l'espace disque ou les erreurs de limite de connexion. |
Erreurs réseau
« Impossible de se connecter » / Erreur réseau
| Symptôme | Les appels API échouent avec une erreur réseau dans la console du navigateur ; aucun code d'état HTTP n'est renvoyé |
| Cause | Le conteneur principal OpSee n'est pas en cours d'exécution, ou le proxy inverse NGINX ne peut pas l'atteindre |
| Correction | Vérifiez que les conteneurs Docker sont en cours d'exécution : docker ps. Si le conteneur principal a quitté, inspectez ses journaux avec docker logs opsee-fastapi. Redémarrez avec docker compose up -d. |
Erreurs de validation de formulaire
Champ obligatoire / format invalide
| Symptôme | Un formulaire refuse de se soumettre et met en surbrillance les champs en rouge |
| Cause | Un champ obligatoire est vide, une valeur ne correspond pas au format attendu (par exemple, un champ de date contient du texte) ou l'entrée dépasse la longueur maximale |
| Correction | Remplissez tous les champs en surbrillance. Prêtez attention aux indices de format affichés sous chaque champ. |
Entrée en double
| Symptôme | Le formulaire se soumet mais renvoie une erreur comme « existe déjà » ou « clé en doublon » |
| Cause | Un enregistrement avec le même identifiant unique (nom, code, etc.) existe déjà dans la base de données |
| Correction | Utilisez une valeur différente pour le champ unique, ou modifiez l'enregistrement existant au lieu d'en créer un nouveau. |