Dateiprobleme mit Graph Explorer reproduzieren

Wenn Benutzer langsames Browsen, fehlgeschlagene Dateiöffnungen oder andere Fehler bei Dateivorgängen melden und die KONNEKT-Debugprotokolle Graph-API-Fehler anzeigen, können Sie mit Microsoft Graph Explorer die fehlerhafte Anforderung direkt im Browser reproduzieren. Dadurch lässt sich eingrenzen, ob die Ursache im Microsoft-365-Backend oder in KONNEKT liegt, und es entsteht ein sauberer Nachweis für ein Support-Ticket bei Microsoft.

Microsoft Graph Explorer ist ein kostenloses browserbasiertes Tool von Microsoft. Es sendet Anforderungen an die Microsoft Graph API, die dieselbe Schnittstelle ist, 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 melden gleichzeitig dasselbe Problem (oft ein Anzeichen für ein Backend-Problem).

• KONNEKT-Debugprotokolle zeigen Graph-API-Fehler (HTTP 429, 500, 503, 504 oder UnknownError).

• Sie müssen Microsoft Support nachweisen, dass das Problem nicht durch Software von Drittanbietern verursacht wird.

• Gelegentliche Verlangsamungen bestehen fort, nachdem die üblichen KONNEKT-Prüfungen ausgeschlossen wurden.

Debug-Protokoll sammeln und prüfen

Der normale Weg, KONNEKT-Protokolle an den Support zu übermitteln, besteht darin, crashguard.exe aus C:\Program Files\Konnektauszuführen. Dieser Ablauf verpackt die Protokolle und lädt sie im Hintergrund unbemerkt hoch – in den meisten Fällen bemerken weder der Benutzer noch der Administrator, dass etwas geschieht. Siehe Vorbereitung des Debug-Protokolls für den standardmäßigen Support-Workflow.

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

%LOCALAPPDATA%\Konnekt

KONNEKT behält 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 error oder nach dem HTTP-Statuscode, den Sie untersuchen (zum Beispiel, 504).

Bevor Sie das Problem reproduzieren, stellen Sie den Protokollierungsgrad auf Debug ein, damit vollständige Graph-API-Anforderungs-URLs und -Antworten erfasst werden. Siehe Protokollierung dazu, wie Sie den Protokollierungsgrad über die Einstellungen, die Registrierung oder eine verwaltete Richtlinie ändern.

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
    error: Unrecognized response(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, aber nicht einschließlich, des HTTP-Statuscodes).

• Der HTTP-Statuscode (in diesem Beispiel 504).

• Der request-id Wert. Microsoft Support kann die fehlgeschlagene Anforderung mithilfe 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 vom Benutzer gemeldete Dateipfad und Dateiname oder die Graph-API-URL aus dem Debugprotokoll.

• Globaler Administratorzugriff auf das Microsoft-365-Admin-Center (nur wenn Sie planen, ein Microsoft-Support-Ticket zu eröffnen).

Sie müssen sich als der Benutzer anmelden, der das Problem hat, 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 navigieren Sie zu https://developer.microsoft.com/graph/graph-explorer.

2. Klicken Sie auf Anmelden in der oberen linken Ecke.

3. Melden Sie sich mit den Anmeldedaten des betroffenen Benutzers an.

Schritt 2: Die erforderlichen Berechtigungen erteilen

Graph Explorer verwendet delegierte Berechtigungen. Für dateibezogene Tests erteilen Sie die folgenden Bereiche:

Bereich	Zweck
User.Read	Das 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-Sites lesen, auf die der Benutzer Zugriff hat

Um die Bereiche zu erteilen:

1. Klicken Sie in Graph Explorer auf die Berechtigungen ändern Registerkarte unter dem Abfrageeingabefeld.

2. Suchen Sie jeden Bereich in der Liste.

3. Klicken Sie auf Zustimmen neben jedem Bereich.

4. Akzeptieren Sie die Zustimmungsaufforderung.

Die vollständige Bereichsreferenz finden Sie unter Microsofts Berechtigungsreferenz.

Schritt 3: Eine Testabfrage ausführen

Setzen Sie die HTTP-Methode auf GET und geben Sie eine der unten stehenden Abfragen in das Feld für die Anforderungs-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/...beginnt. Fügen Sie alles bis (aber nicht einschließlich) des HTTP-Statuscodes in das URL-Feld von Graph Explorer ein.

Dies ist die bevorzugte Option, da sie genau die fehlgeschlagene Anforderung 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 auf eine bestimmte Datei über den Pfad zuzugreifen:

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

Um auf eine Datei auf einer SharePoint-Site zuzugreifen, holen Sie zuerst die Site-ID:

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

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

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

Klicken Sie auf Abfrage ausführen und den Antwortbereich überprüfen.

Schritt 4: Das Ergebnis interpretieren

Der Antwortbereich zeigt einen HTTP-Statuscode und einen JSON-Text. 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 Graph-API-Aufruf war erfolgreich. Die Datei ist auf API-Ebene zugänglich.	Das Problem liegt auf der KONNEKT-Seite oder in der Clientumgebung. Kehren Sie zum Troubleshooting hub.
401 Unauthorized	Der Token fehlt, ist abgelaufen oder ungültig.	Melden Sie sich bei Graph Explorer ab und erneut an. Wenn der Fehler weiterhin besteht, siehe Access token issues.
403 Forbidden	Der angemeldete Benutzer hat keine Berechtigung für diese Datei oder Site.	Kein Problem auf der KONNEKT- oder Microsoft-Backend-Seite. Überprüfen Sie die Berechtigungen in der SharePoint-Weboberfläche.
404 Not Found	Die Datei oder der Ordner existiert nicht unter dem angegebenen Pfad.	Überprüfen Sie den Pfad. Die Datei wurde möglicherweise verschoben, umbenannt oder gelöscht.
429 Too Many Requests	Drosselung durch SharePoint Online.	Ratenbegrenzung auf Microsoft-Seite. Prüfen Sie den Retry-After Header, warten Sie und versuchen Sie es erneut. Einstellungen zur Verhinderung von Drosselung können das erneute Auftreten verringern.
500 Internal Server Error, 503 Service Unavailable, 504 Gateway Timeout	Microsoft-Backend-Fehler.	Das Problem liegt auf der Microsoft-Seite. Fahren Sie mit den nächsten Schritten fort.
UnknownError im Antworttext	Microsoft-Backend-Fehler ohne spezifischen Code.	Wie oben. Erfassen Sie den request-id und eröffnen Sie ein Microsoft-Support-Ticket.

Schritt 5: Beweise erfassen

Bevor Sie Graph Explorer schließen, dokumentieren Sie den Test. Gute Beweise helfen, Support-Tickets 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, [email protected]).

• Der exakte getestete Dateipfad.

• Der request-id Wert aus dem JSON-Antworttext.

• Wiederholen Sie bei intermittierenden Fehlern die Abfrage mehrmals und erfassen Sie jedes Ergebnis.

Schritt 6: Ein Microsoft-Support-Ticket eröffnen

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

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. Wählen Sie SharePoint Online oder OneDrive for Business als betroffenen Dienst aus und stimmen Sie ihn mit dem fehlgeschlagenen Endpunkt ab.

4. Beschreiben Sie das Problem und hängen Sie die Screenshots aus dem vorherigen Schritt an.

5. Fügen Sie die request-id sowohl aus dem KONNEKT-Debugprotokoll als auch aus der Graph-Explorer-Antwort hinzu. Dadurch kann Microsoft die genauen fehlgeschlagenen Anforderungen nachverfolgen.

6. Stellen Sie ausdrücklich fest, dass das Problem in Microsoft Graph Explorer reproduziert wurde.

Das Einfügen von Graph-Explorer-Nachweisen zeigt, dass Ursachen von Drittanbietern bereits ausgeschlossen wurden. Microsoft Support bearbeitet diese Tickets in der Regel schneller.

Häufig verwendete Graph-API-Endpunkte

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

Vorgang	Endpunkt
Benutzerprofil	GET /me
OneDrive-Stammauflistung	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}
Site nach Hostname und Pfad	GET /sites/{hostname}:/{site-path}
SharePoint-Laufwerke auf einer Site	GET /sites/{site-id}/drives
Dateiinhalt herunterladen	GET /drives/{drive-id}/items/{item-id}/content
Delta-Abfrage	GET /drives/{drive-id}/root/delta

Die vollständige Referenz finden Sie im Microsoft Graph Drive API.

Ähnliche Probleme

• Sites fehlen oder Ordner sind leer - bei Backend-Fehlern der SharePoint-Suche

• Access token issues - bei 401 Unauthorized-Antworten

• Umgang mit Fehler(n) - bei Fehlern bei bestimmten Dateien

• Vorbereitung des Debug-Protokolls - wie Protokolle mit Graph-API-Details gesammelt werden

• Protokollierung - Konfiguration des Protokollierungsgrads