故障排查

先确定问题所在层级

按以下顺序收集证据，不要只根据页面提示判断：

1. 源码和配置。
2. 构建输出。
3. 微信开发者工具 Console 和页面截图。
4. CloudBase 数据库、云函数、存储和日志。
5. 服务端订单、支付、退款和权益终态。
6. 真机操作结果。
7. 小程序后台、商户平台或审核平台显示的状态。

如果某一层没有证据，明确记录为“未验证”，不要把本地成功当成真机或平台成功。

项目无法导入或运行

检查：

• 微信开发者工具是否使用了正确的项目目录和 AppID。
• 源码是否已按仓库说明安装依赖并完成构建。
• 构建产物目录是否存在，页面和样式是否实际生成。
• 开发者工具的命令行服务端口是否开启。
• Console 中是否有路径、依赖、权限或配置错误。

CloudBase 无法访问

检查：

• 环境 ID 是否属于当前账号和当前小程序。
• 当前账号是否完成所需授权。
• 数据库、云函数和对象存储是否部署到预期环境。
• 数据读写权限和存储访问权限是否符合当前用户状态。
• 云函数日志中是否有真实错误。

第一次 CloudBase 登录或授权可能需要你在控制台完成。Agent 可以在授权完成后继续部署、查询和读取日志。

登录或手机号授权失败

检查主体、类目、AppID、用户授权状态和云端用户记录。个人主体的类目和商业能力限制不能通过修改前端代码解决，是否可用以微信官方当前结果为准。

授权流程必须在真机微信环境中验证。开发者工具中的模拟结果不能代替真实授权。

支付失败或状态不一致

检查：

• 小程序主体、类目、备案和支付资格。
• 商户号状态以及商户号与 AppID 的关联关系。
• CloudBase 与微信支付所需的授权关系。
• 服务端创建订单、支付通知、查单和退款日志。
• 订单、会员权益和退款记录是否已经达到终态。

如果客户端显示支付成功，但订单或权益没有更新，以服务端查询结果为准。真实支付、取消、退款和到账必须在真机上完成并确认。

开发者工具正常，真机异常

重点检查：

• 真机微信授权和手机号权限。
• 服务域名、网络请求和图片访问。
• 当前用户是否已加入体验成员。
• 体验版是否包含最新构建。
• 设备上缓存的数据和旧版本状态。
• 支付、退款和服务端结果是否一致。

体验版或提审受阻

检查主体、类目、备案、隐私说明、内容、资质、支付说明和当前版本材料。项目包含 AI 能力时，还要根据真实功能准备平台要求的相关材料。

源码、Agent 和本地构建都不能保证审核通过。上传体验版或正式提交审核前，由你确认版本和材料事实。

产品支持边界

• 产品不包含代注册、代备案、代认证、代开发、代运营和平台费用。
• 不保证个人主体可以使用企业类目、微信支付或特定内容能力。
• 源码交付后不支持无理由退款。
• 禁止二次销售或公开分发源码。

需要了解完整开发顺序时，返回使用。