You need to enable JavaScript to run this app. 同一VPS上的Minecraft服务器访问本地MySQL出现Communications link failure错误
优惠活动
大模型
产品
解决方案
定价
更多

同一VPS上的Minecraft服务器访问本地MySQL出现Communications link failure错误

排查&解决步骤

1. 确认MySQL监听状态

本地登录MySQL正常仅代表套接字连接可用,TCP端口监听可能异常,执行命令验证:

netstat -tulpn | grep mysql

正常输出应包含127.0.0.1:3306或0.0.0.0:3306的监听记录:

  • 如果仅监听IPv6地址:::3306,或无3306端口监听记录,编辑MySQL配置文件/etc/mysql/mysql.conf.d/mysqld.cnf,将bind-address参数改为127.0.0.1(同主机访问用本地回环最安全),修改后执行sudo service mysql restart生效。

2. 核对JDBC连接配置

前往MC服务端对应管理插件的配置文件,核查连接参数:

  • JDBC连接串格式应为jdbc:mysql://127.0.0.1:3306/servermanager?useSSL=false&serverTimezone=UTC,确认端口、库名拼写正确,必须配置serverTimezone参数(你使用的cj驱动对应MySQL8.0+版本,缺时区参数会直接触发连接失败)
  • 用配置文件中的账号密码本地登录验证权限:
mysql -u <配置中的用户名> -p'<配置中的密码>'

登录成功后执行以下命令确认账号权限:

SHOW GRANTS FOR '<配置中的用户名>'@'127.0.0.1';

如果无servermanager库的访问权限,执行授权:

GRANT ALL ON servermanager.* TO '<配置中的用户名>'@'127.0.0.1';
FLUSH PRIVILEGES;

3. 排查超时与防火墙规则

执行SQL查看MySQL超时配置:

SHOW VARIABLES LIKE 'wait_timeout';
SHOW VARIABLES LIKE 'interactive_timeout';

默认值为28800秒(8小时),如果被修改为过短的数值,会导致MC连接池的长连接被主动断开,修改mysqld.cnf中对应参数恢复默认值即可。
另外执行sudo ufw status确认本地3306端口没有被防火墙规则拦截,本地回环流量默认全部放通,如有拦截规则新增放行规则即可。

4. 验证驱动与MySQL版本兼容性

Ubuntu18.04默认开启无人值守自动更新,如果MySQL被自动跨大版本升级(比如从5.7升级到8.0),原有插件携带的JDBC驱动和新版本MySQL不兼容也会触发该报错,替换插件目录下的MySQL驱动jar包为对应MySQL版本的匹配版本即可。


内容的提问来源于stack exchange,提问作者BigDashT

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 06:54:04