Docker部署Airflow连接Snowflake报250001连接失败错误求助

问题背景 #

在Windows环境的Docker中部署Airflow 2.6.3或2.7.0版本时，连接Snowflake始终抛出以下错误：

250001: 250001: Could not connect to Snowflake backend after 0 attempt(s).Aborting

错误详情：

Error: snowflake.connector.errors.OperationalError: 250001: 250001: Could not connect to Snowflake backend

切换Snowflake Connector for Python 3.1.0/3.0.4版本无效，相同连接参数在AWS托管Airflow（MWAA）2.6.3中可正常使用。

环境详情 #

• Airflow 2.6.3：搭配Snowflake Connector 3.0.4、Python 3.7.17、Linux-5.10.102.1-microsoft-standard-WSL2-x86_64-with-debian-11.7
• Airflow 2.7.0：搭配Snowflake Connector 3.1.0、Python 3.8.17、Linux-5.10.102.1-microsoft-standard-WSL2-x86_64-with-glibc2.2.5

解决方案 #

1. 验证容器网络连通性 #

进入Airflow worker或scheduler容器，执行以下命令测试Snowflake端点的网络可达性：

curl -v https://<你的Snowflake账户名>.snowflakecomputing.com:443

如果无法建立连接，检查Docker网络配置：

• 避免使用host模式（WSL2下该模式存在网络穿透问题），改用默认bridge模式；
• 确认Windows防火墙未阻止Docker容器的出站443端口请求。

2. 临时禁用OCSP与SSL证书检查（排查用） #

在Snowflake连接参数中添加ocsp_fail_open=True和insecure_mode=True，测试是否为证书验证问题：

from snowflake.connector import connect

conn = connect(
    account="<你的账户>",
    user="<你的用户名>",
    password="<你的密码>",
    warehouse="<你的仓库>",
    database="<你的数据库>",
    schema="<你的 schema>",
    ocsp_fail_open=True,
    insecure_mode=True
)

若连接成功，说明是证书信任问题，需执行下一步配置。

3. 挂载Windows根证书到容器 #

将Windows系统的可信根证书挂载到Docker容器的SSL证书目录，让Snowflake Connector能验证Snowflake的SSL证书：
在docker-compose.yml中添加卷挂载：

services:
  airflow-worker:
    volumes:
      # 挂载Windows根证书目录到容器的SSL证书目录
      - /mnt/c/Windows/System32/certificates/root:/etc/ssl/certs:ro
  # 对airflow-scheduler、airflow-webserver等服务重复上述配置

挂载后重启所有Airflow容器。

4. 降级Snowflake Connector版本 #

部分WSL2环境下，高版本Snowflake Connector存在网络适配问题，降级到2.8.3版本可解决：

pip install snowflake-connector-python==2.8.3

同时确保Airflow的Snowflake Provider版本兼容：

• Airflow 2.6.3：需安装apache-airflow-providers-snowflake>=4.0.0
• Airflow 2.7.0：需安装apache-airflow-providers-snowflake>=5.0.0

5. 配置代理排除规则（若使用代理） #

如果Windows系统启用了代理，需在Docker容器中配置环境变量，排除Snowflake域名：
在docker-compose.yml中添加：

services:
  airflow-worker:
    environment:
      - HTTP_PROXY=http://<你的代理地址>:<端口>
      - HTTPS_PROXY=http://<你的代理地址>:<端口>
      - NO_PROXY=snowflakecomputing.com

确保代理不会拦截Snowflake的连接请求。

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