""" 工具函数模块 包含通用的工具函数和辅助方法 """ import uuid import time import logging from typing import Optional from loguru import logger from config import Config class Utils: """工具函数集合""" @staticmethod def generate_request_id() -> str: """生成请求ID""" return str(uuid.uuid4()) @staticmethod def generate_token_id(refresh_token: str) -> str: """生成token的唯一标识符(用于日志显示)""" # 使用token的前8位和后8位作为标识符 if len(refresh_token) >= 16: return f"TOKEN_{refresh_token[:8]}...{refresh_token[-8:]}" else: return f"TOKEN_{refresh_token[:8]}..." @staticmethod def get_current_timestamp() -> int: """获取当前时间戳""" return int(time.time()) @staticmethod def validate_api_key(api_key: str) -> bool: """验证API密钥""" config = Config() return api_key in config.VALID_API_KEYS @staticmethod def extract_bearer_token(auth_header: str) -> Optional[str]: """从Authorization头中提取Bearer token""" if not auth_header: return None parts = auth_header.split(" ") if len(parts) != 2 or parts[0].lower() != "bearer": return None return parts[1] @staticmethod def setup_logging(): """设置loguru日志配置""" # 移除默认的日志处理器 logger.remove() # 添加控制台日志输出,带颜色和格式 logger.add( sink=lambda x: print(x, end=""), format="{time:YYYY-MM-DD HH:mm:ss} | {level: <8} | {name}:{function}:{line} - {message}", level="INFO", colorize=True ) # 根据环境变量决定是否启用文件日志 if Config.enable_file_logging(): logger.add( "warp_api_server.log", rotation="10 MB", retention="7 days", level="DEBUG", format="{time:YYYY-MM-DD HH:mm:ss} | {level: <8} | {name}:{function}:{line} - {message}", encoding="utf-8" ) logger.info("📝 文件日志已启用: warp_api_server.log") else: logger.info("📝 文件日志已禁用 (可通过环境变量 ENABLE_FILE_LOGGING=true 启用)") # 配置标准logging的loguru处理器 class InterceptHandler(logging.Handler): def emit(self, record): # 获取对应的loguru级别 try: level = logger.level(record.levelname).name except ValueError: level = record.levelno # 查找调用者位置 frame, depth = logging.currentframe(), 2 while frame.f_code.co_filename == logging.__file__: frame = frame.f_back depth += 1 logger.opt(depth=depth, exception=record.exc_info).log( level, record.getMessage() ) # 替换所有标准logging处理器 logging.basicConfig(handlers=[InterceptHandler()], level=0, force=True) logging.getLogger("urllib3").setLevel(logging.WARNING) logger.info("🚀 Loguru日志系统初始化完成") @staticmethod def deduplicate_tokens(tokens: list) -> list: """去重token列表,保持顺序""" seen = set() result = [] for token in tokens: if token and token not in seen: seen.add(token) result.append(token) return result @staticmethod def validate_refresh_token_format(token: str) -> bool: """验证refresh token格式是否有效""" if not token or not isinstance(token, str): return False # 基本长度检查 if len(token) < 100: return False # 检查是否包含必要的字符 if not any(c.isalnum() for c in token): return False return True