跳到主要内容

故障排除

安装问题​

"无法连接到数据库"​

  1. 尝试使用 127.0.0.1 代替 localhost
  2. 通过 phpMyAdmin 验证凭据
  3. 检查 MySQL 用户权限
  4. 在 cPanel 上，数据库主机始终为 localhost

安装程序重定向到首页​

config/database.php 已存在（来自之前的尝试）。删除它后重试。

登录显示空白页面​

检查 PHP 错误日志中的 Fatal error 或 Call to undefined function。最常见原因：缺少 pdo_mysql 扩展。

消息未显示​

Webhook 消息未到达​

  1. Webhook URL 是否在提供商的仪表板中配置？
  2. URL 是否使用 HTTPS？
  3. 渠道是否处于活跃状态（开关已打开）？
  4. 检查 webhook_events 表中的 failed 条目

邮件消息未显示​

  1. cron 作业是否在运行？
  2. PHP imap 扩展是否已加载？
  3. IMAP 凭据是否正确？

SSE 实时更新不工作​

  1. 检查浏览器开发者工具 → 网络中的 /sse 请求
  2. Nginx 缓冲？设置 X-Accel-Buffering: no
  3. CDN/Cloudflare？启用流模式
  4. PHP max_execution_time 必须至少为 60 秒

发送失败​

WhatsApp 回复未送达​

  1. Access Token 是否有效？临时令牌约 24 小时后过期
  2. 电话号码是否为不带 + 的 E.164 格式？
  3. Meta 应用是否仍在 Development 模式？

邮件回复未到达​

PHP mail() 在 VPS 上可能未配置。配置 Postfix 或使用邮件 API。

常见 PHP 错误​

错误修复
Call to undefined function imap_open()共享主机： cPanel → 选择 PHP 版本 → 启用 imap。VPS： sudo apt install php-imap
Permission denied: config/database.php通过文件管理器将 config/ 设置为 755 或执行 chmod 755 config/
Maximum execution time exceeded在 php.ini 中设置 max_execution_time = 120

获取更多帮助​

  1. PHP 错误日志 — cPanel：日志 → 错误日志。VPS：/var/log/apache2/error.log
  2. Webhook 事件日志 — 在 phpMyAdmin 中检查 webhook_events 表
  3. Cron 输出 — 在浏览器中访问您的 cron URL
  4. 浏览器控制台 — F12 → Console 查看 JavaScript 错误