ThinkPHP如何统计接口重复提交请求(完整源码)-ThinkPHP-PHP中文网

thinkphp 无内置接口重复提交统计功能，需自定义幂等指纹计数逻辑：先定义“重复”业务规则，再在请求入口用 cache::remember 埋点计数、落库，并结合中间件拦截、数据库聚合查询与前端按钮禁用协同实现。

thinkphp如何统计接口重复提交请求(完整源码)

直接说结论：ThinkPHP 没有内置「接口重复提交统计」功能，必须自己搭一层计数逻辑——关键不是记录“是否重复”，而是先定义“什么是重复”，再在请求入口处埋点比对、计数、落库。下面分场景讲清楚怎么做。

这是最常用也最稳妥的实时统计方式，适用于支付回调、订单创建等强一致性接口。核心是把「幂等键」和「计数动作」绑在一起，避免先查后增的竞态。

指纹必须排除动态参数：$fingerprint = md5($request->ip() . $request->url() . json_encode(array_filter($params, fn($k) => !in_array($k, ['timestamp', 'nonce', 'sign']), ARRAY_FILTER_USE_KEY)))
用 Cache::remember() 一步完成「查缓存→未命中则执行闭包→写入缓存」：Cache::remember('api:duplicate:' . $fingerprint, 120, function () use ($fingerprint) { Db::name('api_duplicate_log')->insert(['fingerprint' => $fingerprint, 'created_at' => date('Y-m-d H:i:s')]); return 1; })
注意：返回值是缓存内容（即 1），不是布尔值；若需统计总数，得额外查表：Db::name('api_duplicate_log')->whereTime('created_at', '-1 hour')->count()
别用 Cache::has() + Cache::set() 手动组合，高并发下会漏计

如果你需要区分「合法重试」和「恶意刷量」，就得在中间件里做更细粒度判断，比如同一 IP + 同一路径 + 间隔

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在 app/middleware/ApiDuplicateLogger.php 的 handle 方法里取关键字段：$ip = $request->ip(); $path = $request->url(); $time = time();
构造 Redis 键：$key = 'dup:ip:' . $ip . ':path:' . md5($path)，用 Cache::set($key, $time, 3) 写入时间戳
再读一次：$last = Cache::get($key); if ($last && $time - $last insert(['ip' => $ip, 'path' => $path, 'reason' => 'interval_too_short']); }
该方案不依赖请求参数，适合前端无幂等头、又无法改调用方的遗留接口
缺点：Redis TTL 精度只有秒级，Cache::get() 返回 null 时不能直接认为是首次请求，要结合业务兜底

光记录没用，还得能查出谁在刷、刷了多少。表结构必须支持按维度聚合，且避免 SELECT COUNT(*) 全表扫。

建表语句关键字段：id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT、fingerprint CHAR(32)（索引）、ip VARCHAR(45)、path VARCHAR(255)、created_at DATETIME、index idx_fingerprint (fingerprint)、index idx_ip_path_time (ip, path, created_at)
查最近 1 小时内每个 IP 的重复次数：Db::name('api_duplicate_log')->whereTime('created_at', '-1 hour')->group('ip')->having('COUNT(*) > 5')->field('ip,COUNT(*) as cnt')->select()
查某接口被重复触发最多的指纹：Db::name('api_duplicate_log')->where('path', '/v1/order/create')->group('fingerprint')->order('COUNT(*) DESC')->limit(5)->field('fingerprint,COUNT(*) as cnt')->select()
别用 UNIQUE(fingerprint) 做插入约束——重复请求本就是异常流，插入失败反而掩盖问题

后端统计再全，前端没反馈也是白搭。尤其 Ajax 场景下，用户根本不知道自己点了两次。

按钮禁用必须带恢复逻辑：$('#submit-btn').prop('disabled', true).text('提交中...'); setTimeout(() => $('#submit-btn').prop('disabled', false).text('提交'), 2000);
服务端返回重复标识时，前端要识别：if (res.code === 409 && res.data?.reason === 'duplicate_request') { Toast.warning('请求已处理，请勿重复操作'); }
关键：不要只靠前端控制，但也不能完全不控——按钮禁用 + 后端幂等锁 + 日志记录，三层缺一不可
容易被忽略的是「网络超时重试」：Axios 默认不重试，但某些 SDK 或网关会自动重发，这种请求的 X-Request-ID 头一致，建议把它纳入指纹

真正的难点不在代码怎么写，而在于「重复」的定义是否贴合业务。比如支付回调允许 3 次重试，但订单创建只允许 1 次；同一个指纹，5 分钟内重复算攻击，30 秒内重复可能是弱网重试。这些边界必须由业务方确认，不能只套模板。