.NET 6 C#使用Snowflake.Data连接Snowflake数据库超时报错

你遇到的「凭据对错报错一致、固定卡120秒超时、snowcd检测全过、其他数据库连接正常」是非常典型的Snowflake .NET客户端连接故障，按出现概率从高到低排查以下诱因即可：

• ACCOUNT连接参数格式错误（最高发）
  绝大多数该类问题都是ACCOUNT参数只填了账号短名，没有补全地域和云厂商后缀导致的。Snowflake非默认部署区（非AWS美西2区）的实例，ACCOUNT参数必须填写完整的端点前缀，比如账号短名为corp、部署在Azure华东区的实例，正确ACCOUNT值为corp.china-east-2.azure。如果只填短名，客户端会默认请求美西2区的公网端点，在网络不通的情况下不会立刻返回解析错误，会直接卡满默认120秒超时才抛错；且该阶段请求还没走到凭据校验环节，所以填对填错密码返回的报错完全一致。
  修复方式：登录Snowflake网页控制台，从浏览器地址栏的URL里复制snowflakecomputing.com前面的完整字符串作为ACCOUNT参数值，不要手动拼接。

• .NET 6默认IPv6优先策略导致连接挂起
  .NET 6 对内置HttpClient做了策略调整，默认优先尝试IPv6连接。如果你的运行环境不支持IPv6路由到Snowflake服务端，客户端会等待IPv6连接超时后才回退IPv4，等待时长刚好为120秒。而snowcd诊断工具默认优先走IPv4检测，所以会出现检测全过但客户端连接失败的现象。
  修复方式二选一即可：

  1. 在连接字符串中添加CONNECTION_TIMEOUT=30缩短超时阈值，同时添加VALIDATE_DEFAULT_PARAMETERS=true强制客户端优先使用IPv4连接
  2. 在程序启动入口（Program.cs最开头）添加以下配置，全局禁用HttpClient的IPv6优先逻辑：

  AppContext.SetSwitch("System.Net.Http.DisableIPv6", true);
  

• 企业代理配置未被客户端读取
  如果你所在网络需要通过企业代理访问公网，Snowflake.Data默认不会自动读取系统代理配置，会直接发起直连导致卡超时；而snowcd工具默认继承系统代理规则，因此诊断结果会全部正常。
  修复方式：在连接字符串中显式配置代理参数：

  USEPROXY=true;
  PROXYHOST=代理服务地址;
  PROXYPORT=代理端口;
  PROXYUSER=代理认证用户名（无认证可省略）;
  PROXYPASSWORD=代理认证密码（无认证可省略）;
  

• 客户端版本兼容Bug
  2.0.20版本之前的Snowflake.Data在.NET 6/7环境下存在已知的异步连接死锁Bug，无论网络是否正常，调用OpenAsync()都会固定挂起120秒后抛出超时错误。
  修复方式：通过NuGet包管理器将Snowflake.Data升级到2.0.20及以上的稳定正式版，不要使用预览版本。

快速验证顺序：先替换ACCOUNT参数为控制台URL中的完整前缀，升级客户端到最新稳定版，将连接超时设置为15秒，先调用同步Open()方法测试，若仍失败再依次排查IPv6策略和代理配置。

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