uni-app官方未提供开箱即用的隐私授权弹窗组件，所谓“官方适配”实为对uni.getPrivacySetting、uni.openPrivacyContract及wx.onNeedPrivacyAuthorization的正确桥接封装，需严格遵循配置、监听、渲染、resolve四环节对齐，否则易因时机错位或上下文失效导致弹窗不显、点击无响应或审核驳回。
uni-app 官方没有提供开箱即用的「隐私授权弹窗」组件，所谓“官方适配”实际是指对微信原生隐私接口的桥接封装——uni.getPrivacySetting、uni.openPrivacyContract 和底层 wx.onNeedPrivacyAuthorization 的正确调用时机与状态管理。直接用 uni.showModal 或随便写个弹窗，90% 会失败或被审核驳回。
uni.getPrivacySetting 返回 needAuthorization 为 false 却仍触发隐私拦截
这是最常被忽略的兼容性陷阱：该接口只在基础库 ≥2.32.3 且小程序已配置 __usePrivacyCheck__ 时才真正生效；若未配置或用户基础库过低，needAuthorization 恒为 false，但后续调用 wx.getLocation 等接口仍会被微信底层拦截并静默失败。
- 必须在
manifest.json的「微信小程序配置」中显式添加"__usePrivacyCheck__": true（uni-app 3.9+ 版本会自动注入，但老项目需手动补） - 检查编译后
dist/mp-weixin/app.json是否存在该字段，而不是只看 manifest - 真机调试务必用 iOS 微信 8.0.45+ 或 Android 微信 8.0.48+，旧版本不触发
onNeedPrivacyAuthorization -
uni.getPrivacySetting的success回调里不能直接跳转页面或调用业务 API，它只是「探针」，不是授权动作本身
wx.onNeedPrivacyAuthorization 监听器没触发或只触发一次
这个监听器是隐私流程真正的中枢，但它不是全局事件总线——它只对「当前 JS 执行上下文」有效，且微信要求必须在调用隐私接口前注册。UniApp 的 Vue 组件隔离机制会让它在页面切换后失效。
- 监听器必须在
App.vue的onLaunch+onShow中注册，不能只放在某个页面的onLoad - 每次注册都要清空上一次的 resolve 引用，避免多个页面共用一个
resolve导致回调错乱 - 监听器内不能直接修改 Vue 响应式数据（如
this.showPopup = true），需用uni.$emit或 pinia store 触发跨组件通信 - 如果同时有多个隐私接口待调用（比如定位 + 读取相册），微信只会触发一次
onNeedPrivacyAuthorization，必须在弹窗同意后统一 resolve，不能分次处理
button open-type="agreePrivacyAuthorization" 点击无反应或报错
这个按钮不是普通 UI 元素，它是微信原生能力的入口，必须满足三个硬性条件才能激活：
- 必须是
标签， - 必须在
wx.onNeedPrivacyAuthorization的回调中拿到resolve后，再渲染该 button，否则微信不识别其上下文 - 点击时必须调用
resolve({ event: 'agree', buttonId: 'xxx' })，漏掉buttonId字段会导致后续getPrivacySetting返回值异常 - 拒绝操作必须调用
resolve({ event: 'disagree' })，不能只隐藏弹窗，否则微信认为授权流程卡死，下次调用隐私接口仍会阻塞
隐私协议名称 privacyContractName 为空或显示错误
privacyContractName 不是你代码里写的字符串，而是微信后台「用户隐私保护指引」配置页中填写的正式名称，且仅当该指引已提交审核并「发布生效」后才会返回真实值。
- 开发阶段可在小程序管理后台 → 设置 → 基本设置 → 用户隐私保护指引 中，先保存草稿并勾选「测试环境启用」
- 真机调试时，若返回空字符串，大概率是后台指引未发布，或当前账号非管理员/体验者权限
- 不要把
privacyContractName当作文案直接展示，它只是标识符；弹窗正文应使用你自己的合规文案，协议链接通过uni.openPrivacyContract打开 - 协议内容变更后，必须重新提交审核，否则新用户看到的仍是旧版，
privacyContractName也不会更新
真正难的不是写几个 API 调用，而是把「微信的运行时拦截机制」和「uni-app 的组件化生命周期」对齐——监听器注册时机、resolve 引用生命周期、弹窗渲染上下文、协议状态持久化，四个点只要漏掉一个，就会出现「弹窗不显示」「点了没反应」「授权后还是报错」这类玄学问题。
