Fehlerbehebung bei AlloyDB Auth-Proxy-Verbindungen

Wenn Sie Verbindungs-, Authentifizierungs- oder Netzwerkfehler beim Herstellen einer Verbindung zu Ihrer AlloyDB for PostgreSQL-Instanz mit dem AlloyDB Auth-Proxy beheben möchten, prüfen Sie die folgenden häufigen Probleme und Lösungen:

  • Prüfen Sie die Ausgabe des AlloyDB Auth-Proxys sorgfältig auf Fehler. Häufig enthalten die Fehlermeldungen die Informationen, die Sie benötigen, um die Ursache des Problems zu ermitteln und eine Lösung dafür zu finden.

  • Wenn Sie den Fehler 403 Forbidden erhalten und das Dienstkonto zum Authentifizieren des AlloyDB Auth-Proxys verwenden, müssen Sie dafür sorgen, dass das Dienstkonto die richtigen Berechtigungen hat.

    Die vordefinierten IAM-Rollen (Identity and Access Management) von AlloyDB, die diese Berechtigungen bereitstellen, sind „AlloyDB Client“ (roles/alloydb.client) und „AlloyDB Admin“ (roles/alloydb.admin). Außerdem müssen Sie die Rolle „Service Usage Consumer“ (roles/serviceusage.serviceUsageConsumer) hinzufügen.

  • Achten Sie darauf, dass die AlloyDB API aktiviert ist.

    Ist dies nicht der Fall, wird in Ihren AlloyDB Auth-Proxy-Logs eine Meldung wie z. B. Error 403: Access Not Configured ausgegeben.

  • Wenn Sie eine Verbindung über UNIX-Sockets herstellen, prüfen Sie, ob die Sockets erstellt wurden. Rufen Sie dazu das Verzeichnis auf, das Sie beim Start des AlloyDB Auth-Proxys angegeben haben.

  • Wenn Sie eine Firewallrichtlinie für ausgehende Verbindungen haben, müssen Sie darauf achten, dass sie Verbindungen zu Port 5433 auf der Ziel-AlloyDB-Instanz zulässt.

  • Kontingentprobleme: Wenn Fehler im Zusammenhang mit der Überschreitung von Kontingenten auftreten, ermitteln Sie entweder die Ursache des Kontingentproblems (z. B. eine Anwendung, die den Connector falsch verwendet und unnötig neue Verbindungen erstellt) oder wenden Sie sich an den Support, um eine Erhöhung des AlloyDB API-Kontingents zu beantragen.

  • Wenn Sie die Antwort 400 Bad Request mit einer Fehlermeldung erhalten, die reauth related error enthält, aktualisieren Sie Ihre Standardanmeldedaten für Anwendungen mithilfe der Google Cloud CLI:

    gcloud auth application-default login

    Weitere Informationen finden Sie unter Funktionsweise von Standardanmeldedaten für Anwendungen.