Python 3.9环境执行pip install chatterbot安装报错如何解决

报错核心原因 #

ChatterBot官方最后一次稳定版更新停留在2020年，未做Python 3.9版本适配，直接执行pip install chatterbot会触发两类固定报错：一是官方指定的旧版本依赖（如低版本sqlalchemy、pytz）无Python 3.9适配的构建包，二是代码中引用的collections.MutableMapping在Python 3.9中已被迁移到collections.abc模块下，触发导入错误。

修复步骤 #

优先选择第一种方案，操作成本最低：

方案1：安装社区适配版（推荐） #

• 清理残留的错误安装文件：

pip uninstall -y chatterbot chatterbot-corpus

• 安装社区维护的、已适配Python 3.9的兼容版本：

pip install chatterbot==1.0.8

方案2：手动适配官方原版（适用于必须使用v1.0.5原版的场景） #

• 跳过原版的依赖版本校验，先安装核心包：

pip install --no-deps chatterbot==1.0.5

• 手动安装适配Python 3.9的依赖版本，避开官方指定的过旧依赖：

pip install pytz python-dateutil "sqlalchemy<1.4" pymongo pint mathparse nltk pyyaml

• 修复语法兼容问题：找到当前Python环境下的chatterbot安装目录，打开chatterbot/conversation.py、chatterbot/tagging.py两个文件，将文件内所有from collections import MutableMapping代码替换为以下兼容写法：

try:
    from collections.abc import MutableMapping
except ImportError:
    from collections import MutableMapping

安装验证 #

执行以下代码无报错、能正常返回回复即代表安装成功：

from chatterbot import ChatBot
test_bot = ChatBot("test_bot")
print(test_bot.get_response("Hi"))

避坑提示：Python 3.10及以上版本需要修改的兼容代码更多，不建议在高于3.9的Python版本上部署旧版ChatterBot。

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