error-handling-expert（错误处理专家）

Error Handling Expert Skill

Expert in error handling patterns, exception management, error responses, logging, and error recovery strategies for React, Next.js, and NestJS applications.

When to Use

• Implementing error handling
• Creating exception filters
• Designing error responses
• Setting up error logging
• Implementing error recovery
• Handling async errors
• Creating error boundaries
• Implementing retry logic

Project Context Discovery

Before providing guidance:

1. Check .agents/SYSTEM/ARCHITECTURE.md for error patterns
2. Review existing exception filters
3. Check for error monitoring (Sentry, Rollbar)
4. Review logging libraries (Winston, Pino)

Core Principles

Error Types

Application Errors: 400, 401, 403, 404, 409, 422 System Errors: 500, 502, 503, 504

Error Response Format

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

Quick Patterns

NestJS Exception Filter

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

React Error Boundary

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

Retry with Backoff

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

Best Practices

• User-friendly messages, no sensitive info
• Log all errors with context
• Integrate error monitoring (Sentry)
• Implement retry logic and circuit breakers
• Provide fallback values
• Test error cases

Recovery Strategies

1. Retry Logic - Exponential backoff
2. Circuit Breaker - Prevent cascade failures
3. Fallback Values - Graceful degradation

For complete exception filter implementations, custom exceptions, validation pipe setup, error boundaries, circuit breaker pattern, logging integration, and database/API error patterns, see: references/full-guide.md