Skip to content

问题现象 ​

在平台总后台【页面装修】 -> 【首页装修/微页面】中点击“预览”时,弹窗中的小程序太阳码显示为裂图、无法生成或提示“生成小程序码失败”。


根本原因与排查步骤 ​

后台预览小程序码依赖调用微信官方接口 wxacode.getUnlimited 生成带参数的小程序二维码。

检查微信小程序配置 ​

  1. 登录平台总后台 -> 【设置】 -> 【系统设置】 -> 【小程序配置】。
  2. 核对 AppID 和 AppSecret 是否填写且与微信公众平台一致。
  3. 修改后保存并重启 Swoole 守护进程。

小程序发布状态与页面路径要求 ​

  • 微信机制限制:微信官方接口生成小程序码时,指定的页面路径(page)必须在已正式发布上线的小程序版本中真实存在。
  • 排查:若当前小程序尚未在微信官方审核上架(或刚开通新类目未发布),调用生成接口会返回 errcode: 41030 (invalid page)。此时需先提交审核并发布体验版/正式版小程序。

服务器出网与 SSL 根证书 ​

后端服务器需具备出网权限以请求微信 API 域名(https://api.weixin.qq.com)。可通过终端测试连通性:

bash
curl -I https://api.weixin.qq.com

查看错误日志 ​

若依然生成失败,请查看 runtime/log/ 下的最新日志,搜索 getUnlimited 或 wxacode 查看微信接口返回的详细错误码与提示。

安徽用易软件科技有限公司 · 承信租 V4 官方技术文档中心