仅NetBeans环境运行JDBC程序报jdbc:mysql://localhost无合适驱动

问题原因 #

该报错核心是NetBeans项目运行时无法加载到MySQL JDBC驱动，NetBeans服务选项卡的驱动配置是独立于单个项目的，因此服务端能正常连接数据库不代表你当前开发的Swing项目运行时能访问到驱动依赖。Eclipse默认会将编译期依赖自动带入运行时，所以相同代码在Eclipse中可以正常执行。

解决方案 #

按以下步骤依次排查即可：

• 检查项目运行时依赖配置
  右键你的项目 → 选择「属性」→ 进入「库」分类 → 切换到「运行时」标签页，确认MySQL驱动jar包（如mysql-connector-java-8.0.30.jar）已在依赖列表中。如果仅在编译期依赖列表有该驱动、运行时没有，直接添加即可：点击「添加JAR/文件夹」选中本地的驱动jar包，若你将驱动包放在项目根目录下可以勾选相对路径，否则不要勾选避免路径识别失败。如果你的项目是用Maven/Gradle管理依赖，确认MySQL驱动的依赖范围不是provided，要设置为compile或者runtime，保证运行时能被加载。
• 可选：显式注册驱动类
  如果你使用的是5.x版本的MySQL驱动，或者项目使用的JDK版本低于1.6（JDBC4.0以下），可以在getConnection执行前添加一行代码显式加载驱动：

  // MySQL 8.x版本驱动类路径
  Class.forName("com.mysql.cj.jdbc.Driver");
  // MySQL 5.x版本请替换为 Class.forName("com.mysql.jdbc.Driver");
  

  需额外捕获ClassNotFoundException异常。
• 补全JDBC连接字符串参数
  8.x版本的MySQL驱动要求指定时区参数，参数缺失也会触发找不到驱动的误报，将连接字符串修改为：

  jdbc:mysql://localhost:3306/ddApp?useSSL=false&serverTimezone=Asia/Shanghai
  

• 清理缓存重新构建
  右键项目选择「清理并构建」，清理旧编译缓存后再次运行项目即可。

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