Spring Boot REST API对接Teradata启动时报TeraJDBC兼容错误

报错核心成因 #

该报错并非基础连接配置缺失，根因为驱动版本与连接池默认校验逻辑不兼容：

• 当前使用的TeraJDBC 14.00.00.13为2014年发布的老旧版本，未实现JDBC 4.0规范要求的Connection.isValid()接口方法
• Spring Boot 2.x及以上版本默认集成HikariCP连接池，应用启动初始化阶段会主动调用驱动的isValid()方法完成连接有效性校验，老驱动不支持该方法就会抛出Error 165、SQLState HY000的报错，最终导致Hibernate无法获取数据库元数据，输出对应WARN日志
• 现有配置中的驱动类名、JDBC URL格式、账号密码配置均符合Teradata驱动的官方要求，不存在基础配置项遗漏。

对应解决方案 #

按实施优先级排序：

• 升级Teradata JDBC驱动版本（推荐）
  将原有14.00.00.13版本依赖替换为16.20.00.11及以上的正式版本，tdgssconfig与terajdbc4的版本必须保持完全一致，避免混版引发类冲突。该版本的驱动已完整实现JDBC 4.0规范的isValid()方法，可直接适配Spring Boot默认连接池，无需额外调整业务侧配置。
• 受版本限制无法升级时，调整连接池校验逻辑
  若因合规、生产环境约束必须使用14版本老驱动，可在现有application.properties中追加配置，强制HikariCP使用固定查询SQL完成连接校验，绕开对isValid()方法的调用：

  # 指定连接有效性校验的测试SQL，覆盖默认的isValid方法调用
  spring.datasource.hikari.connection-test-query=SELECT 1
  spring.datasource.hikari.validation-timeout=3000
  

  配置生效后，连接池判断连接有效性时会直接执行上述测试SQL，不再调用老驱动不支持的接口方法。
• 易遗漏的配置排查项
  确认本地Maven仓库未引入多版本Teradata驱动冲突，仅保留一套与生产环境匹配的驱动依赖；使用老版本驱动时，JDBC URL中追加参数需严格遵循TeraJDBC 14版本的参数规范，不要传入高版本才支持的URL参数，避免触发额外连接报错；不要为了适配老驱动手动降级连接池版本，优先通过调整校验逻辑完成兼容适配。

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