doudou/telegram-management-system
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
telegram-management-system/TELEGRAM_CHAT_TROUBLESHOOTING.md
你的用户名 237c7802e5
Some checks failed
Deploy / deploy (push) Has been cancelled
Details
Initial commit: Telegram Management System 
Full-stack web application for Telegram management
- Frontend: Vue 3 + Vben Admin
- Backend: NestJS
- Features: User management, group broadcast, statistics

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 15:37:50 +08:00

2.4 KiB
Raw Permalink Blame History

Telegram 聊天功能故障排除指南

常见问题及解决方案

1. "账号连接失败"错误

可能原因：

  • 账号未上线
  • Session 已过期
  • API 配置问题
  • 账号被封禁

解决步骤：

  1. 手动上线账号

    • 在聊天界面点击"上线"按钮
    • 或返回账号列表，点击账号的"上线"按钮
    • 等待上线成功提示

  2. 检查 Session 状态

    • 如果提示"账号session已失效"，需要重新登录
    • 返回账号列表，使用扫码或验证码重新登录

  3. 检查 API 配置

    • 确保系统中有可用的 API 配置
    • 在"API数据管理"中检查是否有激活的 API

2. "获取对话列表失败"错误

解决方法：

  1. 先确保账号已成功连接（显示"账号已连接"提示）
  2. 点击"刷新"按钮重试
  3. 如果仍然失败，尝试重新上线账号

3. 账号无法上线

可能原因：

  • Session 已失效
  • 账号被封禁
  • 网络连接问题

解决方法：

  1. 返回账号列表
  2. 使用扫码或验证码重新登录账号
  3. 确保网络连接正常

使用建议

最佳实践

  1. 定期检查账号状态

    • 使用账号列表的"批量检查"功能
    • 及时处理被封或失效的账号

  2. 合理设置上线时间

    • 聊天功能默认上线时间为 1 小时
    • 可根据需要调整上线时间

  3. 使用内置聊天 vs 官方 Web

    • 内置聊天：适合快速查看消息和简单对话
    • 官方 Web：适合需要完整功能的场景（发送文件、语音等）

功能限制

内置聊天目前支持：

  • ✅ 查看对话列表
  • ✅ 查看聊天记录
  • ✅ 发送文字消息
  • ✅ 搜索对话
  • ❌ 发送图片/文件（建议使用官方 Web）
  • ❌ 语音/视频通话（建议使用官方 Web）

技术细节

连接流程

  1. 检查账号是否在线
  2. 如未在线，使用 API 配置创建客户端
  3. 连接到 Telegram 服务器
  4. 获取用户信息验证连接
  5. 加载对话列表

错误代码说明

  • AUTH_KEY_UNREGISTERED: Session 已失效，需重新登录
  • PHONE_NUMBER_BANNED: 手机号被封禁
  • SESSION_REVOKED: 会话被撤销，需重新登录
  • 没有可用的API配置: 需要添加有效的 API 配置

需要帮助？

如果问题仍未解决，请检查：

  1. 后端控制台日志，查看详细错误信息
  2. 确认账号在账号列表中显示"在线"状态
  3. 尝试使用其他账号测试是否为特定账号问题