Minecraft Forge 1.17.1连接MySQL提示No suitable driver found报错求助
Minecraft Forge 1.17.1 连接MySQL ClassNotFoundException解决方案
1. 修正依赖配置
你当前的依赖路径写法存在错误,且未配置将依赖打包进模组Jar,按以下步骤调整:
- 将下载的
mysql-connector-java-8.0.25.jar放入模组项目根目录的libs文件夹下,确保文件名无冒号等特殊字符 - 修改
build.gradle的依赖配置为:
implementation files("./libs/mysql-connector-java-8.0.25.jar")
- 追加Jar打包配置,将MySQL驱动类合并进最终产出的模组Jar中,避免运行时类加载失败:
jar { from { configurations.runtimeClasspath.filter { it.name.contains("mysql-connector") }.collect { zipTree(it) } } duplicatesStrategy = DuplicatesStrategy.EXCLUDE }
修改完配置后刷新Gradle项目,重新构建。
2. 修正驱动类全限定名
MySQL 8.0+版本的驱动类已变更,旧的com.mysql.jdbc.Driver已废弃,修改加载代码为:
// 优先使用当前模组的类加载器加载驱动,避免跨加载器找不到类 Class.forName("com.mysql.cj.jdbc.Driver", true, this.getClass().getClassLoader());
3. 额外注意事项
- 数据库连接操作不要放在客户端主线程执行,避免游戏卡顿,建议单独开异步线程处理
- 不要将数据库明文账号密码硬编码在模组代码中,避免泄露风险
内容的提问来源于stack exchange,提问作者steakmans
相关产品推荐
相关产品推荐

