微信小程序授权弹窗不弹出的根本原因是触发时机、API选择、基础库版本、配置项四者中任一不满足条件即静默失败；需确保用户主动点击触发、desc非空、基础库≥2.10.4、web-view用cover-view包裹按钮、隐私协议正确注册onNeedPrivacyAuthorization并同步调用resolve，且授权失败后须先check authSetting再引导设置。
微信小程序的用户授权弹窗不会自动弹出，根本原因不是代码写错了，而是触发时机、API 选择、基础库版本、配置项这四者中任意一个不满足条件，就会静默失败——真机上连错误提示都没有。
uni.getUserProfile 调用后没反应？检查是否在用户主动操作上下文中
微信强制要求 uni.getUserProfile 必须由用户真实点击触发，不能在 onLoad、onShow、setTimeout 或异步回调里调用。
- 错误写法：
onLoad中直接调用uni.getUserProfile - 正确写法：绑定到按钮的
@tap或@click上，且该按钮不能是disabled状态或被v-if隐藏后再显示 - 注意：
desc参数必须传字符串（如"用于完善会员资料"），为空或undefined会导致 API 直接静默返回 fail - 基础库低于
2.10.4时该 API 不可用，真机调试前务必确认微信版本（iOS ≥8.0.45 / Android ≥8.0.48）
web-view 页面上弹不出授权弹窗？用 cover-view 包裹按钮
web-view 是原生组件，层级高于所有普通 view，你在它外面写的按钮、弹窗全会被盖住。这时候 cover-view 是唯一能穿透的方案。
-
cover-view只能嵌套cover-view、cover-image和button，不能放text或image - 样式限制多：不支持
box-shadow、linear-gradient、::before等，定位建议用position: fixed+top/right - 按钮必须带
open-type="getUserInfo"（旧版）或open-type="getPhoneNumber"等对应类型，且不能加@click事件——授权逻辑由微信原生接管 - 结构示例：
<web-view :src="h5Url"> <cover-view class="auth-cover" v-if="showAuth"> <button open-type="getUserInfo" @getuserinfo="onGetUserInfo">授权登录</button> </cover-view> </web-view>
隐私协议弹窗点“同意”没反应？__usePrivacyCheck__ 和 resolve 调用时机最关键
微信隐私授权不是 Vue 组件控制显隐那么简单，它是一套原生事件链：uni.getPrivacySetting 探针 → wx.onNeedPrivacyAuthorization 监听 → 用户点击 button open-type="agreePrivacyAuthorization" → 主动调用 resolve({ event: 'agree' })。
-
manifest.json的mp-weixin节点下必须有"__usePrivacyCheck__": true，编译后检查dist/mp-weixin/app.json是否真实存在（别只信编辑器高亮） -
wx.onNeedPrivacyAuthorization必须在App.vue的onLaunch中注册，且每次注册前要清空上一次的resolve引用，否则多个页面共用会错乱 -
resolve函数只能在用户点击按钮的同步上下文中调用，不能包在uni.showModal回调、setTimeout或 Promise.then 里 - 按钮必须是原生
button，且属性写全：<button open-type="agreePrivacyAuthorization">同意并继续</button>，少一个字母都不行
授权失败后再次调用仍不弹窗？先检查 authSetting 状态再决定是否重试
用户点过“拒绝”后，uni.authorize 或 uni.getUserProfile 再次调用不会弹窗，这是微信设计行为，不是 bug。
- 必须先用
uni.getSetting检查当前状态：uni.getSetting({ success: res => { if (!res.authSetting['scope.userInfo']) { // 未授权，可引导用户去设置页 uni.openSetting() } } }) -
uni.authorize仅对部分权限有效（如scope.location），对scope.userInfo无效，别混用 - 真机测试时，如果之前拒绝过，清除小程序缓存或删掉重装才能重置授权状态
- 不要在
fail回调里立刻重试，容易触发频率限制；应提供明确引导（如“去设置页开启”按钮）
最常被忽略的其实是基础库和配置的“双重验证”：开发者工具里看着正常，不代表真机能跑；manifest 写对了，不代表编译后 app.json 里也对。每次改完配置，务必打开 dist/mp-weixin/app.json 手动确认字段是否存在、拼写是否准确、双下划线有没有少。
