Skip to content

常见问题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、授权码、完整卡密和完整邮箱后再提供截图。


📚 下一节:控制台页面详解

薇薇官机平台 · ZL 系列插件