Java11运行Java8程序遇ClassNotFoundException: java.sql.SQLException

虽然java.sql模块已加载，但出现java.sql.SQLException关联的ClassNotFoundException，通常是以下几种场景导致：

1. JDBC驱动未加入运行时类路径 #

JDK 8中部分旧版JDBC驱动可能依赖JDK自带的辅助类，但Java 9+模块化后，java.sql仅提供JDBC核心API，具体数据库的JDBC驱动jar包必须显式添加到类路径。如果你的应用依赖的驱动jar没在Java 11运行时的-cp（或--class-path）参数中，就会找不到驱动实现类，最终抛出包装了SQLException的ClassNotFoundException。

2. 旧驱动不兼容Java 11模块化系统 #

部分JDK 8时期的JDBC驱动未适配模块化：

• 驱动代码可能尝试访问java.sql模块中已被封装的内部API（比如sun.jdbc下的类），Java 11严格的模块封装机制会阻止这类访问，导致类加载失败；
• 驱动本身未声明对java.sql模块的依赖，即便java.sql已加载，驱动类也无法正确访问JDBC核心API。

3. 类加载器上下文不一致 #

如果应用使用了自定义类加载器，可能出现类加载隔离：java.sql模块由启动类加载器加载，而JDBC驱动由应用类加载器加载，两者的类加载上下文不互通，导致驱动类无法找到java.sql.SQLException类（这种情况概率较低，但需排查）。

4. 异常栈的误导性包装 #

很多时候，ClassNotFoundException的真实原因是找不到JDBC驱动实现类（比如com.mysql.cj.jdbc.Driver），但异常栈中会包装SQLException，需要仔细查看完整异常信息，定位实际缺失的类。

• 检查运行命令的-cp参数，确认JDBC驱动jar包已正确加入类路径；
• 替换为适配Java 11的新版驱动（比如MySQL驱动升级到8.0+版本）；
• 打印完整异常栈，明确实际找不到的类名；
• 若驱动依赖旧内部API，可临时添加--add-exports java.sql/sun.jdbc.odbc=ALL-UNNAMED（不推荐长期使用，建议优先升级驱动）。

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