File size: 3,951 Bytes
e0b68d2 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 | #!/usr/bin/env python
# -*- coding: utf-8 -*-
"""上游服务异常类。
用于处理上游 API(如 z.ai)返回的错误。
"""
from typing import Any, Dict, Optional
from app.exceptions.base import AppError
class UpstreamError(AppError):
"""上游服务错误基类。
当上游 API 返回错误时抛出。
Attributes:
upstream_code: 上游返回的错误码
upstream_status: 上游返回的 HTTP 状态码
Example:
>>> raise UpstreamError("Upstream API error", upstream_code=50001, upstream_status=500)
"""
def __init__(
self,
message: str,
upstream_code: Optional[int] = None,
upstream_status: Optional[int] = None,
upstream_type: Optional[str] = None,
details: Optional[Dict[str, Any]] = None,
) -> None:
final_details = details or {}
if upstream_code is not None:
final_details["upstream_code"] = upstream_code
if upstream_status is not None:
final_details["upstream_status"] = upstream_status
if upstream_type is not None:
final_details["upstream_type"] = upstream_type
super().__init__(
message=message,
code="upstream_error",
status_code=502, # Bad Gateway
details=final_details,
)
class UpstreamRateLimited(UpstreamError):
"""上游限流异常。
当上游 API 返回 429 状态码时抛出。
Example:
>>> raise UpstreamRateLimited(retry_after=30)
"""
def __init__(
self,
message: str = "Upstream rate limited",
retry_after: Optional[int] = None,
) -> None:
details = {}
if retry_after is not None:
details["retry_after"] = retry_after
super().__init__(
message=message,
upstream_status=429,
details=details,
)
self.code = "rate_limited"
self.status_code = 429
class UpstreamTimeout(UpstreamError):
"""上游超时异常。
当上游 API 响应超时时抛出。
Example:
>>> raise UpstreamTimeout(timeout=30.0)
"""
def __init__(
self,
message: str = "Upstream request timeout",
timeout: Optional[float] = None,
) -> None:
details = {}
if timeout is not None:
details["timeout_seconds"] = timeout
super().__init__(message=message, details=details)
self.code = "upstream_timeout"
self.status_code = 504 # Gateway Timeout
class UpstreamConnectionError(UpstreamError):
"""上游连接失败异常。
当无法连接到上游 API 时抛出。
Example:
>>> raise UpstreamConnectionError("Connection refused")
"""
def __init__(
self,
message: str = "Failed to connect to upstream",
reason: Optional[str] = None,
) -> None:
details = {}
if reason:
details["reason"] = reason
super().__init__(message=message, details=details)
self.code = "upstream_connection_error"
self.status_code = 503 # Service Unavailable
class UpstreamAuthenticationError(UpstreamError):
"""上游认证失败异常。
当上游 Token 失效或无效时抛出。
Example:
>>> raise UpstreamAuthenticationError("Token expired")
"""
def __init__(
self,
message: str = "Upstream authentication failed",
token_hint: Optional[str] = None,
) -> None:
details = {}
if token_hint:
details["token_hint"] = token_hint
super().__init__(
message=message,
upstream_status=401,
details=details,
)
self.code = "upstream_auth_error"
self.status_code = 401 |