Agent Skills
返回列表
微信小程序隐私权限调试

微信小程序隐私权限调试

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 的配套写法
  • 小程序外包交付后做验收的甲方技术,需要按清单核对隐私协议配置与真机授权流程