Windows服务器安装Apache Airflow遇证书错误及相关问题咨询

一、绕过证书校验的临时方案 #

针对你遇到的SSL证书验证失败问题，可以通过以下方式临时绕过校验（注意：仅建议测试环境使用，生产环境需优先修复证书信任问题）：

1. pip安装时跳过证书校验 #

安装GitPython或其他依赖时，给pip添加参数：

# 指定可信主机（推荐，比直接关闭验证更安全）
pip install GitPython --trusted-host pypi.org --trusted-host files.pythonhosted.org

# 直接关闭SSL验证（风险较高）
pip install GitPython --no-verify-ssl

2. setup.py安装时临时关闭验证 #

在执行setup.py install前，先设置环境变量跳过Python的HTTPS证书校验：

# 仅当前命令行会话生效
set PYTHONHTTPSVERIFY=0
python setup.py install

# 执行完成后建议取消该设置
set PYTHONHTTPSVERIFY=

二、setuptools弃用警告与Python 3.11兼容性说明 #

你遇到的setuptools.installer弃用警告，确实和Python 3.11有关：

• Airflow 2.5.1发布时，Python 3.11尚未被官方正式支持（Airflow从2.6.0版本开始才正式兼容Python 3.11）
• 旧版本setuptools在Python 3.11环境下会触发PEP 517相关的弃用警告

解决办法：

• 升级Airflow到2.6.0及以上版本，直接适配Python 3.11并消除该警告
• 或单独升级setuptools到最新版本：pip install --upgrade setuptools wheel

三、更简便的Airflow安装方式 #

Windows环境下不推荐手动下载源码用setup.py安装，推荐两种更省心的方式：

1. 官方pip安装（适配对应Python版本） #

先确认Python版本与Airflow版本兼容（比如Airflow 2.6.0+支持Python 3.11），然后执行：

# 先升级基础依赖
pip install --upgrade pip setuptools wheel
# 安装指定版本的Airflow，同时跳过证书校验（如果需要）
pip install apache-airflow==2.6.0 --trusted-host pypi.org --trusted-host files.pythonhosted.org

2. 使用WSL（Windows子系统Linux） #

Airflow官方对Linux环境支持更完善，通过WSL安装可避免大量Windows特有的兼容性问题：

• 启用WSL并安装Ubuntu等发行版
• 按照Airflow官方Linux安装流程操作，能规避证书、依赖兼容等问题

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