Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen
Symptom
Beim Senden einer Live-API-Anfrage mit SmartDocs aus dem Entwicklerportal ist ein Fehler aufgetreten.
Fehlermeldungen
Die häufigste Fehlermeldung im Entwicklerportal lautet: Es ist ein interner Fehler aufgetreten. Bitte versuchen Sie es noch einmal.“
Mögliche Ursachen
Dieser Fehler kann auftreten, wenn das Entwicklerportal keine Antwort vom Back-End abrufen kann (Smartdocs-Proxy oder der tatsächliche Endpunkt).
Diagnose
Aktivieren Sie in Ihrem Browser „Entwicklertools“ und sehen Sie auf dem Tab „Netzwerk“ nach, um den tatsächlichen Fehler zu finden.
Häufige Fehler und ihre Ursachen sind in der folgenden Tabelle aufgeführt:
|
Fehler |
Typische Ursache(n) |
|
ERR_NAME_NOT_RESOLVED |
Falsch konfigurierter SmartDocs-Proxy oder Einschränkungen der Netzwerkfirewall |
|
Gemischte Inhalte |
|
|
500 – Interner Serverfehler |
Sehen wir uns jede dieser Ursachen einzeln an und gehen wir die Schritte durch, um das Problem zu beheben.
Falsch konfigurierter SmartDocs-Proxy oder Einschränkungen der Netzwerkfirewall
Die Meldung „ERR_NAME_NOT_RESOLVED“ gibt an, dass die Smartdocs-Proxy-URL falsch konfiguriert ist oder das Netzwerk, von dem aus auf das Portal zugegriffen wird, aufgrund von Firewall-Einschränkungen keinen Aufruf an die Smartdocs-Proxy-URL senden kann. Der Smartdocs-Proxy muss über das Internet oder (für interne APIs) über das interne Netzwerk zugänglich sein.
Auflösung
Sorgen Sie dafür, dass von allen erforderlichen Netzwerken auf den Smartdocs-Proxy zugegriffen werden kann. Stellen Sie dazu den Smartdocs-Proxy auf einem virtuellen Host in Edge mit einem Hostnamen bereit, auf den über das Internet zugegriffen werden kann.
Portal über HTTPS konfiguriert, SmartDocs-Anfrage über HTTP
Der Fehler „Gemischte Inhalte“ gibt an, dass der Smartdocs-Proxy über HTTP von einer über HTTPS geladenen Seite aufgerufen wird.
Auflösung
Geben Sie den Smartdocs-Proxy über HTTPS frei, um das Problem zu beheben. Stellen Sie dazu den Smartdocs-Proxy bereit, um einen virtuellen Host einzubinden, der für die Verwendung von TLS/SSL konfiguriert ist (normalerweise der "sichere" virtuelle Host).
SmartDocs-Proxy gibt eine Ausnahme zurück
Die Meldung 500 – Internal Server Error kann durch ein Problem mit dem Proxy „Smartdocs“ verursacht werden. In diesem Fall stellen Sie fest, dass der Smartdocs-Proxy diesen Fehler zurückgibt.
Diagnose
Verwenden Sie das Trace-Tool, um Fehler mit dem "Smartdocs"-Proxy zu diagnostizieren, wie unten beschrieben. Weitere Informationen finden Sie unter Trace-Tool verwenden.
- Aktivieren Sie Trace für den Proxy "smartdocs" in der Organisation "VALIDATE", um die Richtlinie zu ermitteln, die den internen Serverfehler 500 zurückgibt.
- Wählen Sie eine bestimmte Richtlinie im Trace aus, um die Fehlerursache zu ermitteln.
Auflösung
Beheben Sie den erkannten Fehler. Wenn Sie Hilfe benötigen, wenden Sie sich an den Apigee Edge-Support.
Edge-Nachrichtenprozessoren können den veröffentlichten API-Endpunkt nicht aufrufen
500 – Interner Serverfehler kann auch auftreten, wenn die Nachrichtenprozessoren, die zur Organisation gehören, die den Smartdocs-Proxy hostet, den API-Endpunkt nicht aufrufen können.
Diagnose
Verwenden Sie das Trace-Tool, um Fehler mit dem "Smartdocs"-Proxy zu diagnostizieren, wie unten beschrieben. Weitere Informationen finden Sie unter Trace-Tool verwenden.
- Aktivieren Sie trace für den Proxy "smartdocs" in der Organisation "VALIDATE", um die Richtlinie zu ermitteln, die den internen Serverfehler 500 zurückgibt.
- Im oben gezeigten Beispiel-UI-Trace kann die JavaScript-Richtlinie BuildTargetAPIRequest die Ziel-URL nicht ausführen.
- Rufen Sie die Ziel-URL aus der JavaScript-Richtlinie „BuildTargetAPIRequest“ ab.
- Führen Sie einen direkten Aufruf an die URL von den Message Processor-Knoten aus, die mit der Organisation "VALIDATE" verknüpft sind, wie unten gezeigt:
curl -v <target URL>
- Korrigieren Sie alle beobachteten Fehler.
Auflösung
- Achten Sie darauf, dass im Entwicklerportal veröffentlichte APIs von Message Processors der Organisation VALIDATE aufgerufen werden können, und beheben Sie etwaige Fehler.
- Wenn Sie den API-Aufruf direkt vom Message Processor aus ausführen können, ist es sehr wahrscheinlich, dass Sie die API auch über SmartDocs ausführen können.
- Führen Sie den API-Aufruf über SmartDocs aus und prüfen Sie, ob das Problem behoben ist.