常见问题

  • 在出现各种问题前（如注解失效…），我们推荐您先阅读 hyperf.常见问题常见问题 - 图1 (opens new window)
  • 下面列出的常见问题未能解决您的问题，您可以搜索我们git仓库的issue，或者提交issue。
  • 如果您是我们的商业授权客户，请您通过交流方式联系我们，我们将拉您进入技术讨论群，以优先解决您的棘手问题

会话内容未拉取

  • 请检查当时聊天对象是否购买并设置了微信会话内容存档服务
  • 请检查微信后台的会话内容的版本号是否与mochat后台配置的版本号一致。(微信后台每重置一次公钥，都会自动升级一个版本)
  • 请检查服务器的IP地址，是否在微信后台会话内容配置页面的白名单内。查看服务实例的IP地址可用curl https://www.cip.cc命令

页面直接打开正常，但是刷新就会404，或是直接输入 URL 也会 404

这是 Vue 项目的 Nginx 配置 问题，解决办法有以下2种：

  • 1、Vue官网推荐
  1. location / {
  2.   root /data/www/mochat/dashboard/dist;
  3.   index  index.html index.htm;
  4.   try_files $uri $uri/ /index.html;
  5. }
  • 2、匹配 errpr_page
  1. location /{
  2.   root /data/www/mochat/dashboard/dist;
  3.   index  index.html index.htm;
  4.   error_page 404 /index.html;
  5. }

安装都正常，但是登陆一直提示账号密码错误

可能的原因有以下几种，请按此排查：

  • 1、通过 chrome 的 开发者工具中 network 查看接口的请求地址、参数、响应是否对；

  • 2、dashboard 和 sidebar 的 .env 中接口URL未修改或配置错误，请严格按 前端项目配置修改常见问题 - 图2 (opens new window) 进行配置；

  • 3、后端接口服务 api-server 没有启动，输入如下命令看是否启动；

  1. # 看到下面这样，有比较多进程的，是正常运行中，否则表示未启动成功
  2. [root@mochat api-server]# ps aux | grep mochat
  3. root     11478  104  4.2 767048 326884 pts/2   Sl   11:39   0:05 mochat.Master
  4. root     11496  0.0  4.1 621460 316244 pts/2   S    11:39   0:00 mochat.Manager
  5. root     11499  0.0  4.1 770608 317444 pts/2   Sl   11:39   0:00 mochat.Worker.0
  6. root     11502  0.0  4.1 770608 317400 pts/2   Sl   11:39   0:00 mochat.Worker.1
  7. root     11505  0.0  4.1 775260 318388 pts/2   Sl   11:39   0:00 mochat.queue.default.0
  8. root     11508  0.0  4.1 775128 317712 pts/2   Sl   11:39   0:00 mochat.crontab-dispatcher.0
  9. root     11509  0.0  4.1 775260 318384 pts/2   Sl   11:39   0:00 mochat.queue.room.0
  10. root     11512  0.0  4.1 775260 318392 pts/2   Sl   11:39   0:00 mochat.queue.chat.0
  11. root     11515  0.0  4.1 775260 318392 pts/2   Sl   11:39   0:00 mochat.queue.coOSS.0
  12. root     11516  0.0  4.1 775260 318384 pts/2   Sl   11:39   0:00 mochat.queue.contact.0
  13. root     11517  0.0  4.1 775260 318388 pts/2   Sl   11:39   0:00 mochat.queue.employee.0
  14. root     11527  0.0  0.0 112820   980 pts/2    S+   11:39   0:00 grep --color=auto mochat

执行以下命令进行启动

  1. # 确认目录正确
  2. [root@mochat api-server]# pwd
  3. /www/wwwroot/mochat/api-server
  4. # 后台启动或直接使用  php bin/hyperf.php start 启动
  5. [root@mochat api-server]# nohup php bin/hyperf.php start &
  6. [1] 11478
  7. [root@mochat api-server]# nohup: ignoring input and appending output to ‘nohup.out’

  • 4、数据库初始化不成功，请查看数据库 mc_user 表中是否有数据；

  • 5、检查 api-server/runtime/logs 目录下有没有的 error 日志，根据日志提示信息进行排查；