如何用MySQL唯一索引和事务保证幂等性

大萱姑娘_6116

大萱姑娘_6116

2026-08-22

386人浏览

原创

唯一索引不自动拦截重复请求,仅在insert/update时抛出sqlstate 23000错误,需应用层捕获处理;insert on duplicate key update是原子化幂等方案,要求冲突字段有唯一索引且update子句幂等;select for update仅适用于状态流转类更新,需显式事务、精确索引和影响行数校验;null值在唯一索引中不参与校验,易导致绕过约束,应设not null或用函数索引规避。

如何用mysql唯一索引和事务保证幂等性

唯一索引本身不自动拦截重复请求,只在INSERT/UPDATE时抛错

很多人以为加了UNIQUE KEY就能“自动幂等”,但实际是:MySQL只在执行INSERTUPDATE语句时校验约束,一旦语句触发Duplicate entry错误(如ERROR 1062 (23000): Duplicate entry 'xxx' for key 'uq_request_id'),应用层必须自己捕获并决定下一步——不是“自动跳过”,而是“报错后你得处理”。

  • 错误类型固定为SQLState: 23000,对应MySQLIntegrityConstraintViolationException(Java)或IntegrityError(Python)
  • 仅靠INSERT INTO t(id, data) VALUES(?, ?) + 唯一索引,无法区分“首次成功”和“重复忽略”,业务逻辑可能已部分执行(比如发消息、扣库存)
  • 如果事务里混了其他DML操作(如先UPDATE account SET balance = balance - 100INSERT),唯一索引报错时前面的操作不会自动回滚——除非整个事务被正确声明和传播

INSERT ON DUPLICATE KEY UPDATE 是最简可靠方案

它把“插入 or 更新”原子化,避免应用层判断分支,且全程在单条语句内完成约束校验与写入,天然规避竞态窗口。

  • 必须确保冲突字段(如request_id)上有UNIQUEPRIMARY KEY索引,否则ON DUPLICATE KEY不生效
  • UPDATE子句里禁止写非幂等表达式,例如counter = counter + 1——重复请求会累加,不是幂等
  • 想标记是否重复,可设is_repeated TINYINT DEFAULT 0字段:ON DUPLICATE KEY UPDATE is_repeated = 1, updated_at = NOW()
  • 示例:INSERT INTO idempotent_log (request_id, payload) VALUES ('req-abc', '{"user":123}') ON DUPLICATE KEY UPDATE updated_at = NOW();

SELECT FOR UPDATE + 事务只适用于状态流转类更新

它不适合“防重插入”,只适合“查到记录后再改状态”的场景,且极易因索引缺失或事务范围不当失效。

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载
  • SELECT ... FOR UPDATE必须走主键或唯一索引,否则升级为间隙锁甚至表锁,拖垮并发性能
  • 必须包在显式事务中(START TRANSACTION@Transactional),且SELECT和后续UPDATEWHERE条件完全一致(包括状态判断)
  • 执行完UPDATE后,务必检查影响行数——为0说明已被抢先更新,此时应直接返回而非重试
  • 错误示范:SELECT * FROM orders WHERE order_id = 'ORD123' FOR UPDATE;INSERT ...(中间无记录,锁没生效,照样并发插入)

唯一索引字段允许NULL,但多个NULL不违反唯一性

这是常被忽略的陷阱:InnoDB认为NULL != NULL,所以UNIQUE INDEX (user_id)字段可以存多条user_id IS NULL的记录。若业务用NULL表示“未分配用户”,那这些记录就绕过了唯一性校验。

  • 解决方案:用DEFAULT ''替代NULL,或建函数索引(MySQL 8.0+):CREATE UNIQUE INDEX uq_nonnull ON t ((COALESCE(user_id, '')));
  • 更稳妥做法:业务层禁止传NULL,数据库字段设NOT NULL,配合默认值或空字符串
  • 复合唯一索引(如(ref_type, ref_id))中任一字段为NULL,整行都不参与唯一性比对——这点比单列更隐蔽

唯一索引和事务配合能实现强幂等,但关键不在“加了索引”,而在“怎么用那条SQL”以及“事务边界划在哪”。漏掉ON DUPLICATE KEYUPDATE子句细节,或让FOR UPDATE查不到记录,结果就是看着像幂等,实际照常脏写。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

3743

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

791

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

969

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

5521

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

2503

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

5500

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

7161

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

970

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

852

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 170人学习

使用phpenv集成环境安装极致CMS
使用phpenv集成环境安装极致CMS

共2课时 | 274人学习