uni-app 对微信小程序的适配需三步:manifest.json 配置 __usePrivacyCheck__、pages.json 显式声明页面配置、App.vue 中正确注册 onNeedPrivacyAuthorization 监听器;缺一则真机白屏或 API 静默失败。

直接说结论:uni-app 对微信小程序的适配不是“开箱即用”,而是靠三类关键动作——manifest.json 配置生效、pages.json 页面级声明、以及对微信原生能力的桥接调用。漏掉任一环,都可能在真机上白屏、弹窗不显、API 调用静默失败。
manifest.json 必须手动补全 __usePrivacyCheck__
这是 90% 新项目上线前被驳回的根源。uni-app 3.9+ 会自动注入 "__usePrivacyCheck__": true,但老项目或从旧模板升级的项目,dist/mp-weixin/app.json 里大概率没有它——哪怕你在 manifest.json 里写了,编译后也可能被忽略。
- 打开
src/manifest.json,在"mp-weixin"节点下确认存在:"__usePrivacyCheck__": true - 编译后务必检查
dist/mp-weixin/app.json是否真实写入,而不是只信 manifest - 若用 HBuilderX 编译,勾选「上传代码时样式自动补全」和「上传代码时自动压缩」可避免部分配置丢失
onNeedPrivacyAuthorization 监听器必须在 App.vue 的 onLaunch 和 onShow 中注册
这个监听器不是全局事件,微信只认「当前 JS 上下文 + 已注册」的状态。放在某个页面的 onLoad 里,页面一跳转就失效;没注册就调 uni.getLocation,用户什么也看不到,接口直接静默失败。
- 在
App.vue的onLaunch和onShow里都调用一次wx.onNeedPrivacyAuthorization - 每次注册前先
wx.offNeedPrivacyAuthorization清除旧引用,避免多个 resolve 冲突 - 监听器内不要直接改
this.xxx响应式数据,用uni.$emit('show-privacy-popup')或 Pinia store 触发 UI 更新 - 同一个监听器要能处理多个待授权 API(如定位 + 相册),不能调一次 resolve 就清空
pages.json 里页面方向、导航栏、横屏等配置需显式声明
uni-app 不会自动把 Vue 文件里的 pageOrientation 或自定义导航栏逻辑透传给微信小程序。所有视觉与行为控制,都得靠 pages.json 的 JSON 配置落地。
Windows 微信自动发送工具。支持搜索微信联系人并发送文字、图片、文件和**批量文件**。通过 GUI 自动化控制微信窗口,无需微信开放接口。触发场景: 离开电脑时,远程指令OpenClaw发送图片/文件给微信联系人。条件: 微信打开并登录(允许最小化)。举例:1、把桌面上的龙虾图片发送给张三(默认微信发送);2、查找D盘最新的报价单Excel表并发送给李四(默认微信发送);3、搜索报价单并批量发送给联系人。
- 横屏页面必须在
pages.json对应路径下加:"pageOrientation": "landscape" - 隐藏默认导航栏并启用自定义布局,要设
"navigationStyle": "custom",否则胶囊按钮会重叠 - 自定义导航栏高度计算依赖
wx.getMenuButtonBoundingClientRect(),且必须在onReady后获取,onLoad里取不到 - 状态栏高度
statusBarHeight在 iOS 和 Android 上差异大,建议缓存到全局 store,避免重复调用
真机调试必须用新版微信客户端 + 真实基础库版本
微信开发者工具模拟不了 onNeedPrivacyAuthorization,旧版微信(如 Android 8.0.47)也不触发该事件。很多“本地能跑”的问题,一上真机就崩,本质是环境错配。
- iOS 必须用微信 8.0.45+,Android 必须用 8.0.48+,低于此版本不会触发监听器
- 基础库版本要在小程序后台设置 ≥2.32.3,且用户手机微信实际加载的基础库也得达标
- 测试时禁用「调试基础库」开关,让它加载用户真实环境的基础库
- 遇到弹窗不显、按钮点击无反应,第一反应不是代码逻辑,而是先查真机微信版本和基础库
最常被忽略的一点:隐私弹窗的 button 必须带 open-type="agreePrivacyAuthorization",且绑定 @agreeprivacyauthorization 事件;任何用 click + uni.openPrivacyContract 模拟的方案,审核必过不了。










