模块化排查指南

# 1. API调用频率超过限制

LINE官方对商业号API有严格的调用限制，超频会导致消息进入等待队列。

  1. 1. 登录LINE开发者控制台检查当前API配额
  2. 2. 对照官方速率限制文档核对使用情况
  3. 3. 调整发送节奏，确保不超过每分钟/每小时上限
提示：使用消息批量发送时建议加入500-1000ms间隔延迟

# 2. 服务器响应延迟或超时

网络不稳定或服务器负载高会导致消息处理延迟，形成队列堆积。

  1. 1. 检查你的服务器到LINE API端点的网络延迟（ping developers.line.biz）
  2. 2. 尝试更换服务器所在地，推荐使用日本/新加坡节点
  3. 3. 监控服务器CPU/内存使用率，必要时升级配置
提示：优质代理IP服务可改善跨境连接质量

# 3. 消息队列积压处理

大量未处理消息会导致队列阻塞，新消息无法及时发送。

  1. 1. 访问LINE Business Center查看待处理消息数量
  2. 2. 通过API批量清理过期/失败的消息（MessageAPI v2）
  3. 3. 设置自动重试机制处理失败消息

# 4. 账户权限异常

权限变更或审核未通过会导致消息发送受阻。

  1. 1. 检查商业号账户是否显示"已认证"状态
  2. 2. 确认Messaging API开关已经开启
  3. 3. 查看最近是否收到LINE官方的审核通知

常见错误提示及针对性解决方案

错误： "429 Too Many Requests"

API调用频率超过限制导致的暂时封禁。

  1. 1. 立即停止API调用至少30分钟
  2. 2. 参考官方文档调整发送频率
  3. 3. 考虑申请更高权限的API计划

错误： "500 Internal Server Error"

LINE服务器端出现问题导致的发送失败。

  1. 1. 访问LINE服务状态页
  2. 2. 等待官方修复（通常2小时内恢复）