微信小程序隐私权限调试
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3ff3c268/wechat-privacy-auth-debug。
技能介绍
你会遇到的典型报错
微信对小程序隐私合规要求收紧后,开发里常见的不只是「用户没点同意」,而是配置与代码对不齐导致的硬错误。例如 errno 104、提示 buttonId is wrong、隐私弹窗始终不出现,或调用了需授权的隐私接口却直接失败。这类问题往往横跨后台隐私协议配置、app.json / 页面里的隐私相关组件,以及业务里对 wx.getPrivacySetting、open-type 按钮等的用法。
技能如何帮你排查与改
本技能把隐私授权链路拆成可对照的检查项,并给出标准修改模式(不是只列文档链接):
- 对照隐私协议是否已在公众平台配置、是否与当前小程序版本一致
- 确认隐私弹窗触发条件:是否在需要授权的时机调用了正确 API、按钮
id是否与后台约定一致(buttonId is wrong多与此相关) - 梳理隐私接口调用顺序:先读设置再引导用户,避免在未授权态直接调用敏感能力
- 针对
errno 104等错误码,按常见根因(配置缺失、组件属性、基础库版本)逐项排除
内容已从具体业务项目中抽离,适用于任意微信小程序,不绑定某一行业模板。
适用边界
- 侧重隐私合规与授权调试,不替代微信官方文档的完整政策说明;政策变更以微信公告为准。
- 若问题来自账号资质、类目限制或审核驳回文案,需结合公众平台与审核反馈单独处理。
- 真机与开发者工具行为可能不一致,关键路径建议在真机复现后再按技能中的模式改。
使用场景
- 上线前真机出现 errno 104,需要对照隐私协议与页面授权组件逐项改配置
- 用户反馈隐私弹窗从不弹出,要核对 getPrivacySetting 调用时机与 open-type 按钮 id
- 调用相册/位置等隐私接口直接失败,要梳理先授权再调用的顺序与错误处理
- 后台已更新隐私协议但旧包仍报 buttonId is wrong,要按标准模式改按钮与后台约定
适合人员
- 负责小程序提审与合规改造的前端,要把隐私弹窗与敏感接口接到微信最新要求
- 维护存量微信小程序的全栈工程师,线上集中出现授权相关报错需要快速定位根因
- 从单体项目抽离隐私模块后接手代码的开发者,不熟悉 buttonId 与隐私 API 的配套写法
- 小程序外包交付后做验收的甲方技术,需要按清单核对隐私协议配置与真机授权流程