排解 AlloyDB Auth Proxy 連線問題

使用 AlloyDB Auth Proxy 連線至 AlloyDB for PostgreSQL 執行個體時,如要解決連線、驗證或網路錯誤,請查看下列常見問題和解決方案:

  • 請仔細檢查 AlloyDB Auth Proxy 輸出內容,找出錯誤。錯誤訊息通常會提供所需資訊,協助您判斷問題來源及解決方法。

  • 如果收到 403 Forbidden 錯誤,且使用服務帳戶驗證 AlloyDB Auth Proxy,請確認服務帳戶具備正確權限。

    提供這些權限的預先定義 AlloyDB Identity and Access Management (IAM) 角色為 AlloyDB 用戶端 (roles/alloydb.client) 和 AlloyDB 管理員 (roles/alloydb.admin)。此外,您必須新增 Service Usage Consumer (roles/serviceusage.serviceUsageConsumer) 角色。

  • 請務必啟用 AlloyDB API。

    如果未啟用,AlloyDB Auth Proxy 記錄會顯示 Error 403: Access Not Configured 等輸出內容。

  • 如果使用 UNIX 通訊端連線,請列出啟動 AlloyDB Auth Proxy 時提供的目錄,確認通訊端已建立。

  • 如果您有傳出防火牆政策,請確認該政策允許連線至目標 AlloyDB 執行個體的通訊埠 5433。

  • 配額問題:如果看到與配額超出的錯誤,請找出配額問題的來源 (例如應用程式誤用連接器,並建立不必要的連線),或與支援團隊聯絡,要求提高 AlloyDB API 配額。

  • 如果收到 400 Bad Request 回應,且錯誤訊息包含 reauth related error,請使用 Google Cloud CLI 重新整理應用程式預設憑證:

    gcloud auth application-default login

    詳情請參閱「應用程式預設憑證的運作方式」。