ThinkPHP 无内置 RateLimiter，需用 Cache::inc() 结合唯一键（IP+路径+时间窗口）和 Redis 原子操作实现限流，避免 File 驱动失效、key 冲突及 TTL 不匹配问题。
为什么 RateLimiter 在 ThinkPHP 里不能直接用 Laravel 那套
ThinkPHP 自身没有内置类似 Laravel 的 RateLimiter 类，也没有开箱即用的缓存限流中间件。硬搬 Laravel 的逻辑会卡在缓存键生成、请求标识提取、原子计数这些细节上，尤其在分布式部署时容易失效。
实操建议：
- 别试图封装一个“通用 RateLimiter 类”再塞进全局中间件——ThinkPHP 的请求生命周期和缓存驱动行为跟 Laravel 差异明显，容易漏掉
$request->ip()或$request->url()的拼接逻辑 - 优先用
Cache::inc()+ 过期时间控制，而不是先get再set，否则并发下会超限 - 注意 ThinkPHP 默认缓存驱动（如
File）不支持原子自增，必须切到Redis或Memcached
如何用 Cache::inc() 实现每分钟最多 10 次接口调用
核心是构造唯一缓存键 + 原子递增 + 设置 TTL。Key 必须包含用户标识（如 token、IP）、接口路径、时间窗口，三者缺一不可。
实操示例（放在控制器方法开头）：
立即学习“PHP免费学习笔记（深入）”；
// 示例：限制 /api/v1/user/profile 接口
$key = 'rate_limit:' . $request->ip() . ':' . md5('/api/v1/user/profile') . ':' . date('Y-m-d H:i');
$hit = Cache::inc($key, 1);
if ($hit === false) {
// 首次写入，设置过期时间为 60 秒后（注意：不是当前时间+60，而是相对 TTL）
Cache::set($key, 1, 60);
} elseif ($hit > 10) {
throw new HttpException(429, 'Too Many Requests');
}
关键点：
-
Cache::inc()在 Redis 驱动下是原子操作；File或Db驱动会返回false，必须兜底set - 时间窗口用
date('Y-m-d H:i')而非time()，避免跨秒抖动导致窗口错位 - 不要用
$request->route()->getName()当 key —— 路由名可能为空或重复，优先用实际访问路径
Cache::inc() 失败时为什么总是被忽略
常见错误现象：本地测试 OK，上线后限流完全不生效，日志里也无报错。
根本原因是缓存驱动配置没对齐：
- 开发环境用
File缓存，inc永远返回false，但代码里只判断了$hit > 10，没处理false场景，导致每次都被当成“第一次”，永远不触发限流 - 生产 Redis 连接失败时，
Cache::inc()静默失败并返回false，而多数人没加连接健康检查 - Redis 密码或数据库编号（
database）配错，Cache::get()可能返回空，但inc直接报错或静默失败
建议加一层兜底判断：
if ($hit === false) {
Cache::set($key, 1, 60);
$hit = 1;
}
多级限流怎么避免 key 冲突和误判
比如既要限制“单 IP 每分钟 10 次”，又要限制“单用户 ID 每小时 100 次”，两个规则共存时，key 命名必须隔离，且 TTL 必须严格对应窗口。
实操要点：
- IP 级：用
'ip_' . $request->ip() . '_' . date('Y-m-d H:i') - 用户级（需登录）：用
'user_' . $user->id . '_' . date('Y-m-d H')（注意这里是小时粒度） - 绝不混用同一前缀，例如都用
rate_limit:开头，否则Cache::clear()会误清其他规则 - 如果用
think-cache插件，确认其inc方法是否真正透传 Redis 的INCR命令——有些封装会做类型转换，把整数转成字符串再 incr，导致结果异常
最常被忽略的一点：不同限流规则的缓存 TTL 必须精确匹配时间窗口，差 1 秒就可能导致某次请求被两个规则重复计数，或者窗口切换时出现“断层”。
