2026 年 JDBC Driver 版本说明¶

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

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

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

版本 4.0.2（2026 年 3 月 12 日）¶

将 :codenowrap: commons-compress 依赖项升级到版本 1.28.0，以便处理 CVE-2024-25710 (https://nvd.nist.gov/vuln/detail/CVE-2024-25710) 和 CVE-2024-26308 (https://nvd.nist.gov/vuln/detail/CVE-2024-26308)。

修复了轮询结果时过期会话令牌的续订问题。
修复了在 v4.0.0 中的公开 API 重组期间丢失的微型核心异步初始化被删除的问题。
调整了驱动程序初始化期间的日志记录级别。
为 :codenowrap: nonProxyHosts 正则表达式模式添加了清理功能。
修复了 S3 上传期间文件格式错误的问题。
添加了由远程端关闭的套接字的定期关闭。
将 S3 客户端的多部分阈值恢复为 16 MB。
使用 S3 迭代修复了 fat jar，其中找不到 software.amazon.awssdk.transfer.s3.internal.ApplyUserAgentInterceptor 类。
从着色中移除了 Conscrypt，以防止出现 failed to find class org/conscrypt/CryptoUpcalls 原生错误。
修复了 HOME 目录缓存不可用时的 NullPointerException。
修复了连接 GCP 时的代理身份验证。
修复了在 getStreams() 中忽略调用方提供的架构的错误。
修复了通过 :codenowrap:`NullPointerException ` 表现出来的 S3 错误处理。

修复了在 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)。