导入BERTopic时出现UMAP导入错误的问题求助

问题背景 #

• 此前代码运行正常，hdbscan故障后重装所有包，现在遇到UMAP相关导入错误
• 单独导入UMAP（import umap或import umap.umap_ as UMAP）可正常执行，但导入BERTopic时触发报错：ImportError: cannot import name 'UMAP' from 'umap' (unknown location)
• 已尝试多种导入顺序组合，均无效；环境未变更：Python 3.10.7、VS Code 1.74.3、BERTopic 0.13.0、umap-learn 0.5.3

解决步骤 #

1. 排查本地命名冲突 #

确保当前工作目录下没有名为umap.py的文件，这类本地文件会覆盖第三方包的导入路径。如果存在，立即重命名该文件。

2. 彻底重装依赖并清理缓存 #

执行以下命令，完全卸载相关包并清理pip缓存后重新安装指定版本：

pip uninstall -y umap-learn bertopic
pip cache purge
pip install umap-learn==0.5.3 bertopic==0.13.0

3. 手动修复UMAP导入映射（临时补丁） #

如果重装后问题仍存在，可在导入BERTopic前手动修正UMAP的模块映射：

import sys
import umap.umap_ as UMAP

# 将UMAP类绑定到umap模块的命名空间
sys.modules['umap.UMAP'] = UMAP
sys.modules['umap'].UMAP = UMAP

from bertopic import BERTopic

4. 验证依赖版本兼容性 #

检查当前环境的关键依赖版本，确保无冲突：

pip list | grep -E "(umap-learn|bertopic|hdbscan)"

注：BERTopic 0.13.0建议搭配hdbscan 0.8.29及以上版本，若hdbscan版本过低，需同步升级。

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