应提前用 inspect.bind 绑定参数并快照，而非在 except 中依赖 locals() 或回溯；bind 可严格解析位置/关键字参数及默认值，避免运行时变量不完整问题，且需妥善处理绑定失败等边界情况。
装饰器捕获异常时如何安全获取函数参数
直接在 except 块里用 inspect.signature 或 locals() 拿参数不可靠——异常可能发生在函数体开头、中间，甚至参数校验前，locals() 可能不完整或已被修改。真正稳妥的方式是**在函数调用前就提取并快照参数**，再包进异常处理逻辑。
推荐用 inspect.bind 提前绑定参数，它能严格按签名解析位置参数、关键字参数、默认值，且不依赖运行时局部变量：
import inspect
import functools
<p>def log_on_exception(func):
sig = inspect.signature(func)
@functools.wraps(func)
def wrapper(*args, **kwargs):
try:</p><h1>绑定参数，生成确定的参数字典（含默认值）</h1><pre class="brush:php;toolbar:false;"> bound = sig.bind(*args, **kwargs)
bound.apply_defaults()
args_dict = bound.arguments
except TypeError as e:
# 参数绑定失败（如传了不存在的 kwarg），也记录
args_dict = {'args': args, 'kwargs': kwargs, 'bind_error': str(e)}
try:
return func(*args, **kwargs)
except Exception as e:
print(f"[ERROR] {func.__name__} raised {type(e).__name__}: {e}")
print(f" Args: {args_dict}")
raise
return wrapper
为什么不能只用 sys.exc_info() + traceback 回溯参数
因为标准回溯（traceback.format_exc()）只包含代码位置和异常类型/消息，**不保存调用时的参数快照**。你看到的 locals() 是异常发生点的局部变量，不是入口参数——比如函数里做了 data = process(args) 后抛错，locals() 里只有 data，没有原始 args。
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 试图在
except中用inspect.currentframe().f_back.f_locals取上层 locals：极不稳定，CPython 实现细节，PyPy/多线程下易失效 - 依赖
__code__.co_varnames手动拼接：无法处理 *args、**kwargs、缺省参数，也不知哪些变量对应原始入参 - 装饰器外再套一层闭包捕获参数：可行但冗余，不如
bind直接、语义清晰
实际使用时要注意的三个边界情况
这个模式在多数场景有效，但以下情况需额外处理：
-
func使用了*args或**kwargs且内部动态解包：bound.arguments会把args存为 tuple、kwargs存为 dict，这是正确行为；若需展开显示，可加if 'args' in args_dict: args_dict['args'] = list(args_dict['args']) - 参数含不可序列化对象（如文件句柄、socket）：打印时会触发
repr，可能报错或输出无意义内容；建议在日志前加try/except repr保护，或用pprint.saferepr - 高并发场景下频繁打印大参数：考虑用
logging.getLogger(...).debug(...)替代print，并设日志级别为DEBUG，避免生产环境误开
如果函数本身有 type hint 或文档字符串，能自动增强日志吗
可以，但要明确目的：type hint 不影响运行时参数值，只是提供元数据。你可以在装饰器里读取 sig.return_annotation 或 func.__doc__，加到日志里辅助定位，比如：
# 在 except 块中追加：
if func.__doc__:
doc_first_line = func.__doc__.strip().split('\n')[0]
print(f" Doc: {doc_first_line[:60]}...")
if sig.return_annotation is not inspect.Signature.empty:
print(f" Returns: {sig.return_annotation}")
不过注意，type hint 的字符串表示（如 Union[str, int]）可能被 typing 模块简化或重写，别拿它做逻辑判断，仅作参考。
最常被忽略的是参数绑定失败的兜底处理——比如用户传了签名里没有的 keyword argument，sig.bind() 就会抛 TypeError，这时你得确保自己的装饰器不会因此静默崩溃，必须把这类错误也纳入日志路径。
