Dateiprobleme mit Graph Explorer reproduzieren

Wenn Benutzer langsames Browsing, fehlgeschlagene Dateiöffnungen oder andere Fehler bei Dateioperationen melden und KONNEKT-Debugprotokolle Graph-API-Fehler anzeigen, können Sie mit Microsoft Graph Explorer die fehlgeschlagene Anfrage direkt im Browser reproduzieren. Dadurch lässt sich eingrenzen, ob die Ursache im Microsoft 365-Backend oder in KONNEKT liegt, und es entstehen saubere Nachweise für ein Microsoft-Supportticket.

Microsoft Graph Explorer ist ein kostenloses, browserbasiertes Tool von Microsoft. Es sendet Anfragen an die Microsoft Graph API, dieselbe Schnittstelle, die KONNEKT, die Microsoft OneDrive-Synchronisierungs-App, Microsoft Teams und Microsoft 365 selbst verwenden, um SharePoint Online- und OneDrive-Dateien zu lesen und zu schreiben. Eine Installation ist nicht erforderlich.

Wann Sie diese Anleitung verwenden sollten

Verwenden Sie dieses Verfahren, wenn:

• Mehrere Benutzer berichten gleichzeitig über dasselbe Problem (oft ein Hinweis auf ein Backend-Problem).
• KONNEKT-Debugprotokolle Graph-API-Fehler anzeigen (HTTP 429, 500, 503, 504 oder UnknownError).
• Sie müssen dem Microsoft-Support nachweisen, dass das Problem nicht durch Software von Drittanbietern verursacht wird.
• Intermittierende Langsamkeit bleibt bestehen, nachdem die üblichen KONNEKT-Prüfungen ausgeschlossen wurden.

Das Debugprotokoll sammeln und prüfen

Der normale Weg, KONNEKT-Protokolle an den Support zu übermitteln, besteht darin, crashguard.exe von C:\Program Files\Konnekt. Dieser Ablauf packt die Protokolle zusammen und lädt sie unbemerkt im Hintergrund hoch – in den meisten Fällen bemerken weder der Benutzer noch der Administrator etwas davon. Siehe Vorbereitung der Debugprotokolle für den standardmäßigen Support-Workflow.

Der Graph-Explorer-Workflow ist anders: Sie müssen die Protokolldatei selbst lokal öffnen, um die URL der fehlgeschlagenen Anfrage und request-id in Graph Explorer zu kopieren. Die Protokolldateien befinden sich unter:

%LOCALAPPDATA%\Konnekt

KONNEKT speichert bis zu sechs rotierende Protokolldateien mit jeweils etwa 1 MB. Sortieren Sie nach Änderungszeit und beginnen Sie mit der neuesten Datei. Öffnen Sie sie in einem Texteditor und suchen Sie nach Fehler oder nach dem HTTP-Statuscode, den Sie untersuchen (zum Beispiel 504).

Bevor Sie das Problem reproduzieren, setzen Sie die Protokollebene auf Debug sodass vollständige Graph-API-Anfrage-URLs und Antworten erfasst werden. Siehe Protokollierung für Informationen dazu, wie sich die Protokollebene über die Benutzeroberfläche für Einstellungen, die Registrierung oder eine verwaltete Richtlinie ändern lässt.

Wie ein Graph-API-Fehler im KONNEKT-Protokoll aussieht

Ein typischer Fehlereintrag:

[2026-04-22 14:14:25.281] [22380] [error] [RESTkitClient] Http request (OneDriveClient::GetItemByPath)
GET: https://graph.microsoft.com/v1.0/drives/b!YbLv.../root:%2F...%2F03:?$select=remoteItem,id,name,... - 504
    Fehler: Nicht erkannte Antwort(504)
    "{"error":{"code":"UnknownError","message":"","innerError":{
      "date":"2026-04-22T12:14:25",
      "request-id":"dc38b1d9-cd9d-4f3d-b75a-5448695fa719",
      "client-request-id":"dc38b1d9-cd9d-4f3d-b75a-5448695fa719"
    }}}"

Notieren Sie diese Werte für spätere Schritte:

• Die vollständige GET URL (kopieren Sie alles bis zum HTTP-Statuscode, aber nicht einschließlich des HTTP-Statuscodes).
• Der HTTP-Statuscode (504 in diesem Beispiel).
• Die request-id Wert. Der Microsoft-Support kann die fehlgeschlagene Anfrage anhand dieser ID nachverfolgen.

Voraussetzungen

• Zugriff auf das Microsoft 365-Konto des betroffenen Benutzers oder der Benutzer ist verfügbar, um sich selbst anzumelden.
• Ein moderner Webbrowser (Microsoft Edge, Chrome, Firefox oder Safari).
• Der genaue Dateipfad und Dateiname, den der Benutzer gemeldet hat, oder die Graph-API-URL aus dem Debugprotokoll.
• Zugriff als Globaler Administrator auf das Microsoft 365 Admin Center (nur wenn Sie ein Microsoft-Supportticket eröffnen möchten).

Sie müssen sich als der Benutzer anmelden, der von dem Problem betroffen ist, nicht als Administrator. Die Verwendung eines anderen Kontos ändert die Berechtigungen und den Dateizugriff, wodurch der Test ungültig wird.

Schritt 1: Graph Explorer öffnen

1. Öffnen Sie Ihren Browser und rufen Sie https://developer.microsoft.com/graph/graph-explorer.
2. Klicken Sie Anmelden in der oberen linken Ecke auf.
3. Melden Sie sich mit den Anmeldedaten des betroffenen Benutzers an.

Schritt 2: Erforderliche Berechtigungen erteilen

Graph Explorer verwendet delegierte Berechtigungen. Erteilen Sie für dateibezogene Tests die folgenden Scopes:

Berechtigungsumfang	Zweck
User.Read	Profil des angemeldeten Benutzers lesen
Files.Read	Die OneDrive-Dateien des Benutzers lesen
Files.Read.All	Alle Dateien lesen, auf die der Benutzer Zugriff hat
Sites.Read.All	Elemente von SharePoint-Websites lesen, auf die der Benutzer Zugriff hat

Um die Berechtigungen zu erteilen:

1. Klicken Sie in Graph Explorer auf die Berechtigungen ändern Registerkarte unterhalb der Abfrageeingabe.
2. Suchen Sie jeden Berechtigungsumfang in der Liste.
3. Klicken Sie Zustimmung neben jedem Berechtigungsumfang.
4. Bestätigen Sie die Zustimmungsaufforderung.

Die vollständige Berechtigungsreferenz finden Sie unter Microsofts Berechtigungsreferenz.

Schritt 3: Eine Testabfrage ausführen

Setzen Sie die HTTP-Methode auf GET und geben Sie eine der folgenden Abfragen in das Feld für die Anfrage-URL ein. Ersetzen Sie Platzhalterwerte in geschweiften Klammern durch echte Werte.

Option A: Die URL aus dem KONNEKT-Debugprotokoll wiederverwenden

Kopieren Sie die vollständige URL aus der Protokollzeile, die mit GET: https://graph.microsoft.com/.... Fügen Sie alles bis zum HTTP-Statuscode, aber nicht den HTTP-Statuscode selbst, in das URL-Feld von Graph Explorer ein.

Dies ist die bevorzugte Option, da sie genau die fehlgeschlagene Anfrage reproduziert.

Option B: Die Abfrage manuell erstellen

Um den OneDrive-Stammordner des Benutzers aufzulisten:

GET https://graph.microsoft.com/v1.0/me/drive/root/children

Um über den Pfad auf eine bestimmte Datei zuzugreifen:

GET https://graph.microsoft.com/v1.0/me/drive/root:/Documents/Reports/example.pdf

Um auf eine Datei auf einer SharePoint-Website zuzugreifen, rufen Sie zuerst die Website-ID ab:

GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}

Fragen Sie dann die Datei mit dieser Website-ID ab:

GET https://graph.microsoft.com/v1.0/sites/{site-id}/drive/root:/Shared Documents/Folder/example.pdf

Klicken Sie Abfrage ausführen und prüfen Sie den Antwortbereich.

Schritt 4: Das Ergebnis interpretieren

Der Antwortbereich zeigt einen HTTP-Statuscode und einen JSON-Text an. Verwenden Sie die folgende Tabelle, um das Ergebnis zu klassifizieren und den nächsten Schritt zu bestimmen.

Statuscode	Bedeutung	Nächster Schritt
200 OK	Der Aufruf der Graph API war erfolgreich. Die Datei ist auf API-Ebene zugänglich.	Das Problem liegt auf der KONNEKT-Seite oder in der Clientumgebung. Kehren Sie zum Fehlerbehebungs-Hub.
401 Unauthorized	Das Token fehlt, ist abgelaufen oder ungültig.	Melden Sie sich von Graph Explorer ab und erneut an. Wenn der Fehler weiterhin besteht, siehe Probleme mit dem Zugriffstoken.
403 Forbidden	Der angemeldete Benutzer hat keine Berechtigung für diese Datei oder Website.	Kein Problem auf Seiten von KONNEKT oder im Microsoft-Backend. Überprüfen Sie die Berechtigungen in der SharePoint-Weboberfläche.
404 Not Found	Die Datei oder der Ordner ist unter dem angegebenen Pfad nicht vorhanden.	Überprüfen Sie den Pfad. Die Datei wurde möglicherweise verschoben, umbenannt oder gelöscht.
429 Too Many Requests	Drosselung durch SharePoint Online.	Drosselung auf Microsoft-Seite. Prüfen Sie den Retry-After Header, warten Sie und versuchen Sie es erneut. Einstellungen zur Vermeidung von Drosselung können das erneute Auftreten verringern.
500 Interner Serverfehler, 503 Dienst nicht verfügbar, 504 Gateway-Timeout	Fehler im Microsoft-Backend.	Das Problem liegt auf Microsofts Seite. Fahren Sie mit den nächsten Schritten fort.
UnknownError im Antworttext	Fehler im Microsoft-Backend ohne spezifischen Code.	Wie oben. Erfassen Sie die request-id und eröffnen Sie ein Microsoft-Supportticket.

Schritt 5: Nachweise erfassen

Bevor Sie Graph Explorer schließen, dokumentieren Sie den Test. Gute Nachweise helfen dabei, Supporttickets schneller zu lösen.

Sammeln Sie:

• Einen Screenshot des Graph-Explorer-Fensters, der die Abfrage-URL, den HTTP-Statuscode und den Antworttext zeigt.
• Datum und Uhrzeit des Tests, einschließlich Zeitzone.
• Die UPN des angemeldeten Benutzers (zum Beispiel [e-mail]).
• Der genaue getestete Dateipfad.
• Die request-id Wert aus dem JSON-Antworttext.
• Bei sporadischen Fehlern wiederholen Sie die Abfrage mehrmals und erfassen Sie jedes Ergebnis.

Schritt 6: Ein Microsoft-Supportticket eröffnen

Führen Sie diesen Schritt nur aus, wenn Graph Explorer eine 500-, 503-, 504- oder UnknownError Antwort.

1. Navigieren Sie zu https://admin.microsoft.com und melden Sie sich mit einem Global-Administrator-Konto an.
2. Gehen Sie zu Support -> Neue Serviceanfrage.
3. Auswählen SharePoint Online oder OneDrive for Business als betroffenen Dienst, passend zum fehlgeschlagenen Endpunkt.
4. Beschreiben Sie das Problem und fügen Sie die Screenshots aus dem vorherigen Schritt bei.
5. Fügen Sie die request-id aus dem KONNEKT-Debugprotokoll und der Graph-Explorer-Antwort hinzu. Dadurch kann Microsoft die genauen fehlgeschlagenen Anforderungen nachverfolgen.
6. Geben Sie ausdrücklich an, dass das Problem in Microsoft Graph Explorer reproduziert wurde.

Der Nachweis aus Graph Explorer signalisiert, dass Ursachen von Drittanbietern bereits ausgeschlossen wurden. Der Microsoft-Support bearbeitet diese Tickets in der Regel schneller.

Häufig verwendete Graph-API-Endpunkte

Schnellreferenz für die Endpunkte, die am häufigsten in KONNEKT-Debugprotokollen zu sehen sind:

Vorgang	Endpunkt
Benutzerprofil	GET /me
Auflistung des OneDrive-Stammverzeichnisses	GET /me/drive/root/children
Datei nach Pfad (OneDrive)	GET /me/drive/root:/{path}
Datei nach Element-ID	GET /drives/{drive-id}/items/{item-id}
Website nach Hostname und Pfad	GET /sites/{hostname}:/{site-path}
SharePoint-Laufwerke auf einer Website	GET /sites/{site-id}/drives
Download des Dateiinhalts	GET /drives/{drive-id}/items/{item-id}/content
Delta-Abfrage	GET /drives/{drive-id}/root/delta

Die vollständige Referenz finden Sie in der Microsoft Graph Drive-API.

Ähnliche Probleme

• Sites fehlen oder Ordner sind leer - für Fehler im SharePoint-Suche-Backend
• Probleme mit dem Zugriffstoken - für 401 Unauthorized-Antworten
• So gehen Sie mit Fehler(n) um - für Fehler bei bestimmten Dateien
• Vorbereitung der Debugprotokolle - wie Protokolle mit Graph-API-Details gesammelt werden
• Protokollierung - Konfiguration der Protokollebene