Snowflake Python Connector代码卡住无输出，请求排查解决

1. 排查网络与连通性 #

• 测试Snowflake端点的网络可达性：
  • Linux/macOS终端运行：nc -zv <你的account>.snowflakecomputing.com 443
  • Windows终端运行：Test-NetConnection <你的account>.snowflakecomputing.com -Port 443
    若无法连通，说明网络防火墙、公司内网限制或代理设置阻断了访问，需联系运维开放Snowflake的IP段或调整代理配置。
• 若使用代理，需在连接参数中添加代理信息：

  ctx = snowflake.connector.connect(
      user='xxxxx',
      password='xxxxx',
      account='xxxxx',
      region='xxxxx',
      warehouse='LOAD_WH',
      proxy_host='<代理IP>',
      proxy_port=<代理端口>,
      proxy_user='<代理用户名>',  # 可选，如需认证
      proxy_password='<代理密码>'  # 可选
  )
  

2. 校验Account参数格式 #

Snowflake账号参数有两种合法格式，两种都尝试测试：

• 格式1：account填短账号ID（如xy12345），region填完整区域标识（如us-west-2.aws）
• 格式2：account直接填完整标识（如xy12345.us-west-2.aws），省略region参数

3. 临时关闭SSL验证（仅测试用，生产环境禁用） #

若本地SSL证书信任问题导致连接卡住，可临时添加参数跳过验证：

ctx = snowflake.connector.connect(
    user='xxxxx',
    password='xxxxx',
    account='xxxxx',
    region='xxxxx',
    warehouse='LOAD_WH',
    ssl_verify=False
)

如果能正常运行，需将Snowflake根证书安装到系统信任库以解决根本问题。

4. 添加超时参数终止无响应连接 #

设置连接和套接字超时，避免无限等待并抛出明确异常：

ctx = snowflake.connector.connect(
    user='xxxxx',
    password='xxxxx',
    account='xxxxx',
    region='xxxxx',
    warehouse='LOAD_WH',
    connect_timeout=30,  # 连接超时（秒）
    socket_timeout=60    # 套接字超时（秒）
)

5. 清理并重装兼容版本依赖 #

彻底清理现有依赖后，安装与2.8.2版本连接器兼容的包：

• 卸载所有相关包：pip uninstall -y snowflake-connector-python pyarrow pandas
• 清理缓存：pip cache purge
• 按顺序安装兼容版本：pip install snowflake-connector-python==2.8.2 pyarrow==10.0.1 pandas==1.5.3

6. 开启调试日志定位卡点 #

添加日志输出，查看连接过程中具体卡在哪个环节：

import logging
import snowflake.connector

logging.basicConfig(level=logging.DEBUG)

ctx=snowflake.connector.connect(
    user= 'xxxxx',
    password='xxxxx',
    account='xxxxx',
    region='xxxxx',
    warehouse='LOAD_WH'
)

cs = ctx.cursor()
try:
    cs.execute("SELECT current_version()")
    one_row = cs.fetchone()
    print(one_row[0])
finally:
    cs.close()
ctx.close()

根据日志输出，确定是连接、认证还是查询阶段出现问题，针对性排查。

7. 检查Warehouse状态 #

登录Snowflake Web UI，确认LOAD_WH仓库处于运行中状态。若仓库处于暂停状态，启动仓库后再测试代码。

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