query-exporter连接IBM DB2时报错找不到ibm_db模块如何解决

• Python环境不匹配
  你通过pip3 install ibm_db安装的模块和query-exporter运行时使用的Python解释器不属于同一个环境，这类情况多出现在使用虚拟环境（venv/conda/pyenv等）的场景中。你可以通过以下步骤验证：
  1. 执行which query-exporter获取工具的执行路径，查看路径前缀对应的Python环境
  2. 用对应环境的pip执行<对应环境的pip路径> list | grep ibm-db，确认该环境下是否真的安装了ibm_db
• 缺失SQLAlchemy DB2适配器
  query-exporter底层基于SQLAlchemy实现数据库连接，仅安装ibm_db驱动不足以让SQLAlchemy识别DB2的连接协议，你还需要安装ibm_db_sa适配包：

  pip3 install ibm_db_sa
  

  安装完成后可执行python3 -c "import ibm_db; import ibm_db_sa"测试模块是否能正常导入，如果运行报错则说明驱动本身有问题。
• 系统级依赖缺失
  ibm_db运行依赖IBM官方的Data Server Driver运行库，如果你的系统中没有安装该依赖，即使pip显示ibm_db安装成功，实际导入时也会加载失败，抛出模块找不到的错误。
• DSN格式配置偏差
  确认你的DB2实例端口、数据库名、账号密码配置正确，非默认端口的场景下不要省略端口配置。

这类问题并非DB2独有，所有需要额外SQLAlchemy适配器、系统级运行依赖的数据库都会出现类似的模块找不到报错，常见场景包括：

• Oracle数据库：需要同时安装cx_Oracle驱动、对应SQLAlchemy适配器，以及Oracle客户端运行库
• SQL Server数据库：需要同时安装pyodbc/pymssql驱动、对应SQLAlchemy适配器，以及系统ODBC驱动
• 各类国产数据库（达梦、人大金仓等）：同样需要同时安装原生驱动、SQLAlchemy适配器和对应的系统依赖

内容的提问来源于stack exchange，提问作者Vijay L Marcelin