企业官网建设流程全解析

GoNavi 驱动扩展指南：三步接入达梦，附自定义数据源实战

【免费下载链接】GoNaviHigh-performance multi-data-source database client — ~30MB, AI & MCP ready, zero Electron bloat. | 高性能多数据源数据库客户端：约 30MB，AI 与 MCP 就绪，告别 Electron 膨胀。项目地址: https://gitcode.com/gh_mirrors/go/GoNavi

上周同事拉我救急：公司新上线了达梦数据库，可他手里的客户端翻遍了驱动列表也没找到对应项，迁移脚本只能先停着。如果你也被这类问题卡过，GoNavi 这套数据库管理工具的扩展驱动系统值得了解一下——它把三十多种数据源拆成了"内置、可选、自定义"三层，达梦、金仓、瀚高这些国产库不用自己找插件，装一下就能连。这篇教程讲三件事：怎么装驱动、驱动代理是怎么写的、出了问题去哪找原因。

一、GoNavi 的驱动体系：三类数据源如何分工 🗂️

先看 GoNavi 怎么划分数据源，这决定了你遇到问题时该往哪找答案：

这么分的好处很直接：主程序只保证核心链路轻快，达梦这类"可能用也可能不用"的驱动做成独立代理，不装就不占内存，也不影响其他驱动升级。

二、三步装好一个国产数据库驱动（以达梦为例） ⚙️

H3 · 第 1 步：进驱动管理入口打开设置里的"驱动管理"，界面上分"内置驱动"和"可选驱动"两栏。达梦、金仓、瀚高、OpenGauss 都在可选驱动列表里，未安装时会显示为灰色可安装状态。

H3 · 第 2 步：点安装在达梦条目上点"安装"，应用会把对应的驱动代理拉到本地~/.gonavi/drivers目录下并做完整性校验，成功后条目变为已启用。内网环境拉不到资源时，可以改走"手动导入驱动包"的路径，把包放进目录再刷新。

H3 · 第 3 步：重启并验证装完重启一次 GoNavi 让代理进程生效，然后新建连接：

在"国产数据库"分类下选 Dameng，默认端口 5236，用 SYSDBA 账号填好信息先点"测试连接"，通了再保存。连上后跑一句SELECT 1，看看左侧树能不能刷出表和列——到这一步，安装就算闭环了。

三、进阶：自己写一个驱动代理 🔧

H3 · 驱动代理长什么样每个可选驱动本质上是一个独立的小进程，用 build tag 决定这个二进制"是谁"，在init()里完成注册：

//go:build gonavi_mydb_driver package main import "GoNavi-Wails/internal/db" func init() { agentDriverType = "mydb" agentDatabaseFactory = func() db.Database { return &db.MyCustomDB{} } }

主进程要连这个库时，就拉起对应的代理二进制，通过 stdin/stdout 用 JSON 行协议通信：connect、query、getDatabases、getTables……一套 RPC 方法，代理只负责"翻译"给自己的库。好处是驱动崩了不影响主程序，升级也互不牵连。

H3 · 实现 db.Database 接口要完成哪些事真正干活的是internal/db/下的驱动实现，接口方法分三类：生命周期（Connect / Close / Ping）、执行（Query 返回行列结果、Exec 返回影响行数）、元数据（GetDatabases、GetTables、GetColumns、GetIndexes、GetForeignKeys、GetTriggers、GetCreateStatement）。写的时候建议参考现成实现internal/db/dameng_impl.go的骨架：先拼 DSN、再建 sql.DB、最后把元数据 SQL 按目标库的系统表逐个对齐。

H3 · 在注册表和清单里登记光写实现不够，还得让主进程"认识"它，共两处：在internal/db/driver_support.go的optionalGoDrivers映射里加一行"mydb": {}，这是运行时"装了才能用"的门控开关；再在docs/driver-manifest.json里补一条驱动条目，声明引擎类型、驱动版本和builtin://activate/mydb这类下载地址。如果你的库还有别的叫法（比如 dm8、kingbasees），别忘了在normalizeRuntimeDriverType里补上别名映射。

四、踩坑速查：装不上、连不上、查不出 🩺

五、适配国产数据库的隐藏细节 🧩

• 方言差异：金仓、OpenGauss、瀚高都是 PostgreSQL 血统，但系统表结构和内置函数各有私货。元数据 SQL 别照抄 pg 的写法，连上后先手动对比一遍GetTables、GetColumns的结果再信缓存。
• DSN 拼接的暗坑：以达梦为例，连接串形如dm://user:pass@host:port?schema=xxx，它用字符串切分解析 DSN 而不做 URL 解码——密码里的特殊字符保持原样传，别自作主张去转义，转了反而登不进去。
• 连接参数三件套：端口（达梦 5236、金仓/OpenGauss 常是 5432）、默认 schema（决定你默认看到哪套表）、SSL（启用时必须证书和私钥路径成对出现，缺一个直接报错）。
• 性能三要点：连接池设好上限和空闲回收，别让会话无限堆积；给查询加超时，长事务别卡死界面；大结果集走流式分批传输，代理内部是按批推送行数据的，一次全量拉回内存才是事故根源。

装一个达梦驱动只需要三分钟，自己接一个库也就是一下午的事。现在就打开 GoNavi 的驱动管理界面，把你手头那个连不上的库装上试试——要是列表里还没有，欢迎照着第三节自己动手，提一个社区 PR。

内容基于项目当前版本编写，细节以官方文档为准。

【免费下载链接】GoNaviHigh-performance multi-data-source database client — ~30MB, AI & MCP ready, zero Electron bloat. | 高性能多数据源数据库客户端：约 30MB，AI 与 MCP 就绪，告别 Electron 膨胀。项目地址: https://gitcode.com/gh_mirrors/go/GoNavi