Navicat 17连接OpenGauss必须手动将华为官方opengauss-jdbc.jar放入安装目录drivers子目录并重启软件，否则“数据库类型”不显示OpenGauss选项；驱动不可用PostgreSQL替代，且需匹配OpenGauss版本与Java兼容性。
驱动文件没放对位置，Navicat根本看不见
navicat不会自动扫描全盘找驱动，它只认准自己安装目录下的 drivers 子目录。哪怕你把 mysql-connector-j-8.0.33.jar 放在桌面或下载文件夹，它也完全无感。
- Windows 正确路径：
C:\Program Files\PremiumSoft\Navicat Premium 17\drivers\ - macOS 正确路径：
/Applications/Navicat Premium 17.app/Contents/Resources/drivers/ - Linux 正确路径：
/usr/local/navicat/drivers/ - 确认文件权限：Linux/macOS 下执行
ls -l drivers/，确保 jar 文件有可读权限（如-rw-r--r--） - 别用中文、空格或特殊字符命名驱动文件，比如
openGauss JDBC驱动 v3.1.0.jar→ 改成opengauss-jdbc-3.1.0.jar
ODBC 连接报 “数据源未找到”，其实是位数没对上
Windows 上 32 位和 64 位 ODBC 管理器互不兼容。Navicat Premium 17 是 64 位程序，它只看 %windir%\system32\odbcad32.exe 注册的驱动，完全无视 %windir%\syswow64\odbcad32.exe（那是给 32 位程序用的）。
- 装驱动时必须选 64 位版本：比如 MySQL 的
mysql-connector-odbc-8.0.33-winx64.msi，不是-win32.msi - 检查注册表是否写入：打开
regedit，定位到HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI，确认对应驱动条目存在且Driver值指向正确的 DLL 路径 - 企业环境若禁用注册表写入，需手动补注册项，或联系 IT 启用临时策略
选了 OpenGauss 却连不上，因为压根没走 ODBC
Navicat 17 对 OpenGauss 只支持 JDBC 驱动，opengauss-jdbc.jar 必须手动放，而且不能用 PostgreSQL 的 postgresql.jar 替代——协议层已被华为深度定制过，兼容性断裂是明确设计行为。
- 必须从华为官网下载对应 OpenGauss 版本的
opengauss-jdbc-x.x.x.jar（如 3.1.0 →opengauss-jdbc-3.1.0.jar） - 重启 Navicat 后，“数据库类型”下拉菜单才出现
OpenGauss选项；不重启，界面里根本看不到这一项 - 连接时填的
端口必须和gs_om -t status --detail输出里的实际 Port 一致，常见是26000或15432，不是默认的 5432 -
数据库字段不能留空，也不能填template1；初始库名通常是postgres，且用户得有该库的CONNECT权限
Jar 包放对了还报错？可能是 Java 版本不搭
Navicat 17.0.x 内嵌的是 Java 8，但部分新版 OpenGauss JDBC 驱动要求 Java 11+，加载时会静默失败，现象就是连接窗口里依然没有 OpenGauss 选项，或者点测试直接弹“driver not found”。
- 查驱动兼容性：OpenGauss 3.0.x 对应的
opengauss-jdbc-3.0.x.jar通常兼容 Java 8 - 升级 Navicat：17.1+ 版本已升级内嵌 JRE，能更好支持新驱动
- 别指望 Navicat 自动识别驱动：即使 jar 在
drivers目录下，也必须重启软件，且首次使用时要新建连接并选择对应数据库类型，才能触发驱动加载逻辑
