DBeaver插件更新指南：3步完成更新检查与私有仓库排障
【免费下载链接】dbeaverFree universal database tool and SQL client项目地址: https://gitcode.com/GitHub_Trending/db/dbeaver
DBeaver 的插件更新由 Eclipse P2 更新框架驱动：启动后客户端会检查产品配置里预置的官方仓库，发现新版本时负责下载并在必要时提示重启生效。本文按你的实际操作顺序，讲清如何手动检查更新、自动更新仓库在哪里配置、以及更新失败时怎么快速定位原因。
如何手动触发一次插件更新检查
入口是 Help → Check for Updates。执行后 P2 会遍历所有已启用的更新仓库，拉取最新元数据并与本地已安装的 feature 逐一比对，整个过程不需要你先重启。
需要注意三点：
- 只有处于启用状态的仓库才会参与检查；
- 检查结束后，安装界面列出所有可用更新，由你勾选决定装哪些；
- 部分插件更新要等 DBeaver 重启后才生效，安装流程最后会提示重启。
自动更新仓库在哪里配置
DBeaver 默认检查的仓库清单写在产品配置文件 DBeaver.p2.inf 里，每个仓库对应一条 addRepository 指令：
addRepository(type:0,location:https://dbeaver.io/update/ce/latest/,name:DBeaver CE update site,enabled:true)这条指令的含义是：把一个启用状态的仓库加进客户端。其中 type:0 是元数据仓库（版本索引），type:1 是 artifact 仓库（实际下载源），两者必须成对配置，否则 P2 能发现新版本却找不到下载文件。当前配置里预置了 Office、Git、Debug、CE 和 Eclipse 五个仓库。
官方仓库的工程位于 product/repositories/，每个仓库用 category.xml 声明包含哪些 feature 和分类，例如 org.jkiss.dbeaver.ce.repository/category.xml 就是 CE 更新站的 feature 清单。
如何添加团队内部的插件仓库
有企业内插件时，通过 Help → Install New Software → Add 填入你的仓库 URL 即可，之后它会和官方仓库一起参与检查与安装。前提是它必须是一个标准的 Eclipse P2 更新站，而不是普通压缩包。
⚠️ 一个常见混淆点：连接偏好里设置的"Maven 仓库"只用于下载 JDBC 驱动依赖，和插件更新是两套完全独立的体系，改错了地方不会解决插件更新问题。
更新失败排查清单
检查或安装阶段报错时，按顺序排查：
- 网络可达性：官方仓库全部使用 HTTPS。走代理的话，先到 Preferences → General → Network Connections 配置代理。
- 仓库 URL 失效：老版本 DBeaver 指向旧 Eclipse 发布线，升级到新版本后先手动跑一次 Check for Updates。
- 依赖冲突：安装界面提示某个 feature 需要更高版本的另一个 feature 时，把提示的 feature 一并勾选安装，单独装会失败。
- 重启未完成：下载成功但版本没变化，多半是上次更新的重启没有真正执行。
如何关闭自动更新检查
检查行为由 Eclipse 的更新设置控制：在 Preferences 的 Install/Update 相关页面中，可以把检查频率设为从不，避免每次启动都发网络请求。只想停掉某个仓库而保留其他仓库时，在 Install New Software 的仓库管理界面单独禁用它即可，不用整体关闭自动检查。
【免费下载链接】dbeaverFree universal database tool and SQL client项目地址: https://gitcode.com/GitHub_Trending/db/dbeaver
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
