手动添加jar仍报mysql:mysql-connector-java:8.0.29依赖找不到如何解决
问题说明
项目运行/编译时抛出如下报错:Dependency 'mysql:mysql-connector-java:8.0.29' not found
对应报错截图:
已尝试在IDE项目结构中手动添加对应版本mysql-connector-java的jar包,错误未消除,可按以下步骤排查解决:
- 第一步先确认项目的构建方式:如果是Maven或Gradle管理的项目,手动在项目结构里添加本地jar不会被构建工具识别,IDE会优先读取构建配置文件中的依赖声明,这类情况必须在对应配置文件中声明依赖。
- Maven项目打开
pom.xml,在<dependencies>节点下添加如下配置后,点击IDE侧栏Maven面板的刷新按钮,等待依赖拉取完成即可:
- Maven项目打开
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.29</version> </dependency>
- Gradle项目打开
build.gradle,在dependencies节点添加implementation 'mysql:mysql-connector-java:8.0.29'后刷新Gradle依赖即可。 - 若已经在构建配置中写了正确的依赖坐标依旧报错,先排查本地依赖仓库的缓存问题:
打开本地Maven默认仓库路径~/.m2/repository/mysql/mysql-connector-java/8.0.29(Windows系统路径为C:\Users\你的用户名\.m2\repository\mysql\mysql-connector-java\8.0.29),如果路径下存在后缀为.lastUpdated的文件,说明之前拉取依赖失败留下了坏缓存,把这个版本对应的文件夹整个删掉,再重新刷新依赖拉取即可。 - 检查依赖源配置:如果配置了公司私服或者无效的镜像源,会导致依赖拉取失败,可以临时切换为公共镜像源测试,确认是源的问题就调整镜像配置,或者手动将下载好的jar包安装到本地仓库后再刷新。
- 如果是无构建工具的纯原生Java项目,手动加jar后仍报错可按以下点排查:
- 检查jar包存放的路径是否包含中文、空格或特殊字符,路径异常会导致IDE无法正常加载jar。
- 打开IDE的
Project Structure -> Modules -> Dependencies面板,确认已添加的mysql驱动包前方勾选框为选中状态,依赖作用域选择Compile,不要选Provided、Test这类非编译期生效的作用域。 - 执行IDE缓存清理:点击顶部菜单栏
File -> Invalidate Caches...,确认清除缓存后重启IDE,等待项目索引重建完成后再检查报错。
- 补充说明:MySQL官方从8.0.31版本开始调整了驱动的坐标路径,如果8.0.29版本的旧坐标持续拉取失败,也可以尝试使用新坐标引入,新坐标配置如下:
<dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <version>8.0.29</version> </dependency>
内容的提问来源于stack exchange,提问作者JKL
相关产品推荐
相关产品推荐

