当在Spring Boot项目中使用Druid数据源时，若IDE报错“The type java.sql.SQLException cannot be resolved”，通常是因为缺少JDBC标准API依赖——即java.sql包未被正确引入，需显式添加jakarta.servlet-api（Servlet场景）或确保JDK版本兼容，但根本原因是缺少JDBC驱动或JRE/JDK环境未提供标准SQL API。
当在spring boot项目中使用druid数据源时，若ide报错“the type java.sql.sqlexception cannot be resolved”，通常是因为缺少jdbc标准api依赖——即`java.sql`包未被正确引入，需显式添加`jakarta.servlet-api`（servlet场景）或确保jdk版本兼容，但根本原因是缺少jdbc驱动或jre/jdk环境未提供标准sql api。
该错误看似指向 java.sql.SQLException 类不可解析，实则反映项目编译环境缺失 JDBC 标准 API 的可见性。值得注意的是：*`java.sql.` 并非第三方库，而是 JDK 自带的核心 API（自 JDK 1.1 起内置）**。因此，该问题极少源于“未引入某个 Maven 依赖”，而更可能由以下原因导致：
✅ 常见根本原因与对应方案：
-
JDK 版本配置错误（最常见）
- Spring Boot 3.x 及以上要求 JDK 17+，而部分老项目误用 JDK 8/11 编译，或 IDE（如 IntelliJ IDEA）中模块 SDK 未正确指定。
- java.sql.SQLException 在 JDK 17 中位于 java.sql 模块；若项目模块化（module-info.java）且未声明 requires java.sql;，也会触发编译错误。
- ✅ 解决方法：检查 Project SDK 和 Language Level 是否统一为 JDK 17+（推荐 JDK 17 或 21），并在 pom.xml 中明确指定：
<properties> <java.version>17</java.version> <maven.compiler.source>17</maven.compiler.source> <maven.compiler.target>17</maven.compiler.target> </properties>
-
Maven 依赖冲突或未生效
立即学习“Java免费学习笔记（深入）”；
- 虽然 java.sql.* 不需要额外依赖，但 DruidDataSource 的正常编译与运行必须有 JDBC 驱动（如 MySQL、PostgreSQL）作为运行时依赖。若驱动未引入，IDE 可能因类型推导链中断而误报 SQLException 不可达。
- ❌ 错误认知：“加 mysql-connector-j 就能解决 SQLException 报错” —— 实际上它解决的是 ClassNotFoundException 或运行时连接失败，而非编译期类型解析问题。
- ✅ 正确做法：确保已声明数据库驱动（例如 MySQL）：
<!-- MySQL 8.0+ 驱动（注意 artifactId 已从 mysql-connector-java 改为 mysql-connector-j） --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-j</artifactId> <scope>runtime</scope> </dependency>⚠️ 注意：
runtime 即可，无需 compile，因其不参与编译期类型检查，但为 Druid 连接池提供实际驱动实现。
-
IDE 缓存或 Maven 项目未正确加载
- IntelliJ IDEA 中可能出现 .idea 配置残留或 Maven 依赖未刷新。
- ✅ 强制修复步骤：
- 点击 File → Project Structure → Project，确认 SDK 和 Language Level；
- 执行 Maven → Reload project；
- 清理缓存：File → Invalidate Caches and Restart → Invalidate and Restart。
? 验证是否真正修复？
在任意 Java 类中尝试编写如下代码，应无编译错误：
import java.sql.SQLException;
public class SqlTest {
public void throwExample() throws SQLException {
throw new SQLException("test");
}
}? 延伸提醒：关于 Druid 与 DataSource 的典型配置
确保 DruidDataSource 正确注入，推荐使用 @ConfigurationProperties 方式绑定配置，避免硬编码：
@Configuration
public class DataSourceConfig {
@Bean
@ConfigurationProperties("spring.datasource.druid")
public DataSource dataSource() {
return new DruidDataSource();
}
}并在 application.yml 中配置：
spring:
datasource:
druid:
url: jdbc:mysql://localhost:3306/test?serverTimezone=Asia/Shanghai
username: root
password: 123456
driver-class-name: com.mysql.cj.jdbc.Driver✅ 总结：java.sql.SQLException cannot be resolved 是典型的环境配置型编译错误，优先排查 JDK 版本与 IDE SDK 设置一致性，其次确认 Maven 依赖完整性和 IDE 缓存状态。盲目添加 JDBC 驱动虽可能“连带解决”，但未触及本质；真正健壮的工程实践，始于清晰的 JDK 和构建工具契约。
