如何排查Navicat连接数据库时SSL握手失败

落辰同学_7890

落辰同学_7890

2026-08-11

487人浏览

原创

ssl握手失败根源在服务端未启用ssl,而非navicat配置错误;须先验证服务端have_ssl(mysql)、openssl配置(clickhouse)或ssl=on(postgresql)是否启用,再确保证书路径为本地绝对路径、无空格中文、权限正确,并按ssl mode要求匹配ca证书与主机名。

ssl握手失败是服务端没开ssl,不是navicat配错了

绝大多数“ssl handshake failed”错误,根源在服务端——navicat只是个被动接收方,它无法凭空建立加密通道。先别动客户端配置,直接登录数据库服务器查两件事:have_ssl(mysql)或openssl配置块(clickhouse)是否启用,以及对应证书文件路径是否存在、权限是否正确(如/etc/clickhouse-server/server.crt需clickhouse用户可读)。

快速验证服务端状态:

  • MySQL:运行 mysql -u root -p -e"show variables like 'have_ssl';",返回 DISABLED 或 NO 就得先配服务端
  • ClickHouse:执行 clickhouse-client --ssl-mode=strict --host=127.0.0.1 --port=9440,能连通说明服务端 SSL 已就绪
  • PostgreSQL/SQL Server:检查 postgresql.conf 中 ssl = on 及证书路径,或 SQL Server 的“加密连接”设置是否启用

Navicat填了证书路径却仍失败,大概率是路径不合法

Navicat所有版本(Windows/macOS/iOS)只认本地绝对路径,且对路径字符极其敏感。网络路径(\servercertsca.pem)、iCloud/OneDrive同步目录、含空格或中文的路径(C:My Certsca.pem)、符号链接、波浪号(~/certs/ca.pem)全部无效——它会静默忽略,然后降级为明文连接或报错。

必须满足以下全部条件:

  • 证书文件(如 ca.pem)已复制到本地固定目录,例如 C:/navicat-certs/mysql-prod-ca.pem(Windows)或 /Users/you/navicat-certs/pg-staging.crt(macOS)
  • 路径中不含空格、括号、中文、特殊符号
  • Navicat 连接设置里填的是完整绝对路径,不是相对路径或 UNC 路径
  • 多人共用机器时,每人用独立子目录(如 C:/navicat-certs/user1-mysql),避免混用 CA 导致 certificate verify failed

SSL Mode选错会导致握手直接中断,不是连不上而是验不过

Navicat 的 SSL Mode 下拉选项决定校验强度,选错会立刻失败,而非超时或密码错:

SSL Certificate Monitor
SSL Certificate Monitor

检查一个或多个域名的 SSL/TLS 证书到期时间、颁发者、协议及 SAN 信息,用于应要求检查证书、监控到期或验证 HTTPS 等场景。

下载
  • Require:只要求加密,不校验证书——适合内网自签名环境,但无防中间人能力
  • Verify-CA:必须填 SSL CA File(即服务端的根证书 ca.pem),只校验签名链是否可信
  • Verify-Full:除 Verify-CA 外,还强制要求 Navicat 连接设置里的 Host 字段与证书中 Subject CN 或 Subject Alternative Name 完全一致(比如填 db01.prod.example.com,证书里就得有这个域名)

常见陷阱:Verify-Full 模式下 Host 填 IP 地址(如 10.0.1.5)但证书没包含该 IP 的 SAN,就会卡在握手;此时要么改 Host 为域名,要么重签证书加 SAN。

连接显示“Connected”但实际没走SSL,得靠命令或抓包确认

Navicat 界面显示成功不代表数据真加密。MySQL 可能因服务端配置不全(如只配了 ssl_cert 没配 ssl_key)而静默回退到明文;ClickHouse 若 config.xml 中 verificationMode 设为 none,也会跳过校验。

验证真实加密状态:

  • MySQL:连接后执行 SELECT Ssl_cipher FROM performance_schema.threads WHERE TYPE = 'FOREGROUND' AND PROCESSLIST_USER = 'your_user';,结果为空说明未走 SSL
  • 通用方法:用 tcpdump -i lo port 3306(本地)或 tshark -f "host your-db-ip and port 9440" 抓包,若能看到明文 SQL(如 SELECT * FROM users),说明加密未生效
  • ClickHouse:查 system.settings 中 use_secure_protocol 是否为 1,或看 system.processes 的 is_secure 列

真正麻烦的点不在填哪几个字段,而在于服务端证书链是否完整、CN/SAN 是否匹配、Navicat 是否真的读到了那个文件——三者缺一不可。路径写错一个斜杠,或者证书更新后没手动替换本地文件,都会让整个链路失效。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

4263

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

891

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1109

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

6161

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3003

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

6140

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

8281

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1130

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

992

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 0.1万人学习