在升级到 Python 3.12 之后，运行旧项目或第三方工具时，可能会遇到如下报错：AttributeError: module 'pkgutil' has no attribute 'ImpImporter'。这一问题在依赖较多的项目中尤为常见，例如涉及 ComfyUI 或其扩展节点的环境。错误本身并非代码逻辑问题，而是运行环境与依赖版本不匹配导致的兼容性异常。本文围绕该报错的成因展开说明，并给出在实际工程中可直接操作的解决方案，适合用于自查 Python 运行环境与依赖链问题，也有助于理解 Python 版本升级后对旧依赖产生的影响。文章目录问题原因说解决方案总结问题原因说在 Python 3.12 中，pkgutil.ImpImporter被正式移除。该接口早已被标记为弃用，新的模块加载机制已全面转向importlib。当某些旧版本依赖仍尝试访问ImpImporter时，就会触发 AttributeError。从报错堆栈来看，问题通常出现在pkg_resources/__init__.py，而pkg_resources属于setuptools的一部分。这意味着当前环境中安装的setuptools版本过旧，或者某个第三方包依赖了旧版的setuptools实现。解决方案最直接、也是成功率最高的方式，是升级setuptools到支持 Python 3.12 的版本。python-mpipinstall--upgradesetuptools升级完成后，大多数依赖pkgutil.ImpImporter
