连接远程MySQL未发查询却触发PacketTooBigException问题求助

我之前碰到过一模一样的坑！你这个情况特别容易被报错信息误导——明明没发任何查询，却提示查询数据包过大，其实问题出在MySQL连接握手阶段的认证/协商数据包超标，而不是查询语句本身。

先搞懂为什么会出现这个异常 #

com.mysql.cj.jdbc.exceptions.PacketTooBigException: Packet for query is too large (4739923 > 65535). You can change this value on the server by setting the 'max_allowed_packet' variable

这个报错里的"Packet for query"描述太坑人了！MySQL的数据包不止包含查询语句，连接握手时的加密信息、驱动与服务器的协商数据都算数据包。远程连接时，比如开启SSL加密、驱动传递扩展元数据，都会让初始数据包超过默认的64K（65535字节），直接触发异常。

分步解决办法 #

1. 调整MySQL服务器的max_allowed_packet参数

• 临时生效（重启MySQL后失效）：登录MySQL控制台执行：

  SET GLOBAL max_allowed_packet = 10*1024*1024; -- 设置为10M，足够覆盖你遇到的4.7M场景
  

  执行后需要重新建立连接才能生效。
• 永久生效：修改MySQL的配置文件（Linux是my.cnf，Windows是my.ini），在[mysqld]节点下添加：

  max_allowed_packet=10M
  

  保存后重启MySQL服务即可。

2. 同步调整JDBC连接URL的参数

光改服务器端还不够，驱动端也要对应设置，避免两边参数不匹配：
在你的JDBC连接URL中添加maxAllowedPacket=10485760（10485760就是10M的字节数），示例代码如下：

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

public class Main {
    static Connection getConnection() throws SQLException {
        // 注意添加maxAllowedPacket参数，数值和服务器端保持一致
        String url = "jdbc:mysql://your-remote-host:3306/your-db?useSSL=true&serverTimezone=UTC&maxAllowedPacket=10485760";
        String user = "your-username";
        String password = "your-password";
        return DriverManager.getConnection(url, user, password);
    }

    public static void main(String[] args) {
        try (Connection conn = getConnection()) {
            System.out.println("远程MySQL连接成功！");
            // 此时还未执行任何查询，验证连接是否正常
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

3. 额外排查点（针对旧驱动版本）

如果你用的是MySQL 5.x系列的JDBC驱动，可能还需要添加useOldAliasMetadataBehavior=true参数，避免驱动在握手阶段传递过多元数据导致数据包过大。

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