模块化排查指南

1. 网络连接不稳定或受限

推送功能需要稳定网络连接，连接问题是最常见导致推送失败的原因。

  1. 检查你的服务器的网络连接状态，确认能正常访问LINE服务器(api.line.me)
  2. 尝试从服务器ping api.line.me测试网络连通性
  3. 如果使用代理，确保代理设置正确且有效工作
  4. 重启网络设备（路由器/交换机）
提示：如果网络环境较复杂，可以考虑使用LIKE.TG住宅代理IP确保网络稳定性

2. API授权与权限问题

错误的API配置或过期令牌会导致推送失败。

  1. 确认你的LINE Developers控制台中的Channel Access Token有效
  2. 检查推送API使用的token是否是最新生成的
  3. 验证应用是否已启用"推送消息"权限
  4. 确保请求头中包含正确的Authorization字段
注意：token泄露可能导致安全问题，建议定期更新

3. 服务器推送配置错误

错误的服务器配置或参数会导致推送请求被LINE服务器拒绝。

  1. 确认推送API端点正确(https://api.line.me/v2/bot/message/push)
  2. 检查请求体是否符合LINE API规范
  3. 验证HTTP请求方法是否正确(POST)
  4. 确保Content-Type为application/json

4. 消息格式与内容限制

LINE对消息内容和格式有严格限制，不规范的格式会导致推送失败。

  1. 检查消息文本长度不超过5000字符
  2. 移除消息中的所有非法字符(如无效的emoji)
  3. 确认附加的图片/文件URL有效且可通过LINE服务器访问
  4. 确保消息模板格式正确

5. LINE服务器状态检查

有时问题可能出在LINE官方服务器端。

  1. 访问LINE官方状态页面(status.line.me)检查服务状态
  2. 检查开发者社区是否有类似反馈
  3. 等待官方问题修复