← 返回目录

亚泰支付系统 · TG 推送限流说明与解决方案

生成时间:2026-10-13

一、TG 官方限制(实测)

维度限制
单群消息频率约 20 条 / 分钟
单 bot 全局约 30 条 / 秒
触发惩罚首次 30-60 秒
编辑消息同样受限

报错样例:{"ok":false,"error_code":429,"description":"Too Many Requests: retry after 41"}

二、系统解决方案

方案 1:Redis 队列 + 每群独立限速

商户下单 → 秒写入 Redis → Worker 单线程消费(每群 ≥3.5 秒/条)→ TG 永不限流

方案 2:多码绑多群

商户上传 N 个收款码,每码绑不同群,订单按码分流。

容量 = N × 17 条/分钟

方案 3:组合方案(终极)

Redis 队列 + 多群分流 + 每群独立限速

三、容量估算

群数量每分钟每天
1 个群17 条约 2.4 万单
4 个群68 条约 9.8 万单
10 个群170 条约 24 万单

四、商户操作步骤

  1. 创建 TG 群 → 拉 bot 进群 → 设管理员
  2. 群里发 /id 获取群 ID(格式 -100xxxxxxxxxx)
  3. 商户后台 → 收款方式管理 → 上传码 → 绑定群 + 操作人 TG ID
  4. 保存
  5. 每多绑 1 个群,容量增加 17 条/分钟

五、常见问题

Q1:点【确认到账】提示"无权操作"?

A:你的 TG ID 不在该群操作人列表。群里发 /加操作人 @你的用户名 添加。

Q2:订单消息延迟?

A:队列排队,最多 3.5 秒 × 队列长度。增加群数量可减少延迟。

Q3:订单推送失败?

A:检查 bot 是否被踢出群、是否被禁言、群 ID 是否正确。查日志:queue/logs/worker.log

Q4:为什么不能一次推很多条?

A:TG 官方限制,任何 bot 都无法绕过。唯一方案:多群分流 + 队列。

六、注意事项

  1. 不要试图绕过限流,TG 检测到会封 bot
  2. 不要多个 bot 打同一个群,会叠加限流
  3. 每群至少留 1 个操作人
  4. 群 ID 是负数(-100xxxxxxxxxx)
  5. 操作人 TG ID 是正数(7xxxxxxxxx)

文档完