Interner Fehler im Entwicklerportal

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zuApigee X wechseln. info

Symptom

Fehler beim Stellen einer Live-API-Anfrage mit SmartDocs aus dem Entwickler portal.

Fehlermeldungen

Der häufigste Fehler im Entwicklerportal ist An internal error has occurred. Please retry your request (Ein interner Fehler ist aufgetreten. Bitte wiederholen Sie Ihre Anfrage).

Mögliche Ursachen

Dieser Fehler kann auftreten, wenn das Entwicklerportal keine Antwort vom Back-End (SmartDocs Proxy oder tatsächlicher Endpunkt) erhält.

Diagnose

Aktivieren Sie in Ihrem Browser die Entwicklertools und prüfen Sie den Tab „Netzwerk“, um den tatsächlichen Fehler zu ermitteln.

Häufige Fehler und ihre typischen Ursachen sind in der folgenden Tabelle aufgeführt:

Fehler	Typische Ursache(n)
ERR_NAME_NOT_RESOLVED	SmartDocs-Proxy falsch konfiguriert oder Einschränkungen durch die Netzwerk-Firewall
Gemischter Inhalt	Portal über HTTPS konfiguriert, SmartDocs-Anfrage über HTTP
500 – Interner Serverfehler	SmartDocs-Proxy gibt einen Fehler zurück Edge-Message Processor können den veröffentlichten API Endpunkt nicht aufrufen

Wir gehen jede dieser Ursachen einzeln durch und zeigen Ihnen, wie Sie das Problem beheben können.

SmartDocs-Proxy falsch konfiguriert oder Einschränkungen durch die Netzwerk-Firewall

Die Meldung ERR_NAME_NOT_RESOLVED weist darauf hin, dass die SmartDocs-Proxy-URL falsch konfiguriert ist oder dass das Netzwerk, über das auf das Portal zugegriffen wird, aufgrund von Firewalleinschränkungen keinen Aufruf an die SmartDocs-Proxy-URL senden kann. Der SmartDocs Proxy muss über das Internet oder über das interne Netzwerk (für interne APIs) zugänglich sein.

Auflösung

Achten Sie darauf, dass auf den SmartDocs-Proxy von allen erforderlichen Netzwerken aus zugegriffen werden kann, indem Sie den SmartDocs-Proxy auf einem virtuellen Host in Edge mit einem Hostnamen bereitstellen, der über das Internet zugänglich ist.

Portal über HTTPS konfiguriert, SmartDocs-Anfrage über HTTP

Der Fehler Gemischter Inhalt weist darauf hin, dass der SmartDocs-Proxy über HTTP von einer Seite aufgerufen wird, die über HTTPS geladen wurde.

Auflösung

Stellen Sie den SmartDocs-Proxy über HTTPS bereit, um das Problem zu beheben. Dazu können Sie den SmartDocs-Proxy so bereitstellen, dass er einen virtuellen Host enthält, der für die Verwendung von TLS/SSL konfiguriert ist (in der Regel der virtuelle Host „secure“).

SmartDocs-Proxy gibt eine Ausnahme zurück

Die Meldung 500 – Interner Serverfehler kann durch ein Problem mit dem SmartDocs-Proxy verursacht werden. In diesem Fall gibt der SmartDocs-Proxy diesen Fehler zurück.

Diagnose

Verwenden Sie das Trace-Tool, um Fehler mit dem SmartDocs-Proxy zu diagnostizieren. Gehen Sie dazu so vor: Weitere Informationen finden Sie unter Trace-Tool verwenden.

1. Aktivieren Sie das Tracing für den SmartDocs-Proxy in der Organisation VALIDATE, um die spezifische Richtlinie zu finden, die den Fehler „500 – Interner Serverfehler“ zurückgibt.

2. Wählen Sie die spezifische Richtlinie im Trace aus, um die Ursache des Fehlers zu ermitteln.

Auflösung

Beheben Sie den ermittelten Fehler. Wenn Sie Hilfe benötigen, wenden Sie sich an den Apigee Edge-Support.

Edge-Message Processor können den veröffentlichten API-Endpunkt nicht aufrufen

Der Fehler „500 – Interner Serverfehler“ kann auch auftreten, wenn die Message Processor der Organisation, in der der SmartDocs-Proxy gehostet wird, den API-Endpunkt nicht aufrufen können.

Diagnose

Verwenden Sie das Trace-Tool, um Fehler mit dem SmartDocs-Proxy zu diagnostizieren. Gehen Sie dazu so vor: Weitere Informationen finden Sie unter Trace-Tool verwenden.

1. Aktivieren Sie das Tracing für den SmartDocs -Proxy in der Organisation VALIDATE , um die spezifische Richtlinie zu finden, die den Fehler „500 – Interner Serverfehler“ zurückgibt.

2. Im obigen Beispiel für einen UI-Trace ist zu sehen, dass die JavaScript-Richtlinie „BuildTargetAPIRequest“ die Ziel-URL nicht ausführen kann.

3. Rufen Sie die Ziel-URL aus der JavaScript-Richtlinie „BuildTargetAPIRequest“ ab.

4. Rufen Sie die URL direkt von den Message Processor-Knoten auf, die der Organisation „VALIDATE“ zugeordnet sind, wie unten dargestellt:

   curl -v <target URL>

5. Beheben Sie alle beobachteten Fehler.

Auflösung

1. Achten Sie darauf, dass APIs, die im Entwicklerportal veröffentlicht wurden, von Message Processors aufgerufen werden können, die der Organisation VALIDATE zugeordnet sind, und beheben Sie alle aufgetretenen Fehler.

2. Wenn Sie den API-Aufruf direkt vom Message Processor ausführen können, sollten Sie die API sehr wahrscheinlich auch über SmartDocs ausführen können.

3. Führen Sie den API-Aufruf über SmartDocs aus und prüfen Sie, ob das Problem behoben wurde.