Veelvoorkomende Fouten
HTTP-fouten
401 Unauthorized
| Symptoom | API-verzoeken geven 401 terug, of de UI stuurt onverwacht door naar de inlogpagina |
| Oorzaak | Uw OAuth2-sessie is verlopen of het token is ongeldig |
| Oplossing | Log uit en log opnieuw in. Als het probleem aanhoudt na opnieuw inloggen, wis de browsercookies en localStorage voor het OpSee-domein en log opnieuw in. Zie Inlogproblemen voor meer details. |
403 Forbidden
| Symptoom | De pagina laadt maar gegevens verschijnen niet, of een actie geeft een 403-fout terug |
| Oorzaak | Uw Keycloak-account heeft niet de vereiste rol voor deze bron |
| Oplossing | Neem contact op met uw Keycloak-beheerder om uw roltoewijzingen te verifiëren. Controleer uw huidige rollen in Profiel → Rollen en Rechten. Vaak benodigde rollen: menu:production, equipment:view, menu:admin. |
404 Not Found
| Symptoom | Een pagina of API-endpoint geeft 404 terug |
| Oorzaak | De URL bestaat niet (typefout, verouderde bladwijzer) of de module is niet geïmplementeerd in deze instantie |
| Oplossing | Navigeer naar de pagina via het hoofdmenu. Als het menu-item zelf ontbreekt, is de functie mogelijk niet ingeschakeld in uw installatie, neem contact op met uw beheerder. |
500 Internal Server Error
| Symptoom | Een actie mislukt met een algemene serverfoutmelding |
| Oorzaak | Een onverwerkte uitzondering in de backend-API |
| Oplossing | Controleer de logs van de backend-container (docker logs opsee-fastapi). Als de fout reproduceerbaar is, noteer dan de exacte actie die deze veroorzaakt en meld deze aan uw beheerder met de tijdstempel zodat hij/zij de logregel kan correleren. |
502 Bad Gateway / 503 Service Unavailable
| Symptoom | De volledige applicatie toont een 502- of 503-foutpagina |
| Oorzaak | De backend-service of een van zijn afhankelijkheden (database, Keycloak) is uit de lucht of nog niet gestart |
| Oplossing | Voer docker ps uit op de server om te zien welke containers draaien. Herstart gestopte containers met docker compose up -d. Als de database het probleem is, controleer dan op een vol gelopen schijf of fouten met verbindingslimieten. |
Netwerkfouten
"Cannot connect" / Netwerkfout
| Symptoom | API-aanroepen mislukken met een netwerkfout in de browserconsole; er wordt geen HTTP-statuscode geretourneerd |
| Oorzaak | De OpSee backend-container draait niet, of de NGINX reverse proxy kan deze niet bereiken |
| Oplossing | Verifieer dat Docker-containers draaien: docker ps. Als de backend-container is gestopt, inspecteer dan de logs met docker logs opsee-fastapi. Herstart met docker compose up -d. |
Formuliervalidatiefouten
Verplicht veld / ongeldig formaat
| Symptoom | Een formulier weigert te worden verzonden en markeert velden in rood |
| Oorzaak | Een verplicht veld is leeg, een waarde komt niet overeen met het verwachte formaat (bv. een datumveld bevat tekst), of de invoer overschrijdt de maximale lengte |
| Oplossing | Vul alle gemarkeerde velden in. Let op de formaatrichtlijnen onder elk veld. |
Dubbele invoer
| Symptoom | Het formulier wordt verzonden maar geeft een fout terug zoals "bestaat al" of "duplicate key" |
| Oorzaak | Een record met dezelfde unieke identificatie (naam, code, enz.) bestaat al in de database |
| Oplossing | Gebruik een andere waarde voor het unieke veld, of bewerk het bestaande record in plaats van een nieuw record aan te maken. |