MySQL / 系统课时

设计事务重试与幂等

设计事务重试与幂等

死锁和锁等待超时不应简单地“无限重试”。可靠做法是只重试明确的瞬时错误,限制次数并加入退避,同时用幂等键和状态条件确保同一业务请求即使执行多次,也只产生一次业务副作用。

学习目标

  • 区分可重试的锁竞争错误与不可重试错误
  • 实现有限次数、带退避的事务重试
  • 用唯一幂等键和状态条件保证重复请求安全

把重试限定在事务边界

MySQL 检测到死锁时会回滚其中一个事务,并返回错误码 1213;锁等待超过 innodb_lock_wait_timeout 时常见错误码为 1205。这两类错误通常可以重新执行整个事务,而不是从失败语句继续。

重试必须有上限,并在每次失败后增加等待时间和少量随机抖动。否则高并发下大量事务会在同一时间立即重放,形成新的锁竞争尖峰。语法错误、唯一约束冲突、数据校验失败等确定性错误则不应纳入同一重试循环。

事务重试与幂等状态门禁

重试边界必须覆盖事务内所有读写。若只重跑最后一条 UPDATE,前面已经读取的数据可能已经过期,业务判断也可能不再成立。

用幂等记录封住重复副作用

下面创建一个最小示例:订单表保存已支付金额,命令表用 idempotency_key 唯一约束同一支付请求。两张表必须在同一个 MySQL 实例和同一个事务中更新,才能让“业务变更”和“幂等状态”一起提交或一起回滚。

sql
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);

预期结果

text
两张 InnoDB 表创建成功,order_demo 写入 1 行初始订单数据。

唯一键负责回答“这是不是同一个业务请求”,状态字段负责回答“这个请求是否已经完成”。两者缺一不可:只有唯一键而没有状态,应用无法安全地区分正在执行和已经执行;只有状态而没有唯一键,则并发重复请求仍可能插入多条记录。

在应用层实现有限退避重试

下面示例使用 mysql-connector-python。连接参数从环境变量读取;先执行上一节 SQL 建表。代码连续调用两次相同的幂等键,第二次不会再次增加订单的已支付金额。

python
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))

预期输出

text
done
already_done

实际连接地址、端口和数据库名以环境变量为准。若运行期间真的发生 1205 或 1213,中间会先回滚并等待,再从事务开头重新执行;达到第 4 次仍失败时,异常会向上抛出,由调用方决定返回错误或进入补偿流程。

幂等条件要覆盖业务语义

幂等键应由业务请求天然唯一的信息生成,例如支付单号、订单号加操作版本,而不是每次重试都生成新的 UUID。否则数据库看到的是不同请求,唯一约束就无法阻止重复执行。

状态条件同样重要。像 UPDATE ... WHERE status = 'PENDING' 这样的条件更新,可以把合法状态迁移写进 SQL;如果影响行数为 0,应用应读取当前状态并判断是“已经完成”还是“状态非法”,而不是盲目再次写入。

设定重试停止条件

一个可控的重试策略至少包含三道边界:只处理明确的瞬时错误;限制最大次数;每次失败后退避。若锁竞争持续存在,重试只能缓解偶发冲突,不能替代缩短事务、固定加锁顺序和治理热点行。

最终目标不是“让失败自动消失”,而是让同一业务请求在发生死锁、超时或客户端重复提交时,最多产生一次有效状态迁移,并在超过重试预算后清晰失败。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计事务重试与幂等

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通