MariaDB执行ALTER TABLE时报通信包写入错误的解决方案问询

针对你遇到的执行ALTER TABLE table ADD COLUMN column TEXT NOT NULL时连接阻塞、通信包写入错误，且调整max_allowed_packet后仅能成功一次的问题，我整理了几个可行的解决方向，按优先级尝试：

1. 修正max_allowed_packet的不合理设置 #

你设置的10000M过大，Windows环境下MariaDB的内存管理无法支撑这么大的单连接数据包上限，反而会导致内存分配异常，引发通信包写入错误。建议改成合理的数值，比如64M或128M（足够处理TEXT列的大内容）：

[mysqld]
max_allowed_packet=64M

修改后重启MariaDB服务，这个参数的调整是基础，先解决内存溢出导致的通信问题。

2. 使用Online DDL减少锁表时间 #

MariaDB 10.3支持InnoDB的Online DDL（在线数据定义语言），可以让ALTER操作在不锁表（或仅短时间锁表）的情况下执行，避免出现“无限循环”式的阻塞。尝试给ALTER语句添加ALGORITHM和LOCK子句：

ALTER TABLE table ADD COLUMN column TEXT NOT NULL, ALGORITHM=INPLACE, LOCK=NONE;

注意：部分场景下INPLACE算法不支持（比如表包含全文索引、空间索引等），如果执行报错，可以换成ALGORITHM=COPY，但这个算法会锁表，只是比默认方式更可控。

3. 优化pymysql的连接配置 #

你的Python连接可能因为超时设置不合理，导致ALTER执行过程中连接被异常中断，进而引发阻塞。建议在创建连接时添加超时参数，并用上下文管理器管理连接避免泄漏：

import pymysql

# 使用with语句自动管理连接和游标
with pymysql.connect(
    host='localhost',
    user='root',
    password='your_password',
    db='your_database',
    connect_timeout=30,
    read_timeout=120,  # 给ALTER操作足够的执行时间
    write_timeout=120,
    charset='utf8mb4'
) as conn:
    with conn.cursor() as cur:
        cur.execute("ALTER TABLE table ADD COLUMN column TEXT NOT NULL, ALGORITHM=INPLACE, LOCK=NONE;")
    conn.commit()

4. 分步骤添加非空TEXT列（针对大表） #

如果你的表数据量很大，直接添加NOT NULL的TEXT列会因为全表扫描和锁表导致长时间阻塞。可以拆分操作来降低影响：

• 第一步：先添加允许NULL的TEXT列

  ALTER TABLE table ADD COLUMN column TEXT NULL;
  

• 第二步：批量更新现有数据为默认值（如果需要），建议分批次执行避免锁表：

  UPDATE table SET column = '' WHERE column IS NULL LIMIT 1000;
  

  重复执行这条语句直到所有行都被更新。
• 第三步：修改列为NOT NULL

  ALTER TABLE table MODIFY COLUMN column TEXT NOT NULL;
  

5. 调整InnoDB缓冲池大小（针对Windows资源不足） #

你的innodb_buffer_pool_size=2033M如果在Windows系统内存较小（比如总内存4G/8G）的情况下，会占用过多系统内存，导致数据库运行不稳定。可以适当调小，比如改为1G（1024M）：

[mysqld]
innodb_buffer_pool_size=1024M

调整后重启服务，确保系统有足够的剩余内存供其他进程使用。

6. 检查当前数据库进程状态 #

如果执行ALTER时看起来“无限循环”，可以登录MariaDB执行SHOW PROCESSLIST;查看当前进程状态，确认ALTER操作是在执行中还是真的卡住了。如果是大表，ALTER本身就需要较长时间，耐心等待即可。

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