如何解决NetBeans添加Connection强转后抛出的ClassCastException异常？

问题根因 #

这个问题是IDE误判和代码写法问题共同导致的：

• NetBeans静态代码扫描无法正确推断JDBC连接方法返回值类型时，会错误提示添加Connection类型强转，这个提示本身是无效的——JDBC标准接口中DriverManager.getConnection()本来就返回java.sql.Connection类型，不需要强转。
• 添加强转后运行报类转换异常，核心原因是类不匹配：要么是代码里导入的Connection不是JDK标准的java.sql.Connection接口（比如误导入了com.mysql.cj.jdbc.Connection这类驱动内部实现类、其他第三方包下的同名Connection类），要么是项目里引入了多份重复的JDBC驱动包，类加载器加载了两份不同的Connection接口，导致强转失败。

修复步骤 #

• 检查代码顶部的import语句，删除所有非java.sql.Connection的Connection类导入，手动添加标准JDBC接口导入：

import java.sql.Connection;
// 其余JDBC相关类也统一使用java.sql包下的标准接口，不要导入驱动包内的实现类
import java.sql.Statement;
import java.sql.ResultSet;

• 删掉代码里IDE提示添加的(Connection)强转，直接用java.sql.Connection类型变量接收DriverManager.getConnection()的返回值即可。如果NetBeans仍然飘红提示需要添加强转，直接忽略该提示即可；要彻底消除提示可以打开工具 -> 选项 -> 编辑器 -> 提示，在Java分类下找到不必要类型转换的检查项，关闭对应提示规则。
• 排查项目依赖库，删除重复、版本不匹配的JDBC驱动包，只保留一份和当前数据库版本对应的驱动即可，比如MySQL 8.0+版本使用mysql-connector-j 8.x系列驱动，不要同时混入5.x版本的旧驱动包，避免类加载冲突。
• 如果是通过JNDI从Web容器（Tomcat、Jetty等）获取连接池连接，同样统一用java.sql.Connection标准接口接收，不要尝试强转为驱动内部的连接实现类。

JDBC编程统一遵循面向标准接口的原则，所有数据库驱动都实现了java.sql包下的标准接口，不要直接引用驱动包内的实现类做类型定义或强转，否则更换驱动版本、更换数据库类型时很容易触发类转换异常。

问题对应报错截图

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