Python通过SQLAlchemy连接Snowflake报错250003/250001无法连接怎么办

1 校验基础连接参数正确性 #

• 首先检查account参数格式：不要带https://前缀和.snowflakecomputing.com后缀，非默认区域的账号需要补充区域标识，比如xy12345.ap-southeast-1，不要漏写区域段
• 核对user/password/role/warehouse/database/schema的拼写与大小写：Snowflake对象名默认是大写，如果你创建对象时用了双引号强制小写，参数值也要对应匹配大小写
• 确认账号权限：当前使用的角色必须拥有指定仓库的使用权限、对应库和schema的访问权限，且账号未被限制密码登录方式

2 排查网络连通性问题 #

该报错核心原因大概率是网络无法到达Snowflake服务端，优先执行本地连通性测试，替换你的account值执行命令：

curl -v https://<你的account标识>.snowflakecomputing.com:443

如果curl请求失败，对应排查以下问题：

• 检查是否开启了公司VPN：多数企业VPN会拦截对外的443请求，可先关闭VPN测试，或者给Snowflake连接器配置代理参数，在URL构造时补充proxy_host='你的代理地址', proxy_port=代理端口即可
• 确认防火墙/安全组规则：联系IT确认本地网络防火墙是否放开了Snowflake域名的443出站权限，如果是在云服务器上运行代码，需要检查云安全组的出站规则配置
• 国内访问境外Snowflake节点可拉长超时阈值：在create_engine时补充connect_args={'connect_timeout': 30}参数，避免网络延迟过高导致连接提前中断

3 排查依赖包版本兼容性问题 #

• 确认snowflake-sqlalchemy、snowflake-connector-python、sqlalchemy三者版本匹配，优先升级到最新稳定版测试：

  pip install --upgrade snowflake-connector-python snowflake-sqlalchemy sqlalchemy
  

• 如果升级后仍然报错，可尝试将sqlalchemy降级到1.4版本，部分旧版Snowflake依赖包不兼容sqlalchemy 2.0的语法规则

4 简化测试排除上层封装问题 #

先跳过SQLAlchemy封装，直接用Snowflake原生连接器测试连接，排除上层代码逻辑问题：

import snowflake.connector
conn = snowflake.connector.connect(
    account='xxxx',
    user='xxx',
    password='xxxx',
    database='xxx',
    schema='xxx',
    warehouse='xxx',
    role='xxx'
)
cs = conn.cursor()
try:
    cs.execute("SELECT CURRENT_VERSION()")
    print("连接成功，Snowflake版本为：", cs.fetchone()[0])
finally:
    cs.close()
    conn.close()

如果原生连接可以正常建立，说明是SQLAlchemy的配置问题，可在create_engine时补充execution_options={'autocommit': True}参数重试。

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