MySQL Connector/ODBC连接报错无法打开命名管道原因排查

故障原因 #

该报错的核心诱因是Windows端MySQL Connector/ODBC的数据源配置错误，未显式指定连接协议为TCP/IP：

• MySQL ODBC 8.0版本驱动默认优先尝试使用Windows原生的命名管道（Named Pipe）方式建立连接，而命名管道是Windows专属的进程间通信机制，Linux环境部署的MySQL服务默认不会开启命名管道监听能力，因此连接请求还未进入TCP/IP握手逻辑就直接触发了报错。
• 触发该配置错误的常见场景是：配置ODBC数据源时，误勾选了连接参数中的「使用命名管道」选项，或是未在网络配置栏手动指定TCP/IP协议，导致驱动走了默认的命名管道连接逻辑。

解决方法 #

打开Windows ODBC数据源管理器，找到对应MySQL数据源的配置项：

1. 进入配置界面的「Network」（网络）选项卡
2. 手动选中TCP/IP作为连接协议，确认端口填写为3306
3. 保存配置后重新测试连接即可恢复正常

内容的提问来源于stack exchange，提问作者V. Bozz