← 返回错误码列表

MySQL错误码 1153 分析与解决方案

错误信息

Error 1153

获得的数据包大于max_allowed_packet字节。

你的PHP应用在使用PDO连接MySQL时遇到了数据包大小限制问题：

'pdo_code' => '08S01',
'db_code' => 1153,
'db_error' => 'Got a packet bigger than \'max_allowed_packet\' bytes'

解决方案

  • 增加MySQL服务器的max_allowed_packet配置
  • 优化查询，减少单次传输的数据量
  • 分批处理大数据量的插入或更新操作
  • 检查应用程序中的大字段数据（如BLOB、TEXT）
  • 使用压缩连接或分块传输
  • 监控和优化网络传输性能

PHP分批处理示例代码

// 大批量数据插入的分批处理
$largeData = // 你的大数据数组;
$batchSize = 1000; // 每批处理1000条记录
$batches = array_chunk($largeData, $batchSize);

foreach ($batches as $batch) {
  try {
    $pdo->beginTransaction();
    
    // 构建批量插入语句
    $placeholders = [];
    $values = [];
    foreach ($batch as $item) {
      $placeholders[] = '(?, ?, ?)';
      $values = array_merge($values, [$item['field1'], $item[$item['field3']]);
    }
    
    $sql = "INSERT INTO table_name (field1, field2, field3) VALUES " . implode(', ', $placeholders);
    $stmt = $pdo->prepare($sql);
    $stmt->execute($values);
    
    $pdo->commit();
  } catch (PDOException $e) {
    if ($pdo->inTransaction()) {
      $pdo->rollBack();
    }
    // 记录错误并继续处理下一批
    error_log("批量插入失败: " . $e->getMessage());
  }
}

数据包限制模拟演示

数据包大小限制通常发生在传输大量数据时：

应用程序

1. 准备插入 10,000条记录

2. 构建大型SQL语句

3. 发送到MySQL服务器...

MySQL服务器

1. 接收数据包

2. 检测到数据包大小: 20MB

3. 比较max_allowed_packet设置: 16MB

4. 数据包超出限制！

错误响应

MySQL拒绝处理请求并返回错误：

1153

Got a packet bigger than 'max_allowed_packet' bytes

配置优化

1. MySQL服务器配置

配置项 默认值 推荐值 说明
max_allowed_packet 4MB-64MB 16MB-256MB 最大允许的数据包大小
net_buffer_length 16KB 64KB-1MB 网络缓冲区大小

2. 客户端配置

  • 在my.cnf中设置max_allowed_packet
  • 重启MySQL服务使配置生效
  • 检查应用程序的连接配置

3. 应用程序优化

  • 使用分批处理大量数据
  • 优化查询返回的字段数量
  • 避免在单次查询中返回过多数据
  • 使用LIMIT分页查询

调试工具

使用以下MySQL命令检查当前配置：

# 查看当前数据包大小限制
SHOW VARIABLES LIKE 'max_allowed_packet';

# 查看网络缓冲区大小
SHOW VARIABLES LIKE 'net_buffer_length';

# 临时设置数据包大小（当前会话）
SET GLOBAL max_allowed_packet = 1024*1024*64; # 64MB

配置修改方法

在my.cnf配置文件中添加：

[mysqld]
max_allowed_packet = 64M
net_buffer_length = 1M

重启MySQL服务：

# Ubuntu/Debian
sudo systemctl restart mysql

# CentOS/RHEL
sudo systemctl restart mysqld

# macOS (Homebrew)
brew services restart mysql