测试IDEA插件时遇ClassNotFoundException：MySQL驱动类缺失如何解决？

原因分析 #

你用implementation声明的MySQL驱动依赖仅在插件编译阶段生效，但测试运行时（尤其是IDEA插件的远程JDBC服务进程）无法加载到该驱动类，因此抛出ClassNotFoundException。

解决方案 #

方案1：将依赖改为testImplementation（仅测试环境生效） #

如果仅在测试阶段需要MySQL驱动，把依赖声明改为testImplementation，确保测试运行时自动包含该依赖：

dependencies {
    // 其他依赖...
    testImplementation("mysql:mysql-connector-java:8.0.30")
    // 其他依赖...
}

方案2：将依赖设为插件运行时依赖（插件发布后也需使用的情况） #

如果插件本身需要MySQL驱动支持，需将依赖配置为runtimeOnly，并确保打包时包含该依赖。在IntelliJ插件的Gradle配置中，通过intellij块配置确保驱动被打包进插件：

dependencies {
    // 其他依赖...
    runtimeOnly("mysql:mysql-connector-java:8.0.30")
    // 其他依赖...
}

intellij {
    version.set("2022.1") // 替换为你的IDEA SDK版本
    plugins.set(listOf(/* 你的插件依赖列表 */))
    // 确保runtime依赖被包含进插件包
    configureDependencies {
        include("mysql:mysql-connector-java")
    }
}

方案3：手动添加驱动到测试类路径 #

若上述方案不生效，可手动将MySQL驱动JAR包添加到测试运行的类路径：

1. 下载对应版本的mysql-connector-java-8.0.30.jar
2. 在IDEA的「Run/Debug Configurations」中找到你的测试配置，切换到Classpath选项卡，添加该JAR包

验证方法 #

修改配置后重新运行测试，检查是否仍抛出ClassNotFoundException。若插件运行时需要驱动，可打包插件后安装到IDEA中验证功能是否正常。

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