常见问题FAQ
按错误现象分类整理的高频问题与解决办法,覆盖控制台安装、商品库存、三类支付渠道、邮箱发货、指令群组与订单售后。
🖥️ 控制台与安装
❓ 控制台空白,提示找不到前端文件
- 确认使用完整
.uniqq插件包,而不是只复制 DLL; - 确认插件目录包含
Web/index.html; - 安装或修复 Microsoft Edge WebView2 Runtime,然后重启 UniQQ。
❓ 页面能打开,但保存后配置没变化
修改后需要点击右上角「保存配置」。若仍无效,查看运行日志和数据目录写入权限,不要在只读目录运行插件。
🏷️ 商品与库存
❓ 后台有两个商品,群里序号为什么变化了
群内序号按「当前群可见、已上架、有库存」的商品动态生成。商品下架、缺货、排序或适用群变化都会重新编号。请引导用户每次先发送购买触发词查看最新列表。
❓ 有卡密却提示缺货
筛选对应商品,确认卡密状态是「未售出」,而不是已售出、已作废或被订单锁定;同时确认商品已上架且允许当前群购买。
❓ 导入卡密数量比行数少
空行和重复项会被自动过滤。检查是否重复导入、行首尾是否有多余空格,或是否把多条内容粘贴到了同一行。
🏦 支付宝
❓ 支付宝响应验签失败
控制台「支付宝公钥」字段需要支付宝平台提供的公钥,不是你生成的应用公钥。同时确认正式/沙箱环境没有混用,RSA2 私钥与开放平台上传的应用公钥配套,公钥复制完整。
❓ 同样的参数在 WordPress 可以用,在插件里不行
先比较两边实际使用的字段含义。部分 WordPress 主题会把字段命名得不准确,或内部自动读取证书。核对它保存的是支付宝公钥还是应用公钥、是否使用证书模式、网关和 AppId 是否同一环境、服务器公网 IP 是否在白名单——UniQQ 运行机器和网站服务器的公网出口 IP 可能不同。
❓ 二维码生成了,为什么不能发货
二维码只代表预下单成功。必须等支付宝确认交易成功,并通过响应/查单验签和金额一致性校验,插件才会出库。
💠 易支付
❓ 易支付下单报「MD5签名错误」
先核对网关地址、商户 ID(PID)和商户密钥是否与易支付商户后台完全一致,PID 抄错会先报「pid错误,未找到对应商家」。参数无误仍报签名错误时,把插件更新到 0.0.17 及以上——z-pay 等网关的 mprotect(担保时效)参数只传参、不参与签名,旧版本把该参数算进了签名串。
❓ 点链接能付款,扫码却报「请求重入时参数与首次请求不一致」
旧版本使用 submit.php 页面跳转长链,手机 QQ/微信内置浏览器二次打开时会对中文参数重新编码,网关比对「首次请求参数」不一致即拒绝。0.0.18 起插件统一走网关预下单短链,付款链接与二维码内容完全一致,更新插件即可解决。
❓ 付款后订单一直待支付
确认插件会主动查单(每 8 秒一次);在易支付商户后台核对订单号与实收金额;检查插件与网关后台的商户 ID 是否同一环境;查看运行日志中查单返回的具体错误。
💚 微信支付
❓ 为什么 WordPress 只填三项,插件却要填更多
WordPress 页面使用的是微信支付 API v2。本插件可在「微信官方支付」中选择「简易 API v2」,只需 AppID、商户号和 API 密钥(v2),不需要证书。WordPress 会自动用网站域名生成通知地址;UniQQ 桌面插件没有公网域名,因此仍需手动填写公网 HTTPS 通知地址。
❓ API 密钥(v2) 和 API v3 Key 是同一个吗
不是。两者在微信支付商户平台「API 安全」中分别设置,不能混用。简易 API v2 填 32 位 API 密钥(v2),高级 API v3 才填写 API v3 Key。
❓ 微信支付为什么只有二维码,没有普通网页链接
Native 支付通常返回 weixin:// 协议内容,它用于生成二维码,不是标准 HTTP 网页,用户需要用微信扫码。其他渠道返回 HTTP/HTTPS 地址时,机器人会显示可点击链接。
❓ 微信下单提示通知地址错误
通知地址必须是公网可访问的 HTTPS 地址且证书有效,不能使用 localhost、局域网 IP 或普通 HTTP。
📧 邮箱与发货
❓ SMTP 登录失败
确认邮箱已开启 SMTP;填写的是授权码而不是网页登录密码;主机、端口和安全模式配套;账号没有触发异地登录或安全限制。
❓ 邮件标题变成商品说明
检查邮箱设置中的「主题模板」。发件昵称、主题模板、正文模板是三个独立字段,商品说明只应通过正文变量出现。保存后发送测试邮件验证。
❓ 发货消息只显示「发货附加话术」,卡密、商品说明等段落都没有
发货消息内容完全由「发货设置 → 发货消息模板」决定,商品「发货附加话术」是渲染后自动追加的;模板被清空(例如被云端同步覆盖)时就只剩附加话术。0.1.0 起插件加载配置时会自动恢复默认模板,更新插件并重启即可;也可以在发货设置中手动粘贴模板,确保包含 {卡密内容}、{商品说明}、{使用教程}、{售后说明} 等变量。若个别段落仍为空,检查商品编辑页对应字段是否已填写。
❓ 临时会话消息显示「该消息类型暂不支持查看」
旧版本发送的消息格式与部分 QQ 客户端不兼容,0.0.15 起发货消息已改为纯文本发送,更新插件即可。
❓ 用户没加机器人好友,怎么收到卡密
让用户在下单时填写收货邮箱(v1.10.0 起群聊下单必填,没邮箱不建单);支付成功后插件优先邮件发货。邮件失败会自动补发复核,仍失败才在群里 @ 买家提醒(可点「📧 填写收货邮箱」按钮补邮箱后重发)。不要在群内直接公开卡密。
❓ 配置了 SMTP,怎么还是「邮件不发货」
九成是订单没有收件人:QQ 官方机器人只给 openid 拿不到 QQ 号,订单 email 为空时 SMTP 配得再对也发不出去。确认「下单必须填写收货邮箱」开关开启(默认开),并让买家按引导补邮箱。可在「订单查询」面板查看订单的收货邮箱字段是否为空。
❓ 邮件明明发送成功,群里却报「发货失败/请补发」
v1.12.0 已修复:失败提醒不再抢跑,先按真实发货结果自动复核(默认 1 次),仍失败才提醒且每单只提醒一次。旧版本请升级到 1.12.0 及以上。
❓ 支付二维码不显示 / 一直加载
旧版二维码图源是境外服务,QQ 客户端的图片代理经常拉不到。v1.12.0 起默认走自建图源(国内机房);若仍不显示,到「回复样式」检查二维码服务地址(qr_service_base)是否被改成不可达的地址。
❓ 点了「填写收货邮箱」按钮没反应
QQ 官方按钮只是替你发送指令,不能弹输入框。点完按钮后 10 分钟内直接把邮箱地址(或 QQ 号)发出来即可;超时按钮失效,可重新让机器人提示或发「邮箱 订单号 邮箱」精确补发。
❓ 支付成功后群里没有提示
检查「欢迎语与群组」中该群的支付成功提示开关,确认订单确实通过验签并进入已支付状态,再看运行日志是否有群消息发送失败。
❓ 二维码没有被撤回
确认该群开启自动撤回,机器人有撤回自身消息能力,并且消息仍在平台允许的撤回时间内。撤回失败不影响支付确认和发货,日志会记录原因。
⌨️ 指令与群组
❓ 发送「购买」没有回复
依次检查全局售卡开关、当前群开关、购买触发词、商品上架状态、库存和适用群。修改指令后要保存配置。
❓ 自定义触发词后旧指令还能用吗
以保存后的触发词列表为准。需要兼容旧词时,把新旧词都保留并用逗号分隔。
❓ 用户能关闭别人的订单吗
普通用户只能操作属于自己的待支付订单。管理员权限由系统设置中的管理员 QQ 决定。
🧾 订单与售后
❓ 用户付款了但订单一直待支付
点击主动查单,在商户后台核对订单号和金额,查看日志中的验签、时间、网络和权限错误。不要只凭截图直接确认到账。
❓ 补发会不会再扣一张卡
不会。补发应复用订单原来已分配的卡密,不重复扣减库存。
❓ 误点确认到账怎么办
立即核对订单和商户后台。如果实际未收款但已经出库,应先停止该订单后续操作、记录已发出的卡密并按业务规则作废或冻结,然后检查管理员权限,避免再次误操作。
🆘 仍然无法解决时
请整理以下信息再排查:
- 插件版本与 UniQQ 版本;
- 发生时间;
- 订单号;
- 使用渠道;
- 订单状态;
- 运行日志完整错误;
- 商户后台是否有该订单及其金额。
提交截图前先脱敏
隐藏私钥、KEY、授权码、完整卡密和完整邮箱后再提供截图。
📚 下一节:控制台页面详解
