Appearance
问题现象
在平台总后台【页面装修】 -> 【首页装修/微页面】中点击“预览”时，弹窗中的小程序太阳码显示为裂图、无法生成或提示“生成小程序码失败”。
根本原因与排查步骤
后台预览小程序码依赖调用微信官方接口 wxacode.getUnlimited 生成带参数的小程序二维码。
检查微信小程序配置
- 登录平台总后台 -> 【设置】 -> 【系统设置】 -> 【小程序配置】。
- 核对 AppID 和 AppSecret 是否填写且与微信公众平台一致。
- 修改后保存并重启 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 查看微信接口返回的详细错误码与提示。