navicat 自带 postgresql 驱动无法连接 gaussdb，因其不支持 gaussdb 增强的认证流程、gs_role 权限模型及扩展参数握手；需替换为官方 gaussdb jdbc 驱动（如 gaussdb-jdbc-driver-505.2.0.jar），并配置 sslmode=verify-full、applicationname、options 及 scram-sha-256 认证。
navicat 默认的 postgresql 驱动无法直接连接 gaussdb，必须替换为 gaussdb 官方驱动才能稳定支持高级语法和权限校验。
为什么 Navicat 自带的 PostgreSQL 驱动连不上 GaussDB？
Navicat for PostgreSQL 自带的 postgresql.jar 是面向开源 PostgreSQL 的标准驱动，而 GaussDB 虽然协议层兼容，但在认证流程、系统视图结构、权限模型（如 gs_role 扩展）、以及部分 SQL 解析逻辑上做了增强。直接使用会导致：
- 连接时抛出
FATAL: no pg_hba.conf entry for host（即使配置正确） - 执行
CREATE OR REPLACE PROCEDURE报错ERROR: variable/func/proc declare in package spec is not ended corr - 查询
pg_stat_activity等系统视图返回空或字段缺失
根本原因是 GaussDB 的 JDBC 驱动在握手阶段会发送扩展参数（如 client_encoding、application_name），并依赖自定义的 GSConnection 实现，原生驱动不识别。
如何手动替换为 GaussDB 官方 JDBC 驱动？
Navicat 16+ 支持自定义 JDBC 驱动路径，这是最稳妥的兼容方式：
- 从华为云控制台下载最新版 GaussDB JDBC 驱动（文件名类似
gaussdb-jdbc-driver-505.2.0.jar，注意内核版本需匹配实例） - 打开 Navicat → 连接 → 新建连接 → 选择
PostgreSQL→ 点击右下角高级→驱动设置 - 在
库标签页中点击添加文件，选中刚下载的gaussdb-jdbc-driver-*.jar - 确认驱动类名为
org.postgresql.Driver（GaussDB 驱动保持该类名以保证兼容性） - 保存后测试连接；若仍失败，检查日志中是否出现
GSConnection初始化成功提示
连接参数里哪些字段影响 GaussDB 兼容性？
仅靠换驱动还不够，以下参数必须显式配置，否则可能触发隐式降级或认证失败：
-
sslmode：生产环境必须设为verify-full，且配合 CA 证书路径（华为云控制台可下载ca.pem） -
ApplicationName：建议设为Navicat-GaussDB，便于在pg_stat_activity中识别会话来源 -
options：如需启用列存扫描优化，可加-c enable_columnar_scan=on -
user和password必须与 GaussDB 中CREATE USER语句完全一致（区分大小写，且不能用双引号包裹）
特别注意：host 值不要填域名别名，GaussDB 对 DNS 解析较敏感；优先使用实例的公网 IP 或内网 IP（ECS 同 VPC 时）。
常见报错与对应修复动作
遇到连接失败，先看 Navicat 日志窗口（不是弹窗提示）里的原始错误链：
-
ERROR: GUC parameter "xxx" cannot be set→ 检查options字段是否传入了 GaussDB 不支持的 PostgreSQL 参数（如bytea_output） -
java.sql.SQLException: Connection refused→ 确认端口是5432（PostgreSQL 协议），而非3306（MySQL 协议）；同时检查安全组是否放行该端口 -
SSL error: PKIX path building failed→ CA 证书路径错误，或证书未导入到 Java truststore（Navicat 内置 JRE） -
permission denied for schema public→ 用户缺少USAGE ON SCHEMA public，需在 GaussDB 中执行GRANT USAGE ON SCHEMA public TO username;
真正容易被忽略的是：GaussDB 的 pg_hba.conf 中，对 Navicat 客户端 IP 的认证方式必须是 scram-sha-256（不是 md5），否则即使密码正确也会拒绝连接。
