已安装greenlet但执行Alembic及测试时提示libstdc++.so.6找不到

在Python虚拟环境中执行以下命令：

POSTGRES_USER=admin POSTGRES_PASSWORD=admin POSTGRES_HOST=localhost POSTGRES_DB=postgres alembic revision --autogenerate -m "add new table"

出现以下报错：

ValueError: the greenlet library is required to use this function. libstdc++.so.6: cannot open shared object file: No such file or directory
RuntimeWarning: coroutine 'connect' was never awaited

已完成的排查动作：

• 通过pip freeze | grep greenlet确认已安装greenlet==3.1.1
• 通过find /usr -name libstdc++.so.6 2>/dev/null找到库路径，ls -l /usr/lib/x86_64-linux-gnu/libstdc++.so.6显示该文件是指向libstdc++.so.6.0.33的软链接
• 执行Python测试代码时同样出现libstdc++相关错误

原因分析 #

1. greenlet编译依赖不匹配：虽然安装了greenlet==3.1.1，但该预编译版本可能是针对更高版本的libstdc编译的，当前系统的libstdc.so.6.0.33无法满足其依赖要求；或者greenlet在虚拟环境中安装时，未正确链接到系统的libstdc++库。
2. 虚拟环境隔离导致库路径不可见：Python虚拟环境默认会隔离系统级库，可能导致greenlet运行时无法找到系统中存在的libstdc++.so.6。
3. 协程未正确await触发连锁问题：RuntimeWarning: coroutine 'connect' was never awaited说明数据库连接使用了异步接口但未正确处理协程，这会触发greenlet的协程调度逻辑，进而暴露了底层的库依赖错误。

解决方案 #

方案1：从源码重新编译greenlet适配当前系统

• 卸载现有greenlet：

  pip uninstall -y greenlet
  

• 强制从源码编译安装，确保链接到当前系统的libstdc++：

  pip install greenlet==3.1.1 --no-binary :all:
  

方案2：将libstdc++路径加入虚拟环境的库搜索范围

• 在虚拟环境的site-packages目录下创建sitecustomize.py文件（路径示例：venv/lib/python3.10/site-packages/sitecustomize.py，替换为你的Python版本），添加以下内容：

  import os
  # 将libstdc++所在路径添加到系统库环境变量
  os.environ['LD_LIBRARY_PATH'] = '/usr/lib/x86_64-linux-gnu:' + os.environ.get('LD_LIBRARY_PATH', '')
  

• 重启虚拟环境后重新执行Alembic命令。

方案3：修复协程未await的问题

• 检查项目中数据库连接的代码，确保所有异步连接调用都使用await关键字：

  # 错误写法
  conn = async_db.connect()
  # 正确写法
  conn = await async_db.connect()
  

• 解决协程问题后，可避免触发greenlet的协程调度逻辑，绕过底层库依赖报错。

方案4：降级greenlet版本

• 安装对libstdc++版本要求更低的greenlet版本（如2.0.2）：

  pip uninstall -y greenlet
  pip install greenlet==2.0.2
  

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