使用JDBC执行BigQuery查询时SERVICE_ACCOUNT认证获取客户端失败如何解决

该报错的核心触发点为底层抛出的java.lang.IllegalStateException: getTransportChannel() called when needsExecutor() is true，本质原因有两类：

• 依赖版本冲突：项目中引入的Google Cloud gax、grpc相关组件版本，与当前使用的Simba BigQuery JDBC驱动内置依赖版本不兼容。高版本gax-grpc调整了gRPC通道初始化逻辑，要求必须绑定执行器才能创建传输通道，而低版本Simba驱动未适配该逻辑，调用时直接触发异常。
• 依赖缺失：如果使用的是不含内置依赖的轻量版Simba JDBC驱动，缺失gRPC、BigQuery Storage API相关的必要组件，也会触发该报错。

• 优先使用全依赖驱动包：直接选用Simba官方提供的带完整依赖的uber jar包（文件名带-dependencies后缀），替换当前使用的零散驱动依赖，从根源避免版本冲突。如果是Maven/Gradle项目，也可以通过依赖管理配置强制将所有gax、grpc相关组件的版本锁定到驱动兼容的范围，例如Simba 1.3.x版本驱动对应适配的gax-grpc版本不超过2.8.x。
• 禁用Storage API临时规避：如果不需要使用BigQuery Storage Read API做高速查询，可直接在JDBC连接参数中添加EnableBigQueryStorageApi=0配置，驱动会跳过Storage Client初始化逻辑，走传统REST接口执行查询，直接绕过该报错。
• 升级JDBC驱动版本：升级到最新版的Simba BigQuery JDBC驱动，新版本已完成和高版本Google Cloud SDK的适配，修复了该兼容问题。
• 校验服务账号配置：确认JDBC连接参数中服务账号邮箱、私钥路径配置正确，服务账号已分配BigQuery Job User、BigQuery Data Viewer等必要权限，排除权限问题叠加导致的异常。

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