PHP调用AI API触发429错误主因是缺乏客户端节流，需用Redis实现跨请求滑动窗口限流，并依据Retry-After响应头做指数退避重试。
PHP 中调用 AI API（比如 OpenAI）时遇到 429 Too Many Requests，不是 PHP 本身的问题，而是你没在客户端做请求节流——PHP 不会自动帮你排队、退避或记数，得自己补。
为什么 file_get_contents() 或 cURL 直接发请求容易触发限速
AI 服务端的速率限制（如 OpenAI 的 RPM/TPM）是按 key + 时间窗口统计的，而 PHP 脚本每次执行都是全新进程，不共享状态。你写个循环跑 10 次 file_get_contents()，只要没加 sleep，很可能全挤在 1 秒内发出，直接被拦。
- 默认 HTTP 客户端无内置队列、无指数退避
- 脚本结束即销毁所有变量，
$request_count这种计数器下一次就归零 -
file_get_contents()超时默认是default_socket_timeout（通常 60s），但限速错误（429）返回极快，不会等超时，所以你得主动捕获并处理
用 Redis 实现跨请求的请求计数与窗口控制
必须把“过去 60 秒发了多少次”这个状态存到外部存储，Redis 是最轻量靠谱的选择。PHP 用 redis->incr() + expire() 就能模拟滑动窗口。
// 示例：限制每分钟最多 10 次请求
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$key = 'ai_rate_limit:' . $_SERVER['REMOTE_ADDR']; // 或用 API key 做 key
$redis->incr($key);
$redis->expire($key, 60);
if ($redis->get($key) > 10) {
http_response_code(429);
echo json_encode(['error' => 'Rate limit exceeded']);
exit;
}
- 别用文件存计数——并发写会冲突，且没原子性
- 别用
$_SESSION——只对单用户有效，且无法限制总调用量（比如你有 5 个后台任务共用一个 key） - 注意
INCR和EXPIRE要配对用；如果INCR后立刻EXPIRE，第一次可能失效（key 还不存在），建议用SET key val EX 60 NX配合 Lua 更稳妥
遇到 429 后该不该重试？怎么重试才安全
看响应头：Retry-After 字段才是权威依据。OpenAI 多数情况返回秒级数值（如 Retry-After: 2），少数返回时间戳。别硬写 sleep(1) ——可能刚睡醒又撞上新限速。
立即学习“PHP免费学习笔记（深入）”；
- 必须解析响应头，而不是只看状态码；
curl_getinfo($ch, CURLINFO_HEADER_SIZE)配合substr()可提取 - 重试最多 1–2 次，且要指数退避（第一次等 1s，第二次等 2s），避免雪崩
- 不要在同步 Web 请求里重试多次——用户会卡住；更适合放到异步队列（如
amqp或数据库任务表）里重试
真正难的不是写几行限速代码，而是想清楚：你的调用是面向终端用户（需低延迟）、后台批处理（可容忍延迟），还是定时任务（需强稳定性）。策略完全不同——比如批处理应该主动拆成小批次 + 固定间隔，而不是靠被动挨 429 再退避。
