Fehlercodes
Fehlercodes
PgArachne gibt standardmäßige JSON-RPC 2.0 Fehlerobjekte zurück. Unten finden Sie die spezifischen Codes, denen Sie begegnen können:
| Code | Nachricht | Bedeutung |
|---|---|---|
-32700 | Parse error | Ungültiges JSON wurde vom Server empfangen. |
-32601 | Method not found | Die Funktion existiert nicht im Schema. |
-32602 | Invalid params | Argumente stimmen nicht mit der Funktionssignatur überein. |
-32001 | Permission denied | Der aktuellen Benutzerrolle fehlen die Berechtigungen zum Ausführen der Funktion (DB-Ebene). |
-32000 | Internal Error | Allgemeiner Serverfehler (siehe Logs). |
Aktuelles Verhalten: Laufzeitantworten werden primär auf HTTP-Statuscodes mit JSON-RPC-
message abgebildet. Der benutzerdefinierte JSON-RPC-Code -32001 wird bei Rollen-/Berechtigungsfehlern verwendet.Zuordnung von HTTP-Statuscodes
| HTTP | Typische Nachricht | Wann es passiert |
|---|---|---|
400 | Invalid JSON request/Invalid function name | Ungültiger Request-Body oder Methodenformat. |
401 | Authorization header is missing/Invalid or expired token | Fehlende oder ungültige Authentifizierung. |
403 | Permission denied for the specified role | SET LOCAL ROLE fehlgeschlagen (-32001). |
404 | Function does not exist/JWT is disabled/get_jwt was removed | Zielmethode fehlt (-32601), /token wurde aufgerufen, obwohl JWT_SECRET nicht konfiguriert ist, oder die entfernte JSON-RPC-Methode get_jwt wurde aufgerufen (verwenden Sie POST /{prefix}/{database}/token). |
429 | Too many login attempts/Too many failed authentication attempts | Login- bzw. Authentifizierungs-Rate-Limit überschritten (LOGIN_RATE_LIMIT, LOGIN_RATE_LIMIT_PER_IP). |
413 | Request body too large/Response too large/Too many files in response | Anfrage überschreitet MAX_REQUEST_BYTES, oder eine /file-Antwort überschreitet FILE_MAX_BYTES / FILE_MAX_ENTRIES. |
500 | Function call failed/Transaction commit failed | Ausführung oder Commit fehlgeschlagen. |
503 | Database connection failed/Database unavailable | Datenbank oder Listener vorübergehend nicht verfügbar. |