Docker执行faust --version报错：无法从mode.utils.compat导入OrderedDict

问题场景 #

使用Python 3.8环境，无论是faust-streaming==0.10.13还是升级到0.11.0版本，在Dockerfile中执行faust --version时都会触发以下错误：

Traceback (most recent call last):
  File "/usr/local/bin/faust", line 5, in <module>
    from faust.cli.faust import cli
  File "/usr/local/lib/python3.8/dist-packages/faust/cli/faust.py", line 9, in <module>
    from .model import model
  File "/usr/local/lib/python3.8/dist-packages/faust/cli/model.py", line 8, in <module>
    from faust.models import registry
  File "/usr/local/lib/python3.8/dist-packages/faust/models/__init__.py", line 4, in <module>
    from .record import Record
  File "/usr/local/lib/python3.8/dist-packages/faust/models/record.py", line 20, in <module>
    from mode.utils.compat import OrderedDict
ImportError: cannot import name 'OrderedDict' from 'mode.utils.compat' (/usr/local/lib/python3.8/dist-packages/mode/utils/compat.py)
error building image: error building stage: failed to execute command: waiting for process to exit: exit status 1

原因分析 #

faust-streaming依赖的mode库在新版本（>=0.11.0）中移除了mode.utils.compat模块下的OrderedDict导出，但faust-streaming的0.10.x和0.11.0版本仍在引用这个路径的OrderedDict，导致导入失败。

解决方案 #

1. 锁定mode库的兼容版本（推荐） #

在你的依赖声明文件（如requirements.txt）中添加对mode版本的约束，指定与当前faust-streaming兼容的mode版本：

• 对于faust-streaming==0.10.13：添加mode<=0.10.1
• 对于faust-streaming==0.11.0：添加mode==0.10.1

执行安装命令：

pip install -r requirements.txt

或者直接一次性安装：

# 针对0.11.0版本
pip install faust-streaming==0.11.0 mode==0.10.1

2. 修改faust源码（临时应急） #

如果无法调整依赖版本，可以直接修改faust的导入语句：
找到/usr/local/lib/python3.8/dist-packages/faust/models/record.py文件，将第20行的：

from mode.utils.compat import OrderedDict

替换为：

from collections import OrderedDict

Python 3.8及以上版本中，OrderedDict已经直接内置在collections模块中，无需通过兼容层导入。

3. 升级Python版本（可选） #

如果业务允许，将Python版本升级到3.9+，部分新版本的faust-streaming对高版本Python的兼容性更好，可避免此类依赖兼容问题。

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