
本文详解 @logger.catch 装饰器导致异常被静默吞没的问题,说明其如何干扰 try/except/else 控制流,并提供安全、符合 Python 最佳实践的异常处理方案。
本文详解 `@logger.catch` 装饰器导致异常被静默吞没的问题,说明其如何干扰 `try/except/else` 控制流,并提供安全、符合 python 最佳实践的异常处理方案。
在编写 API 认证函数(如 ShareFile OAuth2 登录)时,一个常见且关键的设计目标是:成功时返回令牌数据,失败时明确抛出异常供上层捕获和处理。但你遇到的现象——except RuntimeError 分支执行后,else 分支仍被触发并打印“Authentication successful”——并非逻辑错误,而是由 @logger.catch 装饰器的行为直接导致。
? 问题根源:@logger.catch 的默认行为
@logger.catch 是 Loguru 提供的异常拦截装饰器,默认行为是:捕获所有未处理异常 → 记录完整 traceback → 吞掉异常(不向上冒泡)→ 函数返回 None。
这意味着你的 authenticate() 函数在 raise RuntimeError(...) 处并未真正中断执行,而是被 @logger.catch 拦截、记录后,悄然返回 None。此时 token = authenticate(...) 实际赋值为 None,try 块无异常抛出,因此 else 分支自然执行。
验证这一点很简单:
@logger.catch
def broken_func():
raise ValueError("test")
result = broken_func() # 日志中会看到错误,但 result 是 None
print(repr(result)) # 输出: None✅ 正确做法:禁用自动吞异常,显式控制流程
要保留日志能力又不破坏异常传播,应禁用 reraise=True(即让异常继续向上抛出),同时手动添加结构化日志:
import requests
from loguru import logger
@logger.catch(reraise=True) # ← 关键:设为 True,异常不再被吞掉
def authenticate(hostname, client_id, client_secret, username, password):
"""Authenticate via username/password. Returns JSON token object on success."""
uri_path = '/oauth/token'
headers = {'Content-Type': 'application/x-www-form-urlencoded'}
params = {
'grant_type': 'password',
'client_id': client_id,
'client_secret': client_secret,
'username': username,
'password': password
}
url = f"{hostname.rstrip('/')}{uri_path}" # 避免双斜杠 //oauth/token
try:
response = requests.post(url, data=params, headers=headers, timeout=30)
response.raise_for_status() # 自动检查 4xx/5xx 并抛出 HTTPError
token = response.json()
logger.info("Authentication succeeded")
return token
except requests.exceptions.RequestException as e:
logger.error(f"Network or request error during auth: {e}")
raise RuntimeError(f"ShareFile API Authentication failed: {e}") from e
except ValueError as e: # JSON decode error
logger.error(f"Invalid JSON response: {e}")
raise RuntimeError("ShareFile API returned invalid JSON") from e✅ 关键改进点:
@logger.catch(reraise=True)确保异常穿透装饰器;- 使用
response.raise_for_status()统一处理 HTTP 错误;- 显式
logger.error/info替代隐式日志,语义更清晰;raise ... from e保留原始异常链,便于调试。
? 上层调用保持简洁可靠
def main():
try:
token = authenticate(
hostname="https://myaccount.sharefile.com",
client_id="your_client_id",
client_secret="your_client_secret",
username="user@example.com",
password="secure_password"
)
logger.info("Authentication successful")
# 继续使用 token...
except RuntimeError as e:
logger.error(f"Authentication failed: {e}")
# 可选:退出、重试、通知等
raise # 或 sys.exit(1)此时日志将严格按预期输出:
- ✅ 认证失败 →
ERROR日志 + 异常抛出 →except执行 →else不执行; - ✅ 认证成功 →
INFO日志 + 返回 token →else执行。
⚠️ 注意事项与最佳实践
-
永远不要依赖
@logger.catch默认行为做业务异常控制:它本质是调试/兜底工具,不是流程控制手段; -
优先使用
requests.raise_for_status():比手动检查status_code更健壮(覆盖所有非 2xx); -
URL 构建注意尾部
/:f"{hostname}{uri_path}"若hostname已含/会导致//oauth/token,建议用rstrip('/'); -
超时必须设置:网络请求无
timeout参数可能导致永久阻塞; -
敏感信息脱敏日志:避免在日志中打印
password、client_secret—— 当前代码已规避,值得保持。
通过以上重构,你的认证函数既具备生产级健壮性,又完全兼容 Python 的异常处理哲学:异常即控制流,日志即上下文,二者各司其职,互不越界。

















