Snowflake JDBC连接异常：无法初始化CredentialManagerHolder类

问题场景 #

调用DriverManager.getConnection(props.getProperty("jdbcUrl"), props)时出现系列错误：

• 初始两类错误：
  • 数据库错误：ERROR: value too long for type character varying(512)
  • JNA签名错误：java.lang.UnsatisfiedLinkError（JNA临时文件未签名导致）
• 执行签名命令codesign -s - /Users/shivamanand/Library/Caches/JNA/temp/jna6070831141161195482.tmp修复签名后，出现核心错误：
  java.lang.NoClassDefFoundError: Could not initialize class net.snowflake.client.core.CredentialManager$CredentialManagerHolder
• 环境信息：
  • snowflake-jdbc版本：3.12.15（升级后问题依旧）
  • 系统：Mac M1 OS X Big Sur
  • SnowSQL CLI可正常连接，但Snowflake CredentialManager相关日志未出现预期JNA提示，无法定位根本原因

排查与解决建议 #

1. 处理character varying(512)过长错误 #

• 检查JDBC连接属性中的参数值，确认是否存在超过512字符的内容（比如自定义会话参数、过长的配置值），缩短或清理这类参数。
• 若使用连接池，排查连接池是否自动追加了超长参数，移除无效或冗余的配置项。

2. 彻底解决JNA临时文件签名问题（适配Mac M1） #

手动签名临时文件仅为临时方案，可通过以下方式彻底修复：

• 添加JVM启动参数-Djna.nosys=true，强制JNA使用纯Java实现，绕开本地库的签名验证流程。
• 若需使用本地JNA库，可调整系统安全设置（不推荐，存在安全风险）：打开「系统偏好设置」-「安全性与隐私」-「通用」，解锁后允许未签名软件运行，重启应用后重试。

3. 解决CredentialManagerHolder初始化失败 #

• 检查依赖完整性：通过mvn dependency:tree（Maven）或gradle dependencies（Gradle）查看依赖树，排除JNA版本与snowflake-jdbc自带JNA的冲突，确保依赖无重复或缺失。
• 升级JDBC版本：尝试升级至支持Apple Silicon架构的最新稳定版（如3.13.x及以上），旧版本对M1 ARM架构兼容性不足。
• 禁用CredentialManager：在JDBC连接属性中添加USE_CREDENTIAL_MANAGER=false和CLIENT_SESSION_KEEP_ALIVE=false，绕开CredentialManager的初始化流程。
• 开启调试日志：添加JVM参数-Dorg.slf4j.simpleLogger.defaultLogLevel=debug，查看CredentialManager初始化阶段的详细日志，定位具体异常点。

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