MuleSoft 4.x仅本地环境连接MySQL出现Communications link failure报错问题

问题场景 #

MuleSoft 4.x运行时和MySQL服务同机部署在IP为10.0.2.200的服务器上时，无法通过localhost连接本地MySQL，但可以正常连接远程MySQL服务；将MuleSoft运行时迁移到其他服务器（如10.0.2.202）后，可正常访问10.0.2.200上的MySQL服务，MySQL本身运行状态正常。

报错详情：Caused by: org.mule.runtime.extension.api.exception.ModuleException: java.sql.SQLException: Cannot get connection for URL jdbc:mysql://localhost:3306/test?logger=org.mule.extension.db.api.logger.MuleMySqlLogger : Communications link failure

• MySQL本地用户权限隔离：MySQL对localhost登录的账号和127.0.0.1/内网IP登录的账号权限是独立配置的，远程机器用内网IP访问走的是网段权限规则，本地用localhost访问走的是本地专属权限规则，二者不互通。
• JDBC协议默认逻辑问题：MuleSoft 4.x内置的MySQL 8.x以上版本JDBC驱动，对localhost连接默认优先尝试Unix Socket连接，若MySQL未开启Unix Socket监听或socket路径不匹配，就会触发通信链路报错，而用IP连接时默认走TCP协议，不会触发该问题。
• 本地hosts配置异常：若hosts文件中localhost优先绑定了::1（IPv6本地回环地址），但MySQL只监听了IPv4的127.0.0.1，也会导致连接失败。

1. 补充MySQL本地账号权限 #

登录MySQL执行以下命令，给业务账号开启localhost登录权限：

-- 替换your_user、your_password为实际的数据库账号密码
GRANT ALL PRIVILEGES ON test.* TO 'your_user'@'localhost' IDENTIFIED BY 'your_password';
FLUSH PRIVILEGES;

可执行SELECT user,host FROM mysql.user;验证现有账号的host绑定配置。

2. 强制JDBC走TCP协议连接 #

修改JDBC连接URL，添加protocol=tcp参数，强制跳过Unix Socket连接尝试：

jdbc:mysql://localhost:3306/test?logger=org.mule.extension.db.api.logger.MuleMySqlLogger&protocol=tcp

如果使用MySQL 8.x以上版本驱动，可额外添加useSSL=false&allowPublicKeyRetrieval=true参数避免SSL校验导致的连接失败。

3. 替换连接地址绕开localhost规则 #

直接将连接URL中的localhost替换为服务器本地内网IP（示例中的10.0.2.200）或127.0.0.1，绕开localhost的专属权限和协议逻辑，该方案和远程机器连接逻辑完全一致，兼容性最高。

4. 修复本地hosts配置 #

检查服务器/etc/hosts（Windows系统路径为C:\Windows\System32\drivers\etc\hosts），确保localhost优先绑定IPv4地址：

127.0.0.1   localhost
::1         localhost

若不需要IPv6支持，可临时注释掉::1对应的localhost行验证问题。

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