WSL2 Ubuntu中Airflow 2.4.1报TypeError求助

一、pendulum.tz.timezone 调用错误原因及解决 #

错误原因 #

该错误是pendulum版本不兼容导致的。Airflow 2.4.1对pendulum有严格的版本要求（需满足 >=2.0.5,<3.0.0），若安装了pendulum 3.x版本，其内部模块结构发生变化，pendulum.tz.timezone 从可调用对象变成了模块，从而触发 TypeError: 'module' object is not callable。此外，若未通过Airflow官方约束文件安装，也容易出现依赖版本冲突。

解决步骤 #

1. 检查当前虚拟环境中的pendulum版本：

   pip show pendulum
   

2. 卸载不兼容版本并重装指定兼容版本：

   pip uninstall pendulum -y
   pip install pendulum==2.1.2
   

3. （推荐）后续安装Airflow时使用对应版本的官方约束文件，避免依赖冲突：

   pip install "apache-airflow==2.4.1" --constraint "对应Python3.8版本的Airflow官方约束文件"
   

   注：约束文件可从Airflow官方仓库的2.4.1版本分支中获取，无需外链，直接使用对应版本的约束文本即可。

二、依赖包无法构建wheel的原因及影响 #

无法构建wheel的原因 #

这些依赖包的构建失败，大多是因为缺少系统级编译工具或底层依赖库：

• google-re2：需要依赖系统的re2 C++库及编译工具；
• 部分包可能需要Python开发头文件、C/C++编译器等基础编译环境。

解决方法 #

在WSL2 Ubuntu中安装必要的系统依赖：

sudo apt update && sudo apt install build-essential python3-dev libre2-dev

安装完成后重新尝试安装这些依赖包即可。

是否影响Airflow使用 #

这些包均属于Airflow的可选依赖，而非核心依赖：

• unicodecsv：仅用于兼容Python 2，Python 3环境下Airflow核心功能无需依赖它；
• python-nvd3：用于生成UI中的特定图表，不影响任务调度、执行等核心功能；
• google-re2：提供正则表达式的性能优化，未安装时Airflow会自动 fallback 到Python原生正则模块。

因此，即使这些依赖构建失败，Airflow的核心功能仍可正常使用，仅部分非核心的附加功能会受限。

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