必须选 TiDB 连接类型，因 Navicat 17.1.6+ 内置专用 TiDB 驱动，可自动处理认证、元数据适配和 SQL 提示；误选 MySQL 类型会导致认证失败、注释丢失、对象不显示及 SSL 配置错误。
必须选 TiDB 连接类型，不能选 MySQL
navicat premium 17.1.6+ 内置了专用 tidb 驱动，它会自动处理 mysql_native_password 认证、元数据结构适配和部分 sql 提示。若误选 mysql 类型，会出现以下典型问题：
-
Authentication plugin 'caching_sha2_password' cannot be loaded（TiDB 默认不启用该插件，但 MySQL 驱动会强制协商） - 表结构编辑时字段注释丢失或无法保存
- 视图、存储过程在左侧导航树中不显示或展开报错
- SSL 配置项位置不同，容易漏设关键选项
正确操作路径：点击 Connection → 在 Vendor Filter 中勾选 PingCAP → 双击右侧列表中的 TiDB。
HOST 和 PORT 要按部署形态填，不能硬写 127.0.0.1:4000
虽然 4000 是 TiDB Server 默认端口，但实际填写必须依据部署方式：
-
TiDB Cloud Serverless：从控制台
Connect页面复制HOST和PORT，Serverless 通常为4000，但不可假设 -
TiDB Cloud Dedicated：端口可能是
4000或6000，以控制台为准；且需提前配置 IP 白名单 -
本地部署：检查
tidb-server的config.toml，确认host = "0.0.0.0"（而非默认"127.0.0.1"），否则外部无法连接 -
Docker 启动：确保容器启动时有
-p 4000:4000映射，且tidb-server配置允许外部绑定
SSL 不是可选项，而是强制验证路径
TiDB Cloud 所有集群（Serverless/Dedicated）均强制 SSL 加密传输，且必须验证服务端证书。Navicat 中漏掉任一配置都会失败：
- 勾选
Use SSL - 勾选
Use authentication - 勾选
Verify server certificate against CA -
CA Certificate字段必须填入从 TiDB CloudConnect对话框下载的ca.pem绝对路径（Windows 下建议用正斜杠，如C:/path/to/ca.pem）
错误现象包括：SSL connection error: unknown error number、连接超时、或直接弹出证书验证失败提示。
高级设置里要留意客户端字符集和连接保活
默认配置在多数场景下可用，但两个参数容易被忽略且影响实际使用：
-
Client charset：建议显式设为utf8mb4，避免中文或 emoji 插入时出现乱码或截断 -
Keep-alive interval：TiDB 默认连接空闲 30 分钟断开（wait_timeout=1800），若查询周期长或中间有停顿，建议设为60秒并勾选启用，防止执行中途报Lost connection to MySQL server during query -
Client driver：如遇连接异常，可尝试切换为Old version驱动（尤其在旧版 TiDB 或自建集群上）
这些设置藏在连接窗口的 Advanced 选项卡里，不是“连得上”就不用管——连得稳、写得对、查得全，才真正算接入成功。
