Fehlerbehebung – Übersicht
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite erfahren Sie, wie Sie Fehler in Chat-Apps, Karten und Dialogfeldern ansehen, beheben und debuggen können.
So werden Fehler angezeigt
Wenn eine Google Chat App einen Fehler zurückgibt, sieht das so aus:
- Eine Meldung wie „App reagiert nicht“ Die Meldung „Ein Fehler ist aufgetreten.“ oder „Ihre Anfrage kann nicht bearbeitet werden.“ wird angezeigt.
- Die App funktioniert nicht wie vorgesehen.
- Es wird keine Meldung angezeigt und die App reagiert nicht.
Wenn eine Karte einen Fehler zurückgibt, wird das so angezeigt:
- Ein Teil einer Karte, z. B. ein Widget oder eine Komponente, wird nicht angezeigt oder wird auf unerwartete Weise gerendert.
- Die gesamte Karte wird nicht angezeigt.
- Ein Dialogfeld wird geschlossen, nicht geöffnet oder nicht geladen.
Auch wenn in der Chat-Benutzeroberfläche keine Fehlermeldung angezeigt wird, sind beschreibende Fehlermeldungen und Protokolldaten verfügbar, die Ihnen helfen, Fehler zu beheben, wenn die Fehlerprotokollierung für Chat-Apps aktiviert ist.
Google Chat-Fehler beheben
- Aktivieren Sie die Fehlerprotokollierung, damit Ihre Google Chat-App Fehler protokolliert, wenn sie auftreten.
- Fehlerlogs für Google Chat abfragen: Hier können Sie Fehlerlogs lesen, sehen, wie oft Fehler auftreten, und beschreibende Fehlermeldungen und Logdaten lesen, die Ihnen helfen, die Fehler zu beheben.
- So beheben Sie einige der am häufigsten auftretenden Fehler:
- Fehler in Google Chat-Apps beheben, z. B. „App reagiert nicht“, „Die Google Chat API ist nur für Google Workspace-Nutzer verfügbar“ oder „Nutzer können aus Bereichen ausgeschlossen werden“.
- Karten- und Dialogfehler beheben, z. B. wenn Kartenmitteilungen, Dialogfelder oder Linkvorschauen nicht wie erwartet gerendert werden oder funktionieren.
- Debuggen Sie Ihre Chat-App, um sie schrittweise auszuführen.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-04 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-04 (UTC)."],[[["\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."]]
