fc / apps /automation /services /scraper /core /exceptions.py
jun2024's picture
Upload 2241 files
b4f2238 verified
Raw History Blame Contribute Delete
4.17 kB
"""
爬虫服务自定义异常
提供清晰、描述性的异常类,帮助调试和错误处理。
"""
from typing import Any
class ScraperException(Exception):
"""爬虫服务基础异常"""
pass
class BrowserCreationError(ScraperException):
"""
浏览器创建失败异常
当无法创建或启动浏览器时抛出此异常。
包含详细的错误信息以帮助调试。
"""
def __init__(self, message: str, config: dict[str, Any] | None = None, original_error: Exception | None = None):
"""
初始化异常
Args:
message: 错误消息
config: 浏览器配置(用于调试)
original_error: 原始异常
"""
self.config = config
self.original_error = original_error
# 构建详细的错误消息
detailed_message = f"浏览器创建失败: {message}"
if config:
detailed_message += f"\n配置: {config}"
if original_error:
detailed_message += f"\n原始错误: {type(original_error).__name__}: {original_error}"
super().__init__(detailed_message)
class BrowserConfigurationError(ScraperException):
"""
浏览器配置错误异常
当浏览器配置无效时抛出此异常。
"""
def __init__(self, field: str, value: Any, reason: str):
"""
初始化异常
Args:
field: 无效的配置字段名
value: 无效的值
reason: 为什么无效
"""
self.field = field
self.value = value
self.reason = reason
message = f"配置字段 '{field}' 无效: {reason} (值: {value})"
super().__init__(message)
class CaptchaRecognitionError(ScraperException):
"""
验证码识别失败异常
当验证码识别失败且无法恢复时抛出此异常。
"""
def __init__(self, message: str, attempts: int = 0, selector: str | None = None):
"""
初始化异常
Args:
message: 错误消息
attempts: 尝试次数
selector: 验证码元素选择器
"""
self.attempts = attempts
self.selector = selector
detailed_message = f"验证码识别失败: {message}"
if attempts > 0:
detailed_message += f" (尝试次数: {attempts})"
if selector:
detailed_message += f" (选择器: {selector})"
super().__init__(detailed_message)
class CookieLoadError(ScraperException):
"""
Cookie 加载失败异常
当无法加载或应用 Cookie 时抛出此异常。
"""
def __init__(self, message: str, site_name: str | None = None, account: str | None = None):
"""
初始化异常
Args:
message: 错误消息
site_name: 网站名称
account: 账号
"""
self.site_name = site_name
self.account = account
detailed_message = f"Cookie 加载失败: {message}"
if site_name:
detailed_message += f" (网站: {site_name})"
if account:
detailed_message += f" (账号: {account})"
super().__init__(detailed_message)
class LoginError(ScraperException):
"""
登录失败异常
当登录过程失败时抛出此异常。
"""
def __init__(
self, message: str, account: str | None = None, reason: str | None = None, screenshot_path: str | None = None
):
"""
初始化异常
Args:
message: 错误消息
account: 账号
reason: 失败原因
screenshot_path: 错误截图路径
"""
self.account = account
self.reason = reason
self.screenshot_path = screenshot_path
detailed_message = f"登录失败: {message}"
if account:
detailed_message += f" (账号: {account})"
if reason:
detailed_message += f" (原因: {reason})"
if screenshot_path:
detailed_message += f" (截图: {screenshot_path})"
super().__init__(detailed_message)