0

0

Golang Web如何防止重复提交_Golang接口幂等性设计

P粉602998670

P粉602998670

发布时间:2026-02-03 09:51:09

|

860人浏览过

|

来源于php中文网

原创

前端防重提交不能替代后端幂等校验,因仅防手抖,无法应对脚本调用、超时重试等真实重复场景;后端须用request_id+Redis原子操作或数据库唯一约束实现可靠幂等。

golang web如何防止重复提交_golang接口幂等性设计

为什么前端防重提交不能替代后端幂等校验

用户点击按钮后禁用、加 loading、拦截重复请求,这些前端手段只防“手抖”,挡不住脚本批量调用、网络超时重试、F5 刷新重发。真正的重复提交一定发生在服务端——比如支付接口被 Nginx 重试两次、客户端因超时主动重发、消息队列重复投递。所以 前端限制是体验层,后端幂等是可靠性底线

用请求唯一标识(request_id)+ Redis 缓存实现简单幂等

核心思路:每个请求带一个客户端生成的 request_id(如 UUID),服务端在业务逻辑执行前先查 Redis 是否已存在该 ID;存在则直接返回上次结果(或空响应),不存在则写入并继续处理。

实操要点:

  • request_id 必须由客户端生成并透传(避免服务端生成导致重试时 ID 变化)
  • Redis key 建议用 "reqid:" + request_id,过期时间设为业务最大处理耗时的 2–3 倍(如支付接口设 10 分钟)
  • 写入 Redis 要用 SET key value EX seconds NX 原子操作,防止并发写入冲突
  • 成功写入后才执行业务逻辑;若失败需回滚 Redis 写入(但实际中更推荐“写入即承诺”,失败也保留记录并返回错误)

示例伪代码:

立即学习go语言免费学习笔记(深入)”;

360智绘
360智绘

360智脑推出的AI绘画创作与分享平台

下载
if !redis.SetNX(ctx, "reqid:"+req.Header.Get("X-Request-ID"), "processing", 600*time.Second) {
    // 已存在,查历史结果或直接返回 409 Conflict
    return
}
// 执行业务逻辑
result := doPayment(req)
redis.Set(ctx, "reqid:"+req.Header.Get("X-Request-ID"), result, 600*time.Second)

数据库唯一约束比 Redis 更可靠,但适用场景有限

对创建类操作(如订单、退款单),直接在 DB 表加联合唯一索引(如 user_id + biz_norequest_id 字段)是最强兜底。即使 Redis 挂了、缓存穿透、或并发极高,DB 层仍能靠唯一键拒绝重复插入。

注意点:

  • 必须捕获 ERROR 1062 (23000): Duplicate entry 类错误,并转换为业务友好的响应(如 “该操作已处理”)
  • 不能依赖事务自动回滚来“假装没发生”——重复插入失败本身就要被感知和响应
  • 不适用于更新类操作(如“扣余额”),因为 UPDATE 不触发唯一约束,需配合状态机或版本号

GET 请求天然幂等,但 POST/PUT/PATCH 都要默认视为非幂等

HTTP 规范里只有 GETHEADOPTIONSTRACE 是安全且幂等的;POST 明确是非幂等的(RFC 7231)。别因为“这个接口只是改个状态”就跳过幂等设计——只要它接受外部触发、影响数据或产生副作用,就必须考虑重试、代理重发、浏览器刷新带来的重复。

特别提醒:curl -X POST 测试时反复敲回车、Postman 点多次、Nginx proxy_next_upstream error timeout 配置,都会真实触发重复提交。线上出问题从来不是“理论上不会”,而是“刚好撞上了”。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

184

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

230

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

344

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

210

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

397

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

282

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

194

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

540

2025.06.17

Python 序列化
Python 序列化

本专题整合了python序列化、反序列化相关内容,阅读专题下面的文章了解更多详细内容。

12

2026.02.02

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
进程与SOCKET
进程与SOCKET

共6课时 | 0.4万人学习

Redis+MySQL数据库面试教程
Redis+MySQL数据库面试教程

共72课时 | 6.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号