使用Snowflake Python API连接时遇MaxRetryError问题求助

问题重现 #

使用Snowflake Python API初始化Root连接时出现如下错误：

MaxRetryError(_pool, url, error or ResponseError(cause))urllib3.exceptions.MaxRetryError: HTTPConnectionPool(host='localhost', port=59587) Max retry

代码片段：

from snowflake.core import Root

root = Root(session)

该Root对象用于Snowpark连接、Cron任务调度、存储过程管理、DAG运行及模型日志记录。

错误原因分析 #

这个错误核心是Snowflake API无法连接到指定的本地端口，通常由以下原因导致：

• 会话配置错误，未正确指向Snowflake远程服务
• 代理设置冲突，API误将本地端口作为代理目标
• 网络连通性问题，无法到达Snowflake服务端
• 客户端版本兼容问题
• 本地临时端口被占用或未正常释放

解决方案 #

• 校验会话配置有效性
  确保session是已正确初始化并认证的Snowpark Session，包含完整的账户、权限等信息。示例正确初始化方式：

  from snowflake.snowpark import Session
  connection_params = {
      "account": "你的账户标识符",
      "user": "你的用户名",
      "password": "你的密码",
      "warehouse": "你的仓库",
      "database": "你的数据库",
      "schema": "你的模式",
      "role": "你的角色"
  }
  session = Session.builder.configs(connection_params).create()
  

  若使用SSO等其他认证方式，需确保认证流程已完成，会话处于活跃状态。

• 修正代理配置
  若环境使用代理，需在会话配置中明确指定代理参数，避免API错误连接本地端口：

  connection_params.update({
      "proxy_host": "代理主机",
      "proxy_port": "代理端口",
      "proxy_user": "代理用户名",
      "proxy_password": "代理密码"
  })
  

  无需代理时，检查系统级代理设置是否自动生效，可临时关闭代理测试。

• 测试网络连通性
  验证本地到Snowflake服务端的网络可达性，使用命令测试443端口（Snowflake默认端口）：

  telnet 你的账户标识符.snowflakecomputing.com 443
  

  若无法连通，联系网络团队开放Snowflake相关端口的出站权限。

• 更新客户端依赖
  旧版本Snowflake Python库可能存在兼容性问题，升级到最新稳定版：

  pip install --upgrade snowflake-snowpark-python snowflake-core
  

• 释放本地端口
  错误中的59587是本地临时端口，可能因之前连接未正常关闭导致占用。重启Python进程或本地机器，释放端口后重试。

• 确认账户权限
  确保当前Snowflake角色拥有访问Snowflake Core API所需的权限（如任务调度、存储过程创建、Snowpark操作等），权限不足可能引发连接重试失败。

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