SQLFeatureNotSupportedException是JDBC运行时异常，表示驱动不支持所调用方法，非代码错误而是能力缺失；常见于老/轻量驱动对JDBC新特性支持不全，如isValid()、setObject()、getObject(Class)等，需通过堆栈定位具体方法并改用兼容写法或升级驱动。
SQLFeatureNotSupportedException 是 Java JDBC 中一个运行时异常，表示当前数据库驱动不支持你调用的某个 JDBC 方法。它继承自 SQLException，但不是“错误”而是明确的“能力缺失”信号——不是代码写错了，而是驱动没实现这个功能。
哪些操作容易触发这个异常
常见于较老或轻量级驱动（如 MySQL Connector/J 5.x、某些嵌入式数据库驱动、国产数据库早期驱动）对 JDBC 标准新特性的支持不全：
- 调用
PreparedStatement.setObject(int, Object, SQLType)（JDBC 4.2+）但驱动只支持到 JDBC 4.1 - 使用
Connection.isValid(int)、Connection.createBlob()、ResultSet.getObject(int, Class)等较新方法 - 调用
Statement.unwrap(Class)或isWrapperFor(Class)但驱动未实现Wrapper接口 - Oracle 驱动中调用
setFetchSize(0)（部分版本不支持 0 表示“不限制”）
如何快速定位是哪个方法不被支持
异常堆栈会明确指出失败的方法名和所在类。重点看最上面几行，例如：
java.sql.SQLFeatureNotSupportedException: isValid
at com.mysql.cj.jdbc.ConnectionImpl.isValid(ConnectionImpl.java:1987)
立即学习“Java免费学习笔记（深入）”；
说明问题出在 connection.isValid() 调用上。不要跳过堆栈，这是最直接的线索。
稳妥的兼容性写法
不依赖驱动是否支持，改用更基础、广泛兼容的方式：
- 不用
isValid(int)，改用简单查询：connection.createStatement().executeQuery("SELECT 1") - 避免
setObject(pos, obj, SQLType)，改用类型明确的 setter：setString()、setInt()等 - 不用
ResultSet.getObject(col, LocalDate.class)，先取getDate()或getString()再手动转换 - 对不确定是否支持的方法，加 try-catch 并提供降级逻辑，而不是让程序崩溃
驱动升级与替代方案
确认你用的是官方最新稳定版驱动：
- MySQL：换用
mysql-connector-j（8.0+，注意包名已从mysql-connector-java改变） - PostgreSQL：用最新
postgresql（42.6+） - 如果项目受限无法升级驱动，可引入 HikariCP 或 Apache Commons DbUtils 这类封装库，它们内部做了大量兼容性判断
