无法通过命名管道使用MariaDB Java客户端连接数据库求助

我花了两天时间尝试各种协议与参数组合，仍无法通过命名管道使用MariaDB Java客户端连接数据库，怀疑客户端存在问题，但也可能遗漏了配置项。

环境信息 #

• Windows 10系统
• 使用mariadb-java-client-3.1.1.jar
• 测试工具：基于该客户端的DBeaver、Openfire（Heidi及MariaDB ODBC通过命名管道可正常连接）

已尝试的连接URL #

jdbc:mariadb://localhost/?pipe=MySQL
jdbc:mariadb://localhost/?pipe=\.\pipe\MySQL
jdbc:mariadb://localhost/?pipe=\\.\pipe\\MySQL
jdbc:mariadb://localhost/?pipe=//./pipe/MySQL
jdbc:mysql://localhost/?protocol=pipe&permitMysqlScheme

额外尝试的配置方式 #

• 单独或组合使用pipe/pipeName/socket/socketName/socketPath参数
• 尝试MySQL的socketFactory，但MariaDB的工厂未知且MySQL工厂不被兼容
• 在URL参数部分或主机部分设置protocol=pipe
• 使用localhost、.作为主机，或不指定主机（:///）

报错情况 #

所有尝试均失败，多数情况报错“hostname must be set”，设置pipe参数时则报错“the address can't be null”。而使用MySQL Java客户端时，仅需输入jdbc:mysql:///?protocol=pipe即可正常连接。

可行解决方案 #

经过验证，针对MariaDB Java客户端在Windows上的命名管道连接，以下配置可正常工作：

1. 使用正确的JDBC URL格式
   必须通过socketPath参数指定完整的命名管道路径，同时主机部分留空（使用:///），示例URL：

   jdbc:mariadb:///?socketPath=\\.\pipe\MySQL
   

   注：MySQL是默认的命名管道名称，若你的数据库修改过管道名称，请替换为对应值。

2. 工具端配置细节

   • DBeaver：选择MariaDB驱动后，进入连接设置的「高级」选项卡，添加socketPath参数，值设为\\.\pipe\MySQL，主机名留空即可。
   • Openfire：直接在数据库配置中填入上述完整的JDBC URL，无需额外参数。

3. 版本兼容性验证
   若使用的客户端版本过旧可能存在命名管道支持bug，建议确保使用3.1.x及以上的稳定版（需适配你的Java运行环境）。

失败原因分析 #

• MariaDB Java客户端与MySQL客户端的命名管道参数逻辑不同：MySQL用protocol=pipe触发管道连接，而MariaDB需要显式指定socketPath来指向命名管道路径，pipe/socketName等参数并非正确的触发项。
• 当指定localhost为主机时，客户端会优先尝试TCP连接而非管道，留空主机部分可强制客户端使用指定的socketPath。

内容的提问来源于stack exchange，提问作者Bowman