模块化排查指南

# 1. 云控服务器连接超时

当LINE云控API服务器宕机或维护时，会直接导致控制指令无法传达。

  1. 访问 LINE官方服务器状态页面 检查服务状态
  2. 在命令行执行 ping api.line.me 测试网络连通性
  3. 尝试通过代理服务器连接（推荐使用稳定的住宅代理IP）
提示：使用LIKE.TG住宅代理IP可以有效绕过地区性网络限制

# 2. 本地网络配置异常

防火墙或ISP限制可能导致云控指令被拦截。

  1. 暂时关闭防火墙和杀毒软件测试
  2. 更换网络环境（4G/5G/WiFi交替测试）
  3. 清除DNS缓存（Windows: ipconfig /flushdns）
注意：企业网络通常有更严格的安全策略，需联系IT部门开放LINE API端口

# 3. API密钥过期或被撤销

未经授权的访问会触发LINE安全机制锁定云控功能。

  1. 登录LINE开发者控制台检查API密钥状态
  2. 重新生成并替换现有密钥（原密钥立即失效）
  3. 更新所有调用该密钥的脚本和配置文件

# 4. 并发请求超出限制

LINE对云控API有严格的请求频率限制（通常每分钟200次）。

  1. 检查脚本中的延时设置（建议≥300ms）
  2. 使用分布式架构分流请求
  3. 监控API调用次数并设置熔断机制

常见错误代码专项

错误： "429 Too Many Requests"

请求频率超过API限制。

  1. 立即停止当前所有请求
  2. 等待1小时冷却期（LINE强制限制）
  3. 优化代码添加随机延时（500-1500ms）

错误： "401 Unauthorized"

认证信息失效或签名错误。

  1. 核对时间戳是否在有效期内（±5分钟）
  2. 重新生成JWT签名
  3. 验证OAuth令牌是否过期