使用bcrypt==4.1.2与FastAPI时版本读取报错的解决咨询

问题根源 #

passlib旧版本在检测bcrypt版本时，依赖bcrypt.__about__.__version__属性，但bcrypt 4.1.x版本移除了__about__模块，直接通过bcrypt.__version__暴露版本号，导致旧版passlib读取失败抛出错误。

修复方法 #

• 升级passlib到最新版本
  这是最稳妥的方案，最新版passlib已经修复了对bcrypt 4.1+的兼容性问题，执行以下命令升级即可：

  pip install --upgrade passlib
  

  升级后无需降级bcrypt，就能正常使用4.1.2版本。

• 手动补全兼容逻辑（临时方案）
  如果暂时无法升级passlib，可以在FastAPI应用启动前添加一段代码，给bcrypt模块模拟出__about__结构：

  import bcrypt
  
  # 模拟bcrypt旧版本的__about__模块结构，适配passlib
  class MockAbout:
      __version__ = bcrypt.__version__
  
  bcrypt.__about__ = MockAbout()
  

  将这段代码放在main.py等入口文件的最顶部，确保passlib加载前已完成补丁。

是否可以忽略该错误？ #

从日志看这个错误是被**捕获(trapped)**的，且后续接口请求（如登录）正常返回200，说明当前核心功能未受影响。但不建议长期忽略：一方面错误日志会干扰排查其他问题，另一方面若后续passlib有依赖版本信息的逻辑，可能引发未知问题，优先建议采用上述修复方案。

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