模块化排查指南

1. 令牌过期时间设置不当

Telegram API令牌默认有效期通常为24小时，过期后监控功能将失效。

  1. 1. 登录你的Telegram开发者平台
  2. 2. 进入"API开发"→"令牌管理"页面
  3. 3. 检查当前令牌的过期时间设置
  4. 4. 建议设置为"永不过期"或延长至30天
提示：生产环境建议设置自动续期机制，避免手动维护。

2. API权限配置错误

缺少必要权限会导致令牌即使未过期也无法正常使用。

  1. 1. 确认你的令牌拥有"消息读取"和"群组管理"权限
  2. 2. 检查IP白名单是否包含你的服务器IP
  3. 3. 重新生成令牌并勾选所有监控所需权限

3. 服务器时间不同步

服务器本地时间与Telegram服务器时间差异超过5分钟会导致令牌验证失败。

  1. 1. 在服务器终端执行date命令检查当前时间
  2. 2. 使用ntpdate pool.ntp.org同步网络时间
  3. 3. 设置cron定时任务每天自动同步时间