0

0

php怎么实现API请求幂等令牌_php如何防止重复提交造成资源重复创建

雪夜

雪夜

发布时间:2026-03-18 20:49:49

|

397人浏览过

|

来源于php中文网

原创

不靠谱,uniqid()毫秒级精度且无熵,高并发易碰撞;未绑定用户标识会导致跨用户复用。应组合user_id、时间、随机盐与密钥哈希,存Redis并设过期。

php怎么实现api请求幂等令牌_php如何防止重复提交造成资源重复创建

uniqid() + 用户会话生成幂等令牌靠谱吗

不靠谱,uniqid() 默认不带熵、毫秒级精度,在高并发下极易碰撞;且脱离用户上下文(比如没绑定 session_iduser_id)会导致跨用户复用,失去幂等性意义。

真正可用的做法是组合可信因子:

  • hash_hmac('sha256', $user_id . ':' . time() . ':' . random_bytes(16), $_SERVER['HTTP_X_API_SECRET'] ?? 'fallback') —— 依赖密钥防伪造,含用户标识和随机盐
  • 把结果截取为 32 位字符串存入 Redis,设置 10 分钟过期:SET idempotency:abc123 {...} EX 600 NX
  • 客户端首次请求时提交该令牌,后端用 GET 查 Redis,命中则拒绝后续相同令牌的写操作

API 接收幂等令牌后,怎么判断该放行还是拦截

关键不是“有没有令牌”,而是“这个令牌是否已成功处理过”。不能只查存在性,必须区分三种状态:未见过、正在处理中、已成功完成。

推荐用 Redis 的原子操作实现状态机:

立即学习PHP免费学习笔记(深入)”;

  • 收到请求时,先 SET idempotency:abc123 processing EX 60 NX,失败说明已被占用,直接返回 409 Conflict
  • 业务逻辑执行成功后,SET idempotency:abc123 success EX 86400(长期保留结果供重试查询)
  • 若业务失败或超时,需主动 DEL idempotency:abc123,否则该令牌会被锁死一小时

注意:NX 是必须的,漏掉就会覆盖状态,导致重复提交被误放行。

Elser AI
Elser AI

一站式AI动漫、短剧生成平台

下载

前端重复点击提交,后端靠幂等令牌能完全挡住吗

不能。令牌只是服务端防线,它挡不住前端反复发同一请求(比如用户狂点“创建订单”按钮),但能确保即使多个请求抵达,也只创建一个资源。

真实场景要分层防御:

  • 前端加按钮禁用 + 防抖:button.disabled = true,配合 setTimeout 重置,治标
  • 后端校验 Idempotency-Key 请求头(不是 query 或 body),避免被日志/代理意外泄露
  • 响应必须带明确状态:201 Created(首次)、200 OK(重试返回缓存结果)、409 Conflict(非法重放)
  • 不要在 GET 上做幂等控制——语义不符,且浏览器/CDN 可能缓存

PHP 里用 file_get_contents() 调用自身 API 做幂等校验会出问题吗

会。本地回环调用(localhost)容易触发连接池耗尽、超时堆积,尤其在 FPM 模式下,还可能绕过 Nginx 的限流或 JWT 校验中间件。

更稳的方式是直连存储层:

  • PDORedis 扩展直接查状态,不走 HTTP 协议栈
  • 如果必须走 HTTP(比如微服务拆分),改用 cURL 并显式设 CURLOPT_TIMEOUT_MS = 300,避免阻塞主请求
  • 别把幂等校验逻辑写进 Laravel 的 middleware 再调用 Http::post() —— 这等于让中间件自己发 HTTP 请求,递归风险高

最常被忽略的一点:幂等键的生命周期必须长于客户端最大重试窗口。比如前端设了 3 次重试、每次间隔 2 秒,那 Redis key 至少得活 10 秒以上,否则第二次重试就查不到记录,变成新请求。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2968

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1769

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1585

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

1204

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1646

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1316

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1786

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1334

2023.11.13

Python WebSocket实时通信与异步服务开发实践
Python WebSocket实时通信与异步服务开发实践

本专题聚焦 Python 在实时通信场景中的开发实践,系统讲解 WebSocket 协议原理、长连接管理、消息推送机制以及异步服务架构设计。内容包括客户端与服务端通信实现、连接稳定性优化、消息队列集成及高并发处理策略。通过完整案例,帮助开发者构建高效稳定的实时通信系统,适用于聊天应用、实时数据推送等场景。

7

2026.03.18

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 13.8万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.4万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1万人学习

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

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