常见问题

CQHTTP 连不上框架

一、请检查你的 CQHTTP 插件的配置文件是否正确。比如你的 CQHTTP 曾登录过不止一个 QQ 号码，且配置文件不为 general 和对应机器人的配置文件。CQHTTP 配置文件中几条核心的配置，这三条是必须填写的：

• use_ws_reverse: true
• ws_reverse_use_universal_client: true
• ws_reverse_url: ws://127.0.0.1:20001

推荐可选配置：access_token: 你的 token

二、检查炸毛框架的 config/global.php 中端口和地址有没有开到正确的位置，比如：酷Q和框架所在的服务器不在同一台，则框架监听地址不可以是 127.0.0.1，这样的情况下你需要填写你的服务器 IP 地址。如果还是无法连接，请检查服务器防火墙。如果是 Docker 用户，请看下面的 Docker 连接问题。

三、检查是否使用了安全的 WebSocket 连接。框架目前因为 Swoole 对 SSL/TLS 加密协议支持不完整，所以请不要直接使用 wss 来接入，可使用 nginx 等方案反向代理。

框架循环报错

如果框架在刚启动时循环报错，请将报错截图保存，提交 Issue 到 GitHub。如果此报错是由于模块加载导致，请检查你写的模块是否符合文档中所要求的框架规范、是否正确 use 引用对应类等。

一般情况下框架出现报错会立即中止运行，并保存框架内的缓存到本地。你可以到框架对应的报错日志中查看具体错误进行修复。

Docker 连接问题

由于 Docker 的网络是独立的，所以在使用 Docker 会出现无法连接框架等情况。

• 酷Q Docker 可以进入 VNC，但 CQHTTP 日志显示无法连接 WebSocket。

这种问题是最常见的，一般是由于不同环境的网络造成的