
本文讲解在 Python 函数中同时支持「成功时返回有效值、失败时抛出异常」的最佳实践,重点解决因装饰器(如 @logger.catch)意外吞没异常导致 else 分支误执行的问题。
本文讲解在 python 函数中同时支持「成功时返回有效值、失败时抛出异常」的最佳实践,重点解决因装饰器(如 `@logger.catch`)意外吞没异常导致 `else` 分支误执行的问题。
在 API 认证等关键流程中,我们常希望函数具备明确的控制流语义:成功则返回结果(如 token),失败则立即中断并抛出异常,以便调用方通过 try/except 精准捕获和处理错误。然而,你的代码中出现了 else 块在异常发生后仍被执行的反常现象,根本原因在于 @logger.catch 装饰器的默认行为——它会自动捕获并记录所有未处理异常,然后继续执行后续代码(包括隐式返回 None),从而破坏了 try/except/else 的语义契约。
else 子句仅在 try 块中未发生任何异常时执行。一旦 authenticate() 抛出 RuntimeError,本应跳过 else 直接进入 except;但 @logger.catch 拦截了该异常、完成日志后让函数“静默返回”,使 token = authenticate(...) 实际赋值为 None,整个 try 块看似“无异常完成”,进而触发 else。
✅ 正确做法:禁用 @logger.catch 的异常吞没行为
将装饰器改为显式声明不抑制异常:
from loguru import logger
@logger.catch(reraise=True) # 关键:reraise=True 强制重新抛出异常
def authenticate(hostname, client_id, client_secret, username, password):
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}" # 修复 URL 拼接(避免 //)
try:
response = requests.post(url, data=params, headers=headers, timeout=15)
response.raise_for_status() # 自动检查 4xx/5xx 并抛出 HTTPError
return response.json()
except requests.exceptions.RequestException as e:
raise RuntimeError(f"ShareFile API request failed: {e}") from e
except ValueError as e: # JSON 解析失败
raise RuntimeError(f"Invalid JSON response: {e}") from e
? 注意:
reraise=True是@logger.catch的核心参数,确保异常被记录后原样向上冒泡,不被吞没;- 使用
response.raise_for_status()替代手动检查status_code,更符合 Requests 最佳实践;data=params(非params=)才符合 OAuth2 表单提交规范(application/x-www-form-urlencoded);url拼接增加rstrip('/')避免重复斜杠(如"https://sharefile.com//oauth/token")。
✅ 调用端保持清晰结构
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="your_password"
)
logger.info("Authentication successful")
# 后续使用 token...
except RuntimeError as e:
logger.error(f"Authentication failed: {e}")
# 可选择退出或重试
raise # 或 sys.exit(1)
except Exception as e:
logger.exception("Unexpected error during authentication")
raise
? 总结
- ❌ 错误认知:
@logger.catch默认是“安全兜底”,适合开发调试,绝不适用于需严格异常传播的业务逻辑函数; - ✅ 正确姿势:对关键函数启用
@logger.catch(reraise=True),兼顾日志与控制流完整性; - ✅ 进阶建议:将认证逻辑封装为类(如
ShareFileAuthClient),支持 Token 缓存、自动刷新与统一错误类型(如自定义AuthError),提升可维护性与测试性。
遵循以上方式,即可确保函数真正实现「成功返回值 / 失败抛异常」的二元契约,让 try/except/else 恢复其设计本意。










