MySQL / 系统课时
设计事务重试与幂等
设计事务重试与幂等
死锁和锁等待超时不应简单地“无限重试”。可靠做法是只重试明确的瞬时错误,限制次数并加入退避,同时用幂等键和状态条件确保同一业务请求即使执行多次,也只产生一次业务副作用。
学习目标
- 区分可重试的锁竞争错误与不可重试错误
- 实现有限次数、带退避的事务重试
- 用唯一幂等键和状态条件保证重复请求安全
把重试限定在事务边界
MySQL 检测到死锁时会回滚其中一个事务,并返回错误码 1213;锁等待超过 innodb_lock_wait_timeout 时常见错误码为 1205。这两类错误通常可以重新执行整个事务,而不是从失败语句继续。
重试必须有上限,并在每次失败后增加等待时间和少量随机抖动。否则高并发下大量事务会在同一时间立即重放,形成新的锁竞争尖峰。语法错误、唯一约束冲突、数据校验失败等确定性错误则不应纳入同一重试循环。

重试边界必须覆盖事务内所有读写。若只重跑最后一条 UPDATE,前面已经读取的数据可能已经过期,业务判断也可能不再成立。
用幂等记录封住重复副作用
下面创建一个最小示例:订单表保存已支付金额,命令表用 idempotency_key 唯一约束同一支付请求。两张表必须在同一个 MySQL 实例和同一个事务中更新,才能让“业务变更”和“幂等状态”一起提交或一起回滚。
DROP TABLE IF EXISTS payment_command_demo;
DROP TABLE IF EXISTS order_demo;
CREATE TABLE order_demo (
order_id BIGINT PRIMARY KEY,
paid_amount DECIMAL(12,2) NOT NULL DEFAULT 0
) ENGINE=InnoDB;
CREATE TABLE payment_command_demo (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
idempotency_key VARCHAR(64) NOT NULL,
order_id BIGINT NOT NULL,
amount DECIMAL(12,2) NOT NULL,
status ENUM('PENDING', 'DONE') NOT NULL,
UNIQUE KEY uk_idempotency_key (idempotency_key)
) ENGINE=InnoDB;
INSERT INTO order_demo (order_id, paid_amount)
VALUES (2001, 0);预期结果
两张 InnoDB 表创建成功,order_demo 写入 1 行初始订单数据。唯一键负责回答“这是不是同一个业务请求”,状态字段负责回答“这个请求是否已经完成”。两者缺一不可:只有唯一键而没有状态,应用无法安全地区分正在执行和已经执行;只有状态而没有唯一键,则并发重复请求仍可能插入多条记录。
在应用层实现有限退避重试
下面示例使用 mysql-connector-python。连接参数从环境变量读取;先执行上一节 SQL 建表。代码连续调用两次相同的幂等键,第二次不会再次增加订单的已支付金额。
import os
import random
import time
import mysql.connector
from mysql.connector import Error
RETRYABLE_ERRNOS = {1205, 1213}
MAX_ATTEMPTS = 4
def connect():
return mysql.connector.connect(
host=os.getenv('MYSQL_HOST', '127.0.0.1'),
port=int(os.getenv('MYSQL_PORT', '3306')),
user=os.getenv('MYSQL_USER', 'root'),
password=os.getenv('MYSQL_PASSWORD', ''),
database=os.environ['MYSQL_DATABASE'],
autocommit=False,
)
def pay_once(idempotency_key, order_id, amount):
for attempt in range(1, MAX_ATTEMPTS + 1):
cnx = connect()
cur = cnx.cursor(dictionary=True)
try:
cnx.start_transaction()
cur.execute(
'''INSERT INTO payment_command_demo
(idempotency_key, order_id, amount, status)
VALUES (%s, %s, %s, 'PENDING')
ON DUPLICATE KEY UPDATE id = id''',
(idempotency_key, order_id, amount),
)
cur.execute(
'''SELECT id, status
FROM payment_command_demo
WHERE idempotency_key = %s
FOR UPDATE''',
(idempotency_key,),
)
command = cur.fetchone()
if command['status'] == 'DONE':
cnx.commit()
return 'already_done'
cur.execute(
'''UPDATE order_demo
SET paid_amount = paid_amount + %s
WHERE order_id = %s''',
(amount, order_id),
)
if cur.rowcount != 1:
raise RuntimeError('order not found')
cur.execute(
'''UPDATE payment_command_demo
SET status = 'DONE'
WHERE id = %s AND status = 'PENDING' ''',
(command['id'],),
)
cnx.commit()
return 'done'
except Error as exc:
cnx.rollback()
if exc.errno not in RETRYABLE_ERRNOS or attempt == MAX_ATTEMPTS:
raise
delay = 0.05 * (2 ** (attempt - 1)) + random.uniform(0, 0.03)
time.sleep(delay)
except Exception:
cnx.rollback()
raise
finally:
cur.close()
cnx.close()
if __name__ == '__main__':
key = 'pay-order-2001-v1'
print(pay_once(key, 2001, 99.00))
print(pay_once(key, 2001, 99.00))预期输出
done
already_done实际连接地址、端口和数据库名以环境变量为准。若运行期间真的发生 1205 或 1213,中间会先回滚并等待,再从事务开头重新执行;达到第 4 次仍失败时,异常会向上抛出,由调用方决定返回错误或进入补偿流程。
幂等条件要覆盖业务语义
幂等键应由业务请求天然唯一的信息生成,例如支付单号、订单号加操作版本,而不是每次重试都生成新的 UUID。否则数据库看到的是不同请求,唯一约束就无法阻止重复执行。
状态条件同样重要。像 UPDATE ... WHERE status = 'PENDING' 这样的条件更新,可以把合法状态迁移写进 SQL;如果影响行数为 0,应用应读取当前状态并判断是“已经完成”还是“状态非法”,而不是盲目再次写入。
设定重试停止条件
一个可控的重试策略至少包含三道边界:只处理明确的瞬时错误;限制最大次数;每次失败后退避。若锁竞争持续存在,重试只能缓解偶发冲突,不能替代缩短事务、固定加锁顺序和治理热点行。
最终目标不是“让失败自动消失”,而是让同一业务请求在发生死锁、超时或客户端重复提交时,最多产生一次有效状态迁移,并在超过重试预算后清晰失败。