> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Exceptions und Fehlerbehandlung

> Erfahren Sie, welche Exceptions das Laravel Copilot SDK wann wirft, wie Sie sie mit throw() abfangen und wie JSON-RPC-Fehler und SessionFs-SQLite-Fehler funktionieren.

## Exceptions und Fehlerbehandlung

Alle Exceptions, die das SDK wirft, befinden sich im Namespace `Revolution\Copilot\Exceptions`. Sie treten auf zwei Arten auf: Einige werden im Session-Ergebnis gehalten und beim Aufruf von `throw()` geworfen, andere werden sofort geworfen, zum Beispiel bei RPC-Aufrufen.

## Session-Fehler und Timeouts

Bei `sendAndWait()` und `Copilot::run()` wird ein Session-Fehler oder Timeout nicht sofort geworfen. Stattdessen wird die Exception im zurückgegebenen `SessionEvent` gehalten. Wie bei Http und Process in Laravel wirft der Aufruf von `throw()` die gehaltene Exception. Liegt kein Fehler vor, macht `throw()` nichts, sodass Sie weitere Methoden verketten können.

```php theme={null}
use Revolution\Copilot\Exceptions\SessionErrorException;
use Revolution\Copilot\Exceptions\SessionTimeoutException;
use Revolution\Copilot\Facades\Copilot;

try {
    $content = Copilot::run('Calculate 1 + 1')->throw()->content();
} catch (SessionTimeoutException $e) {
    // Timeout behandeln
} catch (SessionErrorException $e) {
    // Session-Fehler behandeln
}
```

Um den Erfolg zu prüfen, ohne eine Exception zu werfen, verwenden Sie `failed()` und `successful()`. Details finden Sie unter [SessionEvent](https://kawax.biz/de/packages/laravel-copilot-sdk/session-event.md).

### SessionTimeoutException

Wird gehalten, wenn das Warten auf `session.idle` (Abschluss der Antwort) das Zeitlimit überschreitet. Legen Sie das Zeitlimit mit dem Argument `timeout` von `sendAndWait()` fest. Wenn Sie es weglassen, wird der Konfigurationswert `copilot.timeout` verwendet (standardmäßig 60 Sekunden).

### SessionErrorException

Wird gehalten, wenn die Session über ein `SESSION_ERROR`-Event einen Fehler zurückgibt. Die Nachricht enthält den von der Runtime zurückgegebenen Fehler.

## JsonRpcException

Wird sofort geworfen, wenn die CLI für einen RPC-Aufruf einen JSON-RPC-Fehler zurückgibt. Den JSON-RPC-Fehlercode lesen Sie aus der Eigenschaft `code`, die an den Fehler angehängten Daten aus der Eigenschaft `data`.

```php theme={null}
use Revolution\Copilot\Exceptions\JsonRpcException;
use Revolution\Copilot\Facades\Copilot;

try {
    Copilot::client()->rpc()->ping();
} catch (JsonRpcException $e) {
    $e->code; // JSON-RPC-Fehlercode
    $e->data; // An den Fehler angehängte Daten
}
```

## SessionFsSqliteTransactionFailure

Verwenden Sie diese Exception, wenn Sie einen SessionFs-SQLite-Provider implementieren. Sie fangen sie nicht ab, sondern werfen sie aus `transaction()` des Providers, um der Runtime mitzuteilen, wie der Fehler klassifiziert werden soll. Die Klassifizierung legen Sie mit `errorClass` fest:

* `Fatal` (Standard): ein nicht behebbarer Fehler
* `BusyOrLocked`: nur verwenden, wenn SQLite vor dem Commit BUSY/LOCKED zurückgegeben hat und die Transaktion zurückgerollt wurde
* `PostCommitAmbiguous`: das Ergebnis nach dem Commit lässt sich nicht bestimmen

Jede andere Exception, die aus `transaction()` geworfen wird, wird als `fatal` gemeldet.

```php theme={null}
use Revolution\Copilot\Enums\SessionFSSqliteTransactionErrorClass;
use Revolution\Copilot\Exceptions\SessionFsSqliteTransactionFailure;

throw new SessionFsSqliteTransactionFailure(
    'database is locked',
    SessionFSSqliteTransactionErrorClass::BusyOrLocked,
);
```

## StrayRequestException

Wird vom Test-Fake geworfen, wenn Sie einen Request senden, für den kein passender Fake registriert ist. Tritt sie unerwartet auf, haben Sie vergessen, einen Fake für diesen Request zu registrieren. Wie Sie Fakes verwenden, erfahren Sie unter [Tests](https://kawax.biz/de/packages/laravel-copilot-sdk/fake.md).


## Related topics

- [SessionEvent](https://kawax.biz/de/packages/laravel-copilot-sdk/session-event.md)
- [Externe Prozesse in Paketen ausführen und Process::fake](https://kawax.biz/de/advanced/package-processes.md)
- [Fehlerbehandlung](https://kawax.biz/de/error-handling.md)
- [Queues und Jobs](https://kawax.biz/de/queues.md)
- [Mail-Transports in Paketen registrieren und testen](https://kawax.biz/de/advanced/package-mail-transports.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.