返回

DBeaver MySQL驱动Maven报错？5招解决依赖下载

mysql

搞定 DBeaver Maven 依赖报错：MySQL 驱动下载那点事儿

碰上 DBeaver 在添加 MySQL 连接时，一点“下一步”就跳出个“Error resolving maven dependencies”的框框，心里是不是咯噔一下？尤其是看到提示说“Cannot resolve Maven artifact org.jkiss.dbeaver.ext.mysql:mysql-connector-java:RELEASE”，更是头大。这通常意味着 DBeaver 想通过 Maven 下载 MySQL 的 JDBC 驱动，结果没下到。别急，这事儿有解。

Imgur

折腾了半天，比如恢复驱动默认设置、删掉用户目录下的元数据文件夹再重启，都不管用？那咱们得往深了瞅瞅。

一、问题出在哪儿？

DBeaver 这家伙挺现代的，默认会用 Maven 来管理和下载数据库驱动。当你新建一个数据库连接，比如 MySQL，它会尝试从 Maven 中央仓库或者你配置的其他仓库去拉取对应的 JDBC 驱动 JAR 包。

报错“Error resolving maven dependencies”和“Cannot resolve Maven artifact”，直白点说，就是：

  1. 网络不给力 ：你的电脑访问不了 Maven 仓库。可能是墙了，可能是公司防火墙拦了，也可能是你用的代理没配对。
  2. Maven 仓库本身出问题 ：虽然少见，但 Maven 中央仓库偶尔也会抖动一下。
  3. 本地 Maven 配置有妖 ：如果你本地有 Maven 环境，并且配置（比如 settings.xml）指向了一个不靠谱的镜像或者私服，DBeaver 可能会沿用这些配置，然后就卡壳了。
  4. DBeaver 的 Maven 设置抽风 ：DBeaver 内部也有 Maven 相关的设置，可能这里出了岔子。
  5. 驱动版本“RELEASE”惹的祸 ：mysql-connector-java:RELEASE 这种写法依赖 Maven 元数据正确解析最新稳定版。如果元数据同步有问题，或者网络到不了存放元数据的地方，也会失败。

二、咋办？试试这些招

针对上面说的这些原因，咱们一个一个来破解。

方案一：检查网络和代理设置

这是最常见的原因，也是最先要排查的。

  • 原理和作用 ：
    确保 DBeaver 能顺利连接到 Maven 中央仓库 (通常是 repo1.maven.org 或其镜像)。如果网络不通或者代理配置错误，下载自然失败。

  • 操作步骤 ：

    1. 测试网络连通性 ：
      打开你的命令行工具 (CMD 或 PowerShell 或 Terminal)，试试 ping repo1.maven.org。

      ping repo1.maven.org

      如果 ping 不通，那多半是网络问题。可能需要科学上网，或者联系你的网络管理员。

    2. 检查系统代理 ：
      看看你系统是不是设置了全局代理。如果是，DBeaver 默认可能会尝试使用它。

    3. 配置 DBeaver 代理 ：
      如果你的网络环境需要通过代理访问外网，DBeaver 里也得给它说明白。

      • 打开 DBeaver。
      • 找到菜单栏的 “窗口(Window)” -> “首选项(Preferences)”。
      • 在弹出的对话框中，依次展开 “常规(General)” -> “网络连接(Network Connections)”。
      • 这里的 “活动提供者(Active Provider)” 选项，你可以从 “直接(Direct)” 改成 “手动(Manual)”。
      • 然后在下面的 HTTP 和 HTTPS 项目里，填上你的代理服务器地址和端口。如果代理需要认证，勾选 “需要认证(Requires Authentication)” 并填写用户名密码。

      DBeaver Proxy Settings (Illustrative)
      (注意：截图仅为示意，不同 DBeaver 版本界面可能略有差异)

  • 安全建议 ：
    如果配置代理密码，确保来源可靠，避免泄露。

方案二：手动添加 MySQL 驱动

既然自动下载不灵，咱们就自己动手，丰衣足食。

  • 原理和作用 ：
    绕过 DBeaver 的 Maven 自动下载机制，直接把下载好的 MySQL JDBC 驱动 JAR 文件告诉 DBeaver。

  • 操作步骤 ：

    1. 下载 MySQL Connector/J 驱动 ：

      • 访问 MySQL 官方网站：https://dev.mysql.com/downloads/connector/j/
      • 选择 "Platform Independent" 版本，然后下载 ZIP 或 TAR 包。
      • 解压下载的文件，找到里面的 mysql-connector-java-X.X.XX.jar (X.X.XX 是版本号，比如 8.0.33)。

    2. 在 DBeaver 中配置驱动 ：

      • 回到 DBeaver 添加新连接的界面，选择 MySQL，先别急着点“下一步”。
      • 找到“驱动设置(Driver Settings)”或者类似的按钮/标签页。不同 DBeaver 版本和操作系统，这个入口可能不太一样，但逻辑是共通的。通常在选择数据库类型后，会有个配置驱动的选项。
      • 在驱动管理界面，它可能会列出已经存在的 MySQL 驱动（比如空的或者之前下载失败的）。选中它，然后找“编辑(Edit)”或“更改(Change)”之类的操作。
      • 或者，直接新建一个驱动定义。
      • 关键是找到添加驱动 JAR 文件的地方。通常是“库(Libraries)”标签页。
      • 点击“添加文件(Add File)”或“添加 JAR(Add JAR)”按钮。
      • 浏览到你刚才解压出来的 mysql-connector-java-X.X.XX.jar 文件，选中它。
      • 确保“驱动类名(Driver class)”是正确的，对于 Connector/J 8.x 及以后版本，通常是 com.mysql.cj.jdbc.Driver。对于老的 5.x 版本，可能是 com.mysql.jdbc.Driver。DBeaver 一般能自动识别。
      • 保存设置。

    3. 尝试重新连接 ：
      配置好手动驱动后，回到新建连接的界面，继续填写主机、端口、用户名、密码等信息，然后尝试连接。

  • 安全建议 ：

    • 务必从 MySQL 官方网站或可信赖的 Maven 仓库下载驱动 JAR 包，避免下载到被篡改过的恶意驱动。

  • 进阶使用技巧 ：

    • 你可以下载不同版本的 MySQL Connector/J，并为不同的 MySQL 服务器版本（例如 5.7 和 8.0）配置不同的驱动定义，以获得最佳兼容性。
    • 如果你公司有内部的 Maven 仓库（如 Nexus, Artifactory）并且已经有了这个驱动，也可以从那里下载。

方案三：清理 Maven 缓存和重置 DBeaver 配置

有时候，本地的 Maven 缓存可能坏掉了，或者 DBeaver 自身的某些配置出了问题。

  • 原理和作用 ：
    删除本地损坏的 Maven 缓存文件或重置 DBeaver 的驱动下载相关设置，让它重新尝试。

  • 操作步骤 ：

    1. 清理本地 Maven 仓库缓存 ：

      • 找到你本地的 Maven 仓库目录。默认情况下，它在你的用户主目录下的 .m2/repository 文件夹。
      • 小心操作！ 可以考虑只删除和 mysql-connector-java 相关的目录，比如 .m2/repository/mysql/mysql-connector-java/ 和 .m2/repository/org/jkiss/dbeaver/ext/mysql/mysql-connector-java/。
      • 如果问题依旧，可以考虑备份整个 .m2/repository 目录后，将其删除。下次 Maven 构建或 DBeaver 下载时会自动重新创建和下载。
      # Linux / macOS
# 先备份
# mv ~/.m2/repository ~/.m2/repository_backup 
# 再删除有问题的部分，或者整个删除 (如果你清楚影响)
# rm -rf ~/.m2/repository/mysql/mysql-connector-java

# Windows
# 在文件管理器中操作，路径通常是 C:\Users\你的用户名\.m2\repository

    2. 重置 DBeaver 驱动设置/元数据 ：

      • 题主提到尝试过删除 metadata 文件夹。这是个好思路，它包含了 DBeaver 的工作空间配置。路径通常在 C:\Users\[你的用户名]\AppData\Roaming\DBeaverData\workspace6\.metadata (Windows) 或 ~/.local/share/DBeaverData/workspace6/.metadata (Linux)。注意 DBeaverData 后面可能跟具体版本号。
      • 另一种是针对驱动的重置。在 DBeaver 的驱动管理器（Driver Manager）中，找到出问题的 MySQL 驱动，有时会有“重置为默认(Reset to Defaults)”或删除后重新让 DBeaver 自动识别的选项。

    3. 重启 DBeaver ：
      完成清理后，彻底关闭 DBeaver 再重新打开，然后尝试添加 MySQL 连接。

  • 安全建议 ：
    在删除系统文件夹或重要配置文件前，最好先备份，以防不测。

方案四：修改 Maven settings.xml 文件

如果你的环境强制所有 Maven 请求通过一个特定的公司内部仓库（如 Nexus 或 Artifactory）或者需要复杂的代理设置，直接在 DBeaver 里配代理可能不够用，这时候就需要动 Maven 的 settings.xml。

  • 原理和作用 ：
    settings.xml 文件是 Maven 的全局或用户级别配置文件。DBeaver 在执行 Maven 操作时会参考这个文件的配置，例如仓库镜像、代理等。

  • 操作步骤 ：

    1. 定位或创建 settings.xml ：

      • 用户级别：通常在 ~/.m2/settings.xml (Linux/macOS) 或 C:\Users\你的用户名\.m2\settings.xml (Windows)。
      • 全局级别：在 Maven 安装目录的 conf/settings.xml。用户级别的配置会覆盖全局的。
      • 如果文件不存在，可以自己创建一个。

    2. 配置镜像 (Mirror) ：
      如果你想让所有对 Maven 中央仓库的请求都指向一个更快的国内镜像（比如阿里云的），可以这样配置：

      <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                      https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <mirrors>
    <mirror>
      <id>alimaven</id>
      <name>aliyun maven</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>

  <!-- 如果需要代理，可以加在这里 -->
  <!--
  <proxies>
    <proxy>
      <id>myproxy</id>
      <active>true</active>
      <protocol>http</protocol>
      <host>proxy.example.com</host>
      <port>8080</port>
      <username>proxyuser</username>
      <password>proxypass</password>
      <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
    </proxy>
  </proxies>
  -->
</settings>

    3. 配置代理 (Proxy) ：
      如果需要通过代理访问 Maven 仓库，如上面注释掉的 <proxies> 部分所示进行配置。

    4. 重启 DBeaver ：
      修改 settings.xml 后，重启 DBeaver 使配置生效。

  • 安全建议 ：

    • settings.xml 中的密码建议使用 Maven 的密码加密功能进行加密。
    • 确保你配置的镜像是可信的。

  • 进阶使用技巧 ：

    • 你可以配置多个 <profile>，并在其中定义不同的仓库和代理，然后通过激活不同的 profile 来切换环境。
    • mirrorOf 的值可以更复杂，比如 * 代表镜像所有仓库，!repo1,repo2 代表镜像除 repo1 和 repo2 之外的所有仓库。

方案五：更新 DBeaver 版本

题主使用的 DBeaver 3.6.3 是一个相当老的版本了 (大约是2016年的)。这些年 Maven 仓库的协议、安全性要求（比如 TLS 版本）都可能发生了变化，老版本 DBeaver 内置的 Maven 客户端可能已经无法很好地适应了。

  • 原理和作用 ：
    新版本的 DBeaver 通常会包含更新的 Maven 客户端、更好的错误处理机制，以及对当前网络环境和仓库协议更好的支持。

  • 操作步骤 ：

    1. 访问 DBeaver 官网下载最新版本 ：https://dbeaver.io/download/
    2. 选择适合你操作系统的安装包进行安装。
    3. 安装新版本后，它通常能自动导入旧版本的配置，或者你可以选择重新配置。
    4. 尝试在新版 DBeaver 中添加 MySQL 连接。

  • 安全建议 ：
    始终从官方渠道下载软件，避免从不明第三方网站下载，以防捆绑恶意软件。

DBeaver 连接不上 MySQL，报 Maven 依赖错误，八九不离十就是上面这些原因。挨个试试，总有一款适合你。祝你早日连上数据库，开始愉快地搬砖！