Python3.10.8调用inspect.signature(hashlib.md5)触发ValueError的原因及规避方法

异常原因 #

hashlib.md5是CPython用C语言实现的内置哈希函数，这类函数的参数签名并非遵循Python常规的定义格式。usedforsecurity=?是CPython内部用来标记安全相关参数的特殊语法，inspect模块只能解析Python层面定义的函数签名，无法识别这种内部专用格式，因此抛出参数名称无效的错误。

规避方案 #

有几种可行的处理方式：

• 手动构造签名：根据hashlib.md5的实际参数定义，直接用inspect.Signature手动创建符合要求的签名对象，示例代码：

  import inspect
  import hashlib
  
  md5_sig = inspect.Signature(
      parameters=[
          inspect.Parameter('data', inspect.Parameter.POSITIONAL_OR_KEYWORD, default=None),
          inspect.Parameter('usedforsecurity', inspect.Parameter.KEYWORD_ONLY, default=True),
      ]
  )
  

• 直接查看文档字符串：如果只是想获取参数信息，直接打印函数的__doc__属性即可，不需要依赖inspect解析：

  print(hashlib.md5.__doc__)
  

• 捕获异常并降级处理：如果代码逻辑中必须使用inspect.signature，可以通过try-except捕获异常，然后 fallback到手动构造的签名：

  import inspect
  import hashlib
  
  try:
      sig = inspect.signature(hashlib.md5)
  except ValueError:
      # 异常时手动构造正确的签名
      sig = inspect.Signature(
          parameters=[
              inspect.Parameter('data', inspect.Parameter.POSITIONAL_OR_KEYWORD, default=None),
              inspect.Parameter('usedforsecurity', inspect.Parameter.KEYWORD_ONLY, default=True),
          ]
      )
  

内容的提问来源于stack exchange，提问作者mcsoini