错误码

{
  "code": 40001,
  "message": "请求参数错误",
  "data": {
    "field": "price",
    "reason": "价格必须大于0",
    "value": -100
  }
}

{
  "code": 40101,
  "message": "签名验证失败",
  "data": {
    "reason": "签名计算错误，请检查签名算法",
    "expectedFormat": "HMAC-SHA256(secret, METHOD + PATH + TIMESTAMP + BODY)"
  }
}

{
  "code": 40301,
  "message": "IP 不在白名单",
  "data": {
    "clientIp": "192.168.1.100",
    "reason": "请在控制台添加该 IP 到白名单"
  }
}

{
  "code": 40404,
  "message": "意图不存在",
  "data": {
    "intentId": "intent_123456",
    "reason": "该采购意图可能已被删除或 ID 错误"
  }
}

{
  "code": 40902,
  "message": "状态冲突",
  "data": {
    "intentId": "intent_123",
    "currentStatus": "COMPLETED",
    "reason": "已完成的意图不能被取消"
  }
}

{
  "code": 42901,
  "message": "请求频率超限",
  "data": {
    "limit": 100,
    "current": 105,
    "retryAfter": 60,
    "resetTime": "2026-02-25T10:31:00Z"
  }
}

async function retryWithBackoff(fn: () => Promise<Response>, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fn();
    
    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get('Retry-After') || '60');
      await sleep(retryAfter * 1000);
      continue;
    }
    
    return response;
  }
  
  throw new Error('Max retries exceeded');
}

{
  "code": 50001,
  "message": "服务器内部错误",
  "data": {
    "requestId": "req_1708851000000_abc123",
    "reason": "服务器处理请求时发生错误，请联系技术支持"
  }
}

{
  "code": 50301,
  "message": "服务暂时不可用",
  "data": {
    "reason": "系统正在进行维护升级",
    "estimatedRecoveryTime": "2026-02-25T12:00:00Z",
    "retryAfter": 3600
  }
}

{
  "code": 41002,
  "message": "商品 URL 无效",
  "data": {
    "field": "productUrl",
    "value": "https://invalid-url",
    "reason": "无法访问该商品链接，请检查 URL 是否正确"
  }
}

async function apiCallWithRetry<T>(
  fn: () => Promise<T>,
  options = { maxRetries: 3, backoffMs: 1000 }
): Promise<T> {
  const { maxRetries, backoffMs } = options;
  
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      const shouldRetry = 
        error.code >= 50000 || // 服务器错误
        error.code === 42901;   // 频率限制
      
      if (!shouldRetry || i === maxRetries - 1) {
        throw error;
      }
      
      // 指数退避
      const delay = backoffMs * Math.pow(2, i);
      await sleep(delay);
    }
  }
}

function logApiError(error: ApiError, requestContext: any) {
  console.error('API Error:', {
    code: error.code,
    message: error.message,
    requestId: error.data?.requestId,
    endpoint: requestContext.endpoint,
    method: requestContext.method,
    timestamp: new Date().toISOString(),
  });
}

function getUserFriendlyMessage(errorCode: number): string {
  const messages: Record<number, string> = {
    40001: '请检查输入的信息是否正确',
    40101: '登录信息已过期，请重新登录',
    40404: '未找到相关信息',
    42901: '操作过于频繁，请稍后再试',
    50001: '服务暂时不可用，请稍后再试',
  };
  
  return messages[errorCode] || '操作失败，请稍后再试';
}

interface ErrorMetrics {
  errorCode: number;
  count: number;
  lastOccurrence: Date;
}
 
class ErrorMonitor {
  private metrics = new Map<number, ErrorMetrics>();
  
  track(errorCode: number) {
    const metric = this.metrics.get(errorCode) || {
      errorCode,
      count: 0,
      lastOccurrence: new Date()
    };
    
    metric.count++;
    metric.lastOccurrence = new Date();
    this.metrics.set(errorCode, metric);
    
    // 触发告警
    if (metric.count > 100) {
      this.alert(`Error ${errorCode} occurred ${metric.count} times`);
    }
  }
  
  alert(message: string) {
    // 发送告警通知
    console.warn('ALERT:', message);
  }
}