疑難排解總覽問題
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
這個頁面可協助您查看、偵錯及修正 Chat 應用程式、資訊卡和對話方塊錯誤。
錯誤顯示方式
如果 Google Chat 應用程式傳回錯誤,會顯示如下:
- 系統會顯示「應用程式沒有回應」等訊息,顯示「發生錯誤」或「無法處理您的要求」。
- 應用程式無法正常運作。
- 不會顯示任何訊息,應用程式也不會回應。
如果資訊卡傳回錯誤,會顯示如下:
- 資訊卡的部分內容 (例如小工具或元件) 未顯示或以非預期方式呈現。
- 系統不會顯示整張資訊卡。
- 對話方塊會關閉、未開啟或未載入。
即使 Chat 使用者介面未顯示錯誤訊息,開啟 Chat 應用程式的錯誤記錄功能後,您仍可查看說明性錯誤訊息和記錄資料,協助修正錯誤。
偵錯及排解 Google Chat 錯誤
- 開啟錯誤記錄功能,讓 Google Chat 應用程式在發生錯誤時記錄下來。
- 查詢 Google Chat 的錯誤記錄,即可讀取錯誤記錄、查看錯誤發生頻率,以及閱讀有助於修正錯誤的說明性錯誤訊息和記錄資料。
- 瞭解如何修正常見錯誤:
- 對 Chat 應用程式偵錯,逐步執行應用程式。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-04 (世界標準時間)。
[null,null,["上次更新時間:2025-08-04 (世界標準時間)。"],[[["\u003cp\u003eThis page provides guidance on viewing, debugging, and resolving errors in Google Chat apps, cards, and dialogs.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Chat errors can manifest as error messages, unexpected app behavior, or lack of response, while card errors might result in partial or complete rendering failures.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage error logging, log querying, and troubleshooting resources to identify and fix errors in their Chat apps, cards, and dialogs.\u003c/p\u003e\n"],["\u003cp\u003eSpecific guides are available to address common Chat app errors, card and dialog issues, and enable step-by-step debugging for comprehensive troubleshooting.\u003c/p\u003e\n"]]],["This content details how to manage errors in Google Chat apps, cards, and dialogs. Errors manifest as unresponsive apps, missing or malfunctioning card elements, or closed/failed dialogs. To address this, enable error logging. Query error logs to identify the frequency and nature of errors. Resources are available to fix common app, card, and dialog issues, and a debug feature allows for step-by-step execution analysis.\n"],null,["This page helps you view, debug, and fix Chat apps, card, and dialog errors.\n\nHow errors appear\n\nWhen a Google Chat app returns an error, it manifests like this:\n\n- A message like \"App is not responding.\", \"Something went wrong.\", or \"Unable to process your request\" displays.\n- The app doesn't work as intended.\n- No message displays, and the app doesn't respond.\n\nWhen a [card](/workspace/chat/create-messages#create) returns an error, it manifests like this:\n\n- Part of a card, like a widget or component, doesn't appear or renders in an unexpected way.\n- The entire card doesn't appear.\n- A dialog closes, doesn't open, or doesn't load.\n\nAlthough an error message might not display in the Chat UI, descriptive error messages and log data are available to help you fix errors when error logging for Chat apps is turned on.\n\nDebug and troubleshoot Google Chat errors\n\n1. [Turn on error logging](/workspace/chat/turn-on-error-logging) so your Google Chat app logs errors if and when they occur.\n2. [Query error logs for Google Chat](/workspace/chat/query-logs) to read error logs, see how often errors occur, and read descriptive error messages and log data that help you fix the errors.\n3. Learn how to fix common errors:\n - [Fix Google Chat app errors](/workspace/chat/troubleshoot-chat-apps) like \"App is not responding\", \"Google Chat API is only available to Google Workspace users\", or \"Users can be excluded from spaces\".\n - [Fix card and dialog errors](/workspace/chat/troubleshoot-cards) like card messages, dialogs, or link previews not rendering or working as expected.\n4. [Debug your Chat app](/workspace/chat/debug-apps) to execute it step by step."]]