微信小程序源码与开发工作流
00 / 00

配置

配置小程序 AppID、CloudBase、微信身份、手机号和微信支付,并明确人工确认边界。

基础配置

先把交付源码中的示例信息替换为项目的真实信息:

  • 小程序 AppID、名称和版本信息。
  • 品牌名称、图片、文案和服务域名。
  • 页面入口、导航和第一版业务范围。
  • 本地开发、体验版和生产环境使用的配置。

账号、密钥、商户凭据和生产数据不要写入公开仓库、文档或可分发的源码包。

CloudBase

确认项目连接的是你自己的 CloudBase 环境,并逐项检查:

  • 环境 ID 和当前账号权限。
  • SQL 数据库和业务数据结构。
  • 云函数的部署环境和调用权限。
  • 对象存储的路径、读写权限和图片访问结果。
  • 云端日志是否可以用于定位函数、订单和支付问题。

不要只确认本地调用成功。涉及数据写入、订单、会员权益和退款时,还要回读 CloudBase 中的最终结果。

微信身份和手机号

登录授权时机应符合微信的使用习惯。需要手机号时,要同时确认:

  • 当前主体和类目是否支持相关能力。
  • 已登录、未登录、拒绝授权和授权失效时的页面状态。
  • 客户端身份与云端用户记录是否一致。
  • 第一次授权需要由你在真机上完成。

个人主体可用的类目和商业能力有限,代码配置不能绕过主体、类目或平台权限限制。

微信支付

接入支付前先确认:

  • 小程序主体、类目、备案和支付资格。
  • 商户号状态以及商户号与 AppID 的关联关系。
  • CloudBase 与微信支付所需的授权关系。
  • 订单创建、支付结果、权益发放和退款状态都由服务端记录。

支付不能只检查客户端成功回调。付款完成后要查询服务端订单和会员权益;退款后要查询退款终态和权益变更。

真实付款、退款到账和必要的扫码授权需要你在真机上完成。Agent 可以在这些动作完成后继续查询云端状态和日志。

配置完成标准

  • 微信开发者工具可以运行当前项目,Console 没有阻止使用的错误。
  • 页面读取和写入的是当前项目的 CloudBase 环境。
  • 图片、数据库和云函数使用的权限符合实际业务。
  • 登录、订单、支付和权益状态在客户端与服务端一致。
  • 所有示例账号、品牌、域名、图片和商户信息都已替换。
  • 需要人工完成的授权、真机和平台事项已经单独列出。

配置异常时查看故障排查

这篇文档有问题?