2026 年 JDBC Driver 版本说明¶

本文包含 JDBC Driver 的版本说明，包括以下内容（如果适用）：

Snowflake 对 JDBC Driver 更新使用语义版本控制。

有关文档，请参阅 JDBC 驱动程序。

版本 4.0.1（2026 年 2 月 9 日）¶

修复了在 client_encryption_key_size 账户参数设置为 256 的情况下将文件上传至 S3 时不正确的加密算法选择。
修复了在 fat jar 中找不到 software.amazon.awssdk.transfer.s3.internal.ApplyUserAgentInterceptor 类的问题。
从 shading 中移除了 Conscrypt，以防出现找不到 org/conscrypt/CryptoUpcalls 类时出现的原生错误。
修复了枚举名称更改后导致的外部浏览器认证问题，该问题会引发“Invalid connection URL:Invalid SSOUrl found”错误。
将外部浏览器身份验证器名称回滚为了 externalbrowser。
更新了 BouncyCastle 依赖项以解决 CVE-2025-8916 (https://nvd.nist.gov/vuln/detail/CVE-2025-8916) 和 CVE-2025-8885 (https://nvd.nist.gov/vuln/detail/CVE-2025-8885) 漏洞。

重要

由于一些底层问题，Snowflake 建议如果 AWS 和 Azure 客户使用 PUT 或 GET 查询，不要升级到此版本。Snowflake 建议直接升级到版本 4.0.1。如果您已经升级到此版本，请尽快升级到版本 4.0.1。

公共 API 进行了重组，并且所有公共 APIs 已移至 net.snowflake.client.api.* 包层次结构：
- 弃用了 net.snowflake.client.jdbc.SnowflakeDriver。您现在应该改用 net.snowflake.client.api.driver.SnowflakeDriver。
- 在公共 API 中添加了统一的 QueryStatus 类，替换已弃用的 QueryStatus 枚举和 QueryStatusV2 类。
- 添加了新的 DownloadStreamConfig 和 UploadStreamConfig 公共 API 接口，用于流上传/下载配置。
- 在公共 API 中添加了 SnowflakeDatabaseMetaData 接口，用于数据库元数据操作。
- 在公共 API 中添加了 SnowflakeAsyncResultSet 接口，用于异步查询操作。
- 在公共 API 中添加了 SnowflakeResultSetSerializable 接口。
- 将内部类移到了 net.snowflake.client.internal.* 包层次结构。
有关更多信息，请参阅从 JDBC 驱动程序 3.x 迁移到 JDBC 驱动程序 4.x。
将 net.snowflake.jdbc.enableBouncyCastle 中的 BouncyCastle JVM 属性重命名为 net.snowflake.jdbc.useBundledBouncyCastleForPrivateKeyDecryption。
移除了以前弃用的类和方法：
- 移除了已弃用的 com.snowflake.client.jdbc.SnowflakeDriver 类。
- 从 net.snowflake.client.core 包中移除了已弃用的 QueryStatus 枚举。
- 从 net.snowflake.client.jdbc 包中移除了已弃用的 QueryStatusV2 类。
- 从 net.snowflake.client.jdbc 包中移除了已弃用的 SnowflakeType 枚举。

从 AWS SDK v1 迁移到 AWS SDK v2，实现优化的性能和现代化 API 支持。
将 Azure Storage SDK 从版本 5 升级到版本 12。
将 nimbus-jose-jwt OAuth2 依赖项升级到版本 11.30.1。
将 netty 升级到版本 4.1.130.Final，以解决 CVE-2025-67735 (https://nvd.nist.gov/vuln/detail/CVE-2025-67735)。