导入umap模块无报错挂起退出，咨询调试方案

运行某应用代码时依赖umap模块，执行以下代码时程序挂起后无报错直接退出，print("Imported umap")永远不会执行：

print("Importing umap")
import umap
print("Imported umap") # Never reached.

但单独运行仅导入umap的极简脚本时无法复现该问题，调试发现程序会在不同位置崩溃。运行环境为macOS Sequoia 15.0.1、Python 3.11（也尝试过3.9版本），同事运行相同代码无此问题。

调试步骤 #

• 排查环境依赖冲突

  1. 导出当前环境的依赖列表：pip freeze > current_requirements.txt，和同事的依赖列表对比，重点检查umap-learn版本及其核心依赖（如numpy、scipy、scikit-learn、numba）的版本差异。
  2. 创建全新虚拟环境，先仅安装umap-learn和应用的最小依赖，逐步添加其他依赖，每次添加后测试导入是否正常，定位冲突的依赖包。

• 启用Python导入调试日志
  运行代码时添加-v参数，查看导入过程的详细日志：python -v your_app.py，日志会显示导入umap时加载的每个模块、文件，能定位到挂起时正在处理的具体代码位置。

• 使用系统级工具追踪挂起原因
  在macOS上：

  • 通过Activity Monitor查看Python进程状态，确认是否无响应或资源占用异常。
  • 用lldb附加到挂起进程：先运行应用，挂起后打开终端执行lldb -p <进程PID>，输入thread backtrace查看调用栈，定位底层代码的挂起点（大概率和numba的JIT编译、C扩展模块相关）。

• 检查umap的编译兼容性

  1. 卸载当前umap-learn：pip uninstall -y umap-learn，重新安装时强制从源码编译：pip install --no-binary :all: umap-learn，避免使用可能不兼容macOS Sequoia的预编译wheel包。
  2. 测试numba功能：运行python -c "import numba; numba.test()"，umap依赖numba的JIT编译，若numba异常会直接影响umap导入。

• 排查应用上下文干扰

  1. 逐步移除应用中umap导入前的初始化代码、其他模块导入，每次移除后测试，定位导致冲突的前置逻辑。
  2. 检查是否有线程/进程代码在导入umap前运行，异常的线程状态可能干扰模块导入流程。

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