error-handling-expert

エラーハンドリングのエキスパートスキル

使用する場面

• エラーハンドリングを実装するとき
• 例外フィルターを作成するとき
• エラーレスポンスを設計するとき
• エラーロギングを設定するとき
• エラー復旧を実装するとき
• 非同期エラーを処理するとき
• エラーバウンダリーを作成するとき
• リトライロジックを実装するとき

プロジェクトコンテキストの確認

ガイダンスを提供する前に、次のことを確認します。

1. .agents/memory/ でプロジェクトのアーキテクチャとエラーパターンを確認します
2. 既存の例外フィルターを確認します
3. エラー監視（Sentry、Rollbar）があるか確認します
4. ロギングライブラリ（Winston、Pino）を確認します

基本原則

エラーの種類

アプリケーションエラー： 400、401、403、404、409、422 システムエラー： 500、502、503、504

エラーレスポンスの形式

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation failed",
    "details": [...],
    "timestamp": "2025-01-01T00:00:00Z",
    "path": "/api/users",
    "requestId": "req-123456"
  }
}

クイックパターン

NestJS 例外フィルター

@Catch()
export class AllExceptionsFilter implements ExceptionFilter {
  catch(exception: unknown, host: ArgumentsHost) {
    // Log, format, respond
  }
}

React エラーバウンダリー

class ErrorBoundary extends React.Component {
  componentDidCatch(error, errorInfo) {
    // Log to monitoring
  }
}

バックオフを伴うリトライ

async function retryWithBackoff<T>(fn, maxRetries = 3): Promise<T>

ベストプラクティス

• ユーザーにわかりやすいメッセージを使い、機密情報は含めません
• すべてのエラーをコンテキストとともに記録します
• エラー監視（Sentry）を統合します
• リトライロジックとサーキットブレーカーを実装します
• フォールバック値を用意します
• エラーケースをテストします

復旧戦略

1. リトライロジック - 指数バックオフ
2. サーキットブレーカー - 障害の連鎖を防止します
3. フォールバック値 - グレースフルデグラデーション

---

例外フィルターの完全な実装、カスタム例外、バリデーションパイプの設定、エラーバウンダリー、サーキットブレーカーパターン、ロギングの統合、データベース／API のエラーパターンについては、次を参照してください： references/full-guide.md