Google Sheets OAuth 錯誤:「找不到 OAuth 用戶端」(錯誤 401: invalid_client)

Google Sheets OAuth 錯誤:「找不到 OAuth 用戶端」(錯誤 401: invalid_client)

大家好,

我正在學習 n8n,目前使用 Docker 在本地運行 n8n。

我嘗試將 Google Sheets 連接到 n8n,但當我點擊「使用 Google 登入」時,出現了以下錯誤:

存取已被封鎖:授權錯誤

找不到 OAuth 用戶端。

錯誤 401: invalid_client

我使用的是我的個人 Gmail 帳戶。

我已經嘗試了兩天來修復這個問題,但仍然無法讓 Google Sheets 憑據正常運作。

能否請有人說明我需要在 Google Cloud Console 和 n8n 中檢查或配置什麼來修復此問題?

我是初學者,所以我非常感謝一步一步的詳細說明。

謝謝!

錯誤 401: invalid_client 表示保存在 n8n 憑證中的客戶端 ID/密鑰與 Google Cloud 專案中實際存在的 OAuth 客戶端不匹配 — 最常見的原因是該憑證指向已刪除的客戶端,或來自與您正在查看的專案不同的專案。打開 Google Cloud Console > API 和服務 > 憑證,確認在啟用 Google Sheets API 的同一專案中存在「Web 應用程式」類型的 OAuth 2.0 客戶端 ID;複製其客戶端 ID 並確保它與 n8n 中的憑證完全匹配(沒有尾部空格)。然後,在該客戶端的「授權重新導向 URI」中,新增 n8n 在憑證頁面上顯示的確切回呼 URL(以 /rest/oauth2-credential/callback 結尾)— 本機安裝的回呼使用瀏覽器實際用來開啟 n8n 的主機名稱,主機部分必須完全相符。如果您將客戶端建立為「桌面應用程式」類型,請刪除它並重新建立為「Web 應用程式」,因為桌面客戶端不接受 n8n 回呼。最後,在 n8n 中刪除並重新建立憑證(或重新開啟並重新儲存),以便它重新讀取新的客戶端 ID 和密鑰,然後再次點擊「使用 Google 登入」。

401 invalid_client 就是 Google 認不得你傳過去的那組 Client ID / Secret。HomelabAgent 說得對,最常見是客戶端被刪掉;另外幾個常見坑可以照順序排查:

  1. 到 Google Cloud Console →「API 與服務」→「憑證」,確認那個 OAuth 2.0 用戶端 ID 還存在、狀態正常。如果被刪除或停用了,只能新建一個,把新的 Client ID / Client Secret 記下來。

  2. 在 n8n 的 Google Sheets 憑證視窗裡,把「OAuth 重新導向網址」完整複製(就是點「使用 Google 登入」之前那個框框裡的網址),回到 Cloud Console 那個用戶端的設定頁,把它加到「已授權的重新導向 URI」,必須一字不差,http/https 和結尾斜線都要一致。你用 Docker 跑在本地的話,確認這個網址是瀏覽器能打開的地址,而不是 container 內部的。

  3. 回到 n8n,建議直接刪除舊憑證、重新建立一個新的,把 Client ID 和 Secret 重新貼一次再連線(不要只改舊的,避免 Secret 曾經被重設但兩邊不一致)。

  4. 如果是個人 Gmail 且 OAuth 同意畫面設成「外部」、還在測試模式的話,要把自己的 Gmail 加到測試使用者名單裡;另外該專案要啟用 Google Sheets API。

照這四步走完,invalid_client 基本上都能解決。如果還是 401,把 Cloud Console 上用戶端設定的截圖(記得遮掉 Secret)和 n8n 這邊報錯的完整訊息貼上來,大家比較好幫你看。

1 個讚

嗨 @zizo_Ahmed,一個細節可以縮小範圍。在使用 Google 登入時,n8n 只會向 Google 傳送用戶端 ID;稍後才會使用密鑰。所以「找不到 OAuth 用戶端」表示 Google 不認識用戶端 ID 字串本身。已刪除的用戶端通常會改為顯示 deleted_client。

按順序檢查這些項目:

  1. 用戶端 ID 欄位。 必須以 .apps.googleusercontent.com 結尾。密鑰(GOCSPX-…)應放在用戶端密鑰中。欄位對調或尾端有空格會導致完全相同的錯誤。
  2. 正確的專案。 用戶端 ID 中第一個 - 前的數字是專案編號。檢查它是否與 Cloud Console 中選擇的專案相符,以及用戶端是否在 API 和服務 → 憑證下顯示為網路應用程式。
  3. 新用戶端? Google 表示變更可能需要 5 分鐘到幾小時才能套用。
  4. 重新導向 URI。 將 n8n 的OAuth 重新導向 URL 精確貼到授權的重新導向 URI 中。使用預設 Docker 時為 http://localhost:5678/rest/oauth2-credential/callback。
  5. API。 同時啟用 Google Sheets API 和 Google Drive API。n8n 的 Sheets 節點也需要 Drive。
  6. 對象。 選擇「External」並在測試使用者下新增你的 Gmail。在測試模式中,權杖會在 7 天後過期。

Google 現在只會在用戶端密鑰建立時顯示一次。如果你沒有儲存,可以新增密鑰(或建立新用戶端)。然後使用兩個值建立新的 n8n 憑證。

如果你寧願我在你的帳戶中建置,固定價格為 $99,在測試潛在客戶執行後付款。

Max Oliver,顧問 · MaxAssist99

嗨 @zizo_Ahmed — 我看到你在 Google Sheets OAuth 401 的問題上卡了兩天。

我可以只進行連接故障排除,而不是提議建立更大規模的 n8n 構建。

如果你想的話,我可以進行 $10 固定 OAuth 設定檢查:Google Cloud OAuth 用戶端、重新導向 URI、API 設定和 n8n 憑證,然後成功連接 Google Sheets 憑證。

在分享任何東西之前,你可以隱藏用戶端密鑰。我不需要你的 Google 密碼或帳戶存取權。

如果發現問題超出該設定範圍,我會在進行任何進一步操作之前告訴你。

上面的回覆已經涵蓋了設定。但在連線後要注意一件事,因為它會在一週後咬你一口:如果 OAuth 同意畫面保持在「測試」狀態,Google 會在大約 7 天後過期重新整理令牌,你的 Google Sheets 節點就會開始因為驗證錯誤而失敗,儘管沒有任何改變。我在自己的實例上就遇到過這個情況。

對我有效的修正方法是:在 Google Cloud Console 中開啟 OAuth 同意畫面(Google Auth Platform、受眾),將發佈狀態從「測試」更改為「正式版」,然後在 n8n 中開啟憑證並再次點擊「使用 Google 登入」。作為唯一的使用者,你會看到一次「未驗證的應用程式」警告,然後可以繼續。

所以:先按上述說明修正用戶端 ID / 重新導向 URI,並在第一次成功連線後立即執行發佈步驟,這樣你就不用在下週再次除錯。