Skip to content

常见问题

调用接口报 404

目前没有支持全部的 OneBot 规范接口,请检查是否调用了不支持的接口。

如何使用 CQ 码?

将消息上报类型格式从消息段更改为 CQ 码即可。

详见 基础配置 中的 用文件配置 OneBot11 设置

二维码无法扫描

NapCat 会自动保存二维码到目录,可以手动打开图片扫描。

如果无法访问本地目录(例如,纯命令行页面),可以将二维码解析的 URL 复制到二维码生成网站上重新生成二维码,然后再用手机 QQ 扫描。

注意动作要快,因为二维码是会过期的!

语音、视频发送失败

这种情况需要你手动配置 ffmpeg。如何配置详见这里

Windows 系统启动,出现 QQ 本体界面

尝试管理员启动 NapCat。如果仍然失败,请反馈 NapCat 开发群。

出现 error code v2:-1 之类的提示

QQ 本身问题,正常现象,不影响使用。

登录提示出现“网络环境不稳定”“不在同一网络”

如果在服务器扫码登录提示出现网络环境不稳定/不在同一网络,可以尝试在本地登录后,将 QQ 本身的配置传到服务器相同目录覆盖。

Linux 下 QQ 配置的目录位于 ~/.config/QQ;Windows 下一般是文档下的 QQ 文件夹(默认情况是 <系统盘>:\Users (用户)\Documents\Tencent Files),具体可以打开 QQ 设置,进入“存储管理”一栏查看。

或者,手机使用 VPN 等方式连接到服务器网络,使手机和服务器在同一网络,也可解决此问题。

Windows 运行出现 “sqlite3 不是 win32 程序”

运行时,若出现 node_sqlite3.node is not a valid Win32 application,请检查下载的是否是 Windows 版本的 NapCatQQ,检查是否是安装的 64 位版本的 QQ。

“ MH Hook Hk sub XXXX Error ” 崩溃报错

如果你的此前使用LLOneBot,且使用过Liteloader某某一键包、或者使用了验证跳过的dll。

出现此错误,应该删除一键包和相关dll或完全清除重装QQNT。