触发429错误说明请求被限流保护拦截，需检查Sentinel中qwenAPI流控规则是否启用及阈值类型（QPS或并发线程数），误配线程数会导致低QPS即熔断；调试可添加bypass-sentinel头、换API Key或拆分请求；永久解决需提升单机阈值、启用集群流控并配置正确节点。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当调用通义千问API突然返回429 Too Many Requests或Sentinel拦截页面，说明请求已触发限流保护，服务端主动拒绝了后续请求。
确认当前限流规则是否生效
登录阿里云灵积平台 → 进入“Sentinel 控制台” → 左侧选择“流控规则” → 查看qwenAPI资源名对应的规则是否启用。若状态为“禁用”，则实际未生效，所有429报错均来自其他层（如API网关或Nginx）。
重点检查规则中的“阈值类型”：若设为“QPS”，表示每秒请求数上限；若为“并发线程数”，则限制的是同时处理的请求数量。两者行为差异极大，【误配为线程数模式会导致低QPS下即频繁熔断】。
快速绕过临时限流（仅限调试）
方法一：在请求头中添加自定义标识 bypass-sentinel: true（需后端代码显式放行该Header）。
方法二：改用备用API Key，在application.yml中切换apiKey值，前提是已申请多个密钥且未达总配额上限。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
方法三：将单次大请求拆为多个小请求，例如把3000字的摘要任务改为每500字一段，分6次提交，中间间隔≥200ms。
永久解除限流瓶颈
第一步：在Sentinel控制台定位到qwenAPI资源 → 点击右侧“编辑”按钮。
第二步：将“单机阈值”从默认的10提升至30（单位：QPS），注意该值不可超过你所购套餐的峰值QPS许可量。
第三步：勾选“集群流控”，并配置集群限流节点——必须指向你实际部署的后端服务IP+端口，否则各实例仍按单机阈值独立计数，无法协同防护。
第四步：点击“保存”后，等待约15秒同步生效；此时可执行curl -X POST http://localhost:8080/api/ai/qwen -H "Content-Type: application/json" -d '{"prompt":"测试"}'验证是否不再返回429。
