如何在IntelliJ的Gradle项目中正确添加MySQL Connector/J？

你通过IntelliJ的Platform Settings添加Maven库的操作，仅让IDE获得了代码提示能力，但没有将MySQL驱动纳入Gradle的依赖管理体系。Gradle运行程序时，会基于自身构建脚本生成classpath，这个classpath里没有驱动包，所以抛出"No suitable driver found"错误；而命令行手动指定了驱动jar的路径，因此能正常运行。之前偶然成功的情况，大概率是当时的运行配置临时包含了驱动路径，但未持久化到Gradle配置中。

方案1：通过Gradle构建脚本添加依赖（推荐） #

Gradle项目的依赖必须通过构建脚本管理，这是确保IDE与命令行构建一致性的标准方式：

1. 打开项目根目录下的build.gradle（Groovy语法）或build.gradle.kts（Kotlin语法）
2. 在dependencies代码块中添加MySQL驱动依赖：
   • Groovy版本：

     dependencies {
         implementation 'com.mysql:mysql-connector-j:8.4.0'
         // 保留原有其他依赖
     }
     

   • Kotlin版本：

     dependencies {
         implementation("com.mysql:mysql-connector-j:8.4.0")
         // 保留原有其他依赖
     }
     

3. 点击IntelliJ右上角的「Sync Now」按钮，等待Gradle同步依赖
4. 重新运行JDBCTest.main()，此时驱动会被自动加入运行classpath，程序即可正常连接数据库

方案2：手动修改IntelliJ运行配置（临时方案） #

若暂时不想修改Gradle脚本，可手动将驱动jar加入运行配置的classpath：

• 点击顶部运行配置下拉框，选择「Edit Configurations...」
• 在配置窗口中找到你的JDBCTest运行配置
• 切换到「Classpath」标签页，点击右侧「+」按钮，选择「JARs or directories...」
• 选中已下载的mysql-connector-j-8.4.0.jar并添加
• 点击「Apply」「OK」后重新运行程序

完全不需要。问题出在依赖管理的方式错误，而非Gradle本身的问题。按方案1用Gradle管理依赖是行业标准做法，能彻底避免这类classpath不一致的问题。

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