App端隐私弹窗必须在androidPrivacy.json或manifest.json中正确配置app-plus.privacy,prompt设为"template"、buttonRefuse严格匹配"不同意并退出App"、message链接需HTTPS可访问,拒绝后须真退出;小程序需在app.json设__usePrivacyCheck__:true并用原生API触发。

必须在 manifest.json 或 androidPrivacy.json 中声明完整、合规的 privacy 配置,否则弹窗根本不会出现——uni-app 不会自动触发,也不识别页面级组件或 JS 逻辑里的“模拟弹窗”。
app-plus.privacy 配置必须存在且字段全对
App 端隐私弹窗只由原生层驱动,manifest.json 的 app-plus.privacy 是唯一入口(HBuilderX 3.2.1+ 后优先被 androidPrivacy.json 覆盖)。常见错误是只写了个空对象或漏字段:
-
prompt必须为"template",设成"none"、""或删掉该字段,弹窗直接静默失效 -
buttonRefuse文本必须字面匹配"不同意并退出App",华为/小米商店会做字符串校验,“拒绝”“取消”“退出”都不行 -
message里的链接必须是 HTTPS、可访问、加载不白屏,否则用户点开即失败,等同于未提供协议 -
template.title和template.message建议用中文,iOS 审核对非本地化文案更敏感
androidPrivacy.json 优先级更高,真机调试必查
如果你改了 manifest.json 却没弹窗,大概率项目根目录已存在 androidPrivacy.json,它会完全屏蔽 manifest 里的配置。这个文件:
- 路径必须是项目根目录,不是
static/或unpackage/ - 结构和
manifest.json内的privacy几乎一致,但多一个强制字段:version: "1" - 支持热更新:改完保存,真机摇一摇 → “重载资源”就能立即生效,不用重新打包
- 删掉它,
manifest.json的配置才会重新起作用
用户拒绝后必须真退出,不能跳页或延时
点 "不同意并退出App" 不是前端路由跳转,而是调用原生退出流程。错误做法包括:
- 监听到拒绝回调后执行
uni.navigateTo({ url: '/pages/blank' })—— 这等于欺骗审核,应用仍在后台运行 - 在退出前加
setTimeout上报埋点,部分厂商 ROM 会拦截并卡住退出逻辑 - 自己写
plus.runtime.quit()之前检查plus.runtime.getProperty('privacyAgreed')—— 其实不需要,配置正确时 uni-app 已内置退出逻辑
iOS 上 plus.runtime.quit() 表现为退到后台(苹果规范),Android 上才是彻底杀进程;你无需区分平台写逻辑,只要配置对,系统自动处理。
小程序端完全不认 manifest.json 的 privacy 配置
如果你在小程序里也照搬 App 端配置,弹窗必然不出现。小程序必须走微信原生机制:
- 在
app.json顶层加"__usePrivacyCheck__": true(注意双下划线,大小写敏感) - 在
onLaunch里调用wx.onNeedPrivacyAuthorization监听授权请求 - 用
open-type="agreePrivacyAuthorization"的按钮触发授权,不能靠wx.login等接口隐式触发 - 调用
wx.getPhoneNumber等接口前,必须确保已获得隐私授权,否则报错fail privacy permission is not authorized
模拟器大概率不触发 App 端弹窗,务必用真机测试;而小程序端必须在微信开发者工具基础库 ≥ 2.31.0 下才支持完整流程。











