本地安装Airflow启动webserver报错No module named 'airflow.www'如何解决

1. 核对Python环境一致性 #

• 多数该类问题是多Python环境/虚拟环境混用导致，安装Airflow的环境和执行airflow命令的环境不匹配
• 执行以下命令核对路径是否一致：

which python
which airflow

• 若路径不匹配，直接使用安装时对应的Python解释器启动服务即可：

python -m airflow webserver --port 8080

2. 强制重新补全安装依赖 #

如果环境匹配，说明安装过程中依赖拉取不完整，执行强制重新安装：

# 先复用你之前安装时定义的变量，保证版本对齐
export AIRFLOW_VERSION=2.1.3
PYTHON_VERSION="$(python --version | cut -d " " -f 2 | cut -d "." -f 1-2)"
CONSTRAINT_URL="https://raw.githubusercontent.com/apache/airflow/constraints-${AIRFLOW_VERSION}/constraints-${PYTHON_VERSION}.txt"
# 执行重装
pip install --upgrade --force-reinstall "apache-airflow==${AIRFLOW_VERSION}" --constraint "${CONSTRAINT_URL}"

3. 单独补装web组件（可选） #

若重装后仍报错，单独安装web相关依赖包：

pip install apache-airflow[web]==2.1.3

4. 验证修复效果 #

执行以下命令校验模块是否正常加载，无输出即为正常：

python -c "import airflow.www"

校验通过后即可正常启动webserver服务。

内容的提问来源于stack exchange，提问作者Zaynul Abadin Tuhin