MyISAM引擎完全不支持XA分布式事务,因其缺失XA接口、事务状态机和prepare日志机制,执行XA PREPARE必报ERROR 1399(XAE00);仅InnoDB配合binlog可实现两阶段提交。

MyISAM 执行 XA PREPARE 必报 ERROR 1399 (XAE00)
MyISAM 引擎压根没实现 XA 接口——这不是配置漏了、版本低或权限问题,而是引擎层彻底缺失两阶段提交(2PC)所需的事务状态机、prepare 日志和回滚段机制。只要 XA PREPARE 语句涉及任意 MyISAM 表,MySQL 立刻中断整个 XA 流程,返回 ERROR 1399 (XAE00): XAER_RMFAIL。此时事务连 prepare 阶段都进不去,更不会写入 prepare 日志,XA RECOVER 自然查不到任何记录。
确认表是否真为 InnoDB,别信 SHOW CREATE TABLE 的 ENGINE 字段
很多库存在隐式 MyISAM 表:建表时没显式写 ENGINE=InnoDB,而老版本 MySQL 默认引擎是 MyISAM;迁移库中也可能混入未转换的表。仅靠 SHOW CREATE TABLE t1 看一眼不保险,因为输出可能被缓存或误读。
- 唯一可靠方式是查
information_schema.TABLES:SELECT ENGINE FROM information_schema.TABLES WHERE TABLE_SCHEMA='db' AND TABLE_NAME='t1' - 批量扫描全库:
SELECT TABLE_SCHEMA, TABLE_NAME, ENGINE FROM information_schema.TABLES WHERE ENGINE = 'MyISAM' - 特别注意视图底层表、临时表、分区表的每个子分区——它们各自可指定引擎,XA START 一碰到 MyISAM 分区就崩
max_prepared_transactions=0 是默认禁用 XA 的硬开关
即使所有表都是 InnoDB,XA PREPARE 仍可能失败,原因往往是 max_prepared_transactions 仍为默认值 0。这个参数控制 MySQL 能持久化多少个 prepared 状态的 XA 事务,设为 0 意味着直接拒绝 prepare 请求,报错可能是 ERROR 1399 (XAE09): XAER_RMFAIL: The command cannot be executed when global transaction is in the IDLE state。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 必须在
my.cnf的[mysqld]段中显式设置,例如:max_prepared_transactions=128 - 该值需 ≥ 预期并发 XA 事务数(含悬挂事务),建议按峰值并发的 1.5 倍预估,最小不低于 32
- 修改后必须重启 MySQL 生效,
SET GLOBAL动态修改无效
XA_RECOVER 查不到 prepared 记录?先看 INNODB_TRX 和 SHOW ENGINE INNODB STATUS
XA RECOVER 返回空,并不等于没有悬挂事务。MyISAM 会让 XA 在 prepare 前就失败,根本不会落日志;而真正卡在 prepare 状态的事务,得从 InnoDB 内部状态里挖。
- 查
INFORMATION_SCHEMA.INNODB_TRX中状态为'PREPARED'的记录:SELECT * FROM information_schema.INNODB_TRX WHERE TRX_STATE = 'PREPARED' - 若为空,再执行
SHOW ENGINE INNODB STATUS\G,搜索TRANSACTIONS段落,找有没有state: prepared的条目 - 两者都空,基本可断定:XA 事务根本没走到 prepare 阶段——极大概率是某张参与表为 MyISAM,或
binlog_format=STATEMENT+ 非确定函数(如NOW())导致静默失败
真实部署中最容易被忽略的点是:你改完了所有表的引擎,也调大了 max_prepared_transactions,但忘了检查 binlog 是否开启(log_bin=ON)以及 innodb_flush_log_at_trx_commit=1 是否生效——这两项不满足,prepare 日志无法落盘,XA 就不具备崩溃恢复能力。

















