Fehlerbehandlung

Welche Fehler das SDK meldet, woran du sie erkennst und wie du darauf reagierst.

Fehlerbilder auf einen Blick

Symptom	Ursache
RpcException, Unauthenticated	Kein oder entwertetes Refresh-Token; auch das Bild eines fehlgeschlagenen automatischen Refreshs
RpcException, DeadlineExceeded	Zeitgrenze gerissen — bei DiWaSS-Pfaden meist ein zu knappes Budget, kein Serverfehler
OperationCanceledException	Abbruch über den CancellationToken
RpcException, InvalidArgument, „active provider not set”	Provider-Id ließ sich nicht auflösen (0)
RpcException, InvalidArgument, „Input does not match the expected pattern”	UserId-Variante: mehr als vier Teile, meist Sonderzeichen im Passwort
ArgumentOutOfRangeException auf DefaultTimeout oder WithTimeout	0 oder negativer Wert außer NoTimeout
ArgumentOutOfRangeException auf pollInterval	Poll-Intervall unter 1 Sekunde
InvalidOperationException, „DocXml is null”	Stage-Methode auf einem Handler ohne geladenes oder erzeugtes Dokument
InvalidOperationException, „ZedalDocumentId is not set”	ReloadFromZedal / WaitForDiwassTransfer vor dem ersten Save oder Send
KeyNotFoundException aus LoadFromZedalBy…	Kennung im ZEDAL-Bestand nicht auffindbar — oft nur noch nicht angekommen
DiwassTransferFailedException	DiWaSS hat die Übermittlung abgelehnt; Details am Exception-Objekt
ArgumentException bei DateTime-Parametern	DateTime.Kind ist nicht Utc

Fachliche Ablehnungen aus DiWaSS sind keine Exceptions dieser Liste — sie kommen als Fehlercodes im Ergebnis. Siehe Fehlercodes.