必须确认基础库版本≥2.2.0，严格校验appId和path，用#ifdef MP-WEIXIN条件编译调用wx.navigateToMiniProgram，并通过storage或云函数实现跳转后参数同步。
uni-app里调用wx.navigateToMiniProgram前必须确认基础库版本
小程序跳转另一个小程序依赖微信原生的wx.navigateToMiniProgram，而uni-app本身不封装该能力——它只是透传调用。如果你的项目基础库版本低于2.0.4，这个API根本不存在，调用会静默失败或报not a function错误。
检查方式：在微信开发者工具右上角「详情」→「本地设置」→ 查看「基础库版本」；线上用户则需在onLaunch中用wx.getSystemInfoSync().SDKVersion做兼容判断。
- 低于
2.0.4：直接return，提示“当前版本不支持跳转”，不能fallback到打开链接或引导升级 - 建议最低要求设为
2.2.0，因为2.0.4~2.1.0间存在部分安卓机型跳转白屏问题 - uni-app编译后生成的
app-service.js里不会自动注入兼容逻辑，必须手动写
跳转参数必须严格校验appId和path
微信要求appId必须是当前账号已配置的关联小程序（后台「管理后台 → 开发管理 → 小程序关联」），且path不能带协议、不能含空格、不能超1024字符。uni-app里如果用变量拼接，极易因空值或编码问题触发fail: invalid path或fail: invalid appid。
常见错误场景：从接口取回的appId字段为空字符串、path含?但未encodeURIComponent、测试时用了体验版appid却没在后台绑定。
-
appId必须硬编码或从可信配置源读取，禁止由用户输入或URL参数传入 -
path若含参数，用encodeURIComponent包裹每个值，例如：page/index?id=+encodeURIComponent(id) - 调试时先用
console.log打印完整参数对象，再复制到微信开发者工具Console里单独执行wx.navigateToMiniProgram验证
uni-app中正确调用方式：条件编译 + 原生API桥接
不能直接在uni.navigateToMiniProgram（该API不存在），也不能在H5平台调用——它只在微信小程序生效。必须用#ifdef MP-WEIXIN条件编译包裹，并确保运行环境是微信小程序（uni.getSystemInfoSync().platform === 'ios' || 'android'还不够，得结合uni.getProvider或typeof wx !== 'undefined'）。
示例代码片段：
const jumpToOther = () => {
#ifdef MP-WEIXIN
if (typeof wx !== 'undefined' && wx.navigateToMiniProgram) {
wx.navigateToMiniProgram({
appId: 'wx1234567890abcdef',
path: 'pages/home?id=123',
success: () => console.log('跳转成功'),
fail: (err) => console.error('跳转失败', err)
})
}
#endif
}
- 不要在
onLoad里无条件调用，避免页面初始化时触发权限弹窗打断流程 - success回调里无法获取目标小程序的返回值，如需通信，必须提前约定通过
getApp().globalData或uni.$emit配合onShow监听 - 真机测试务必用体验版或正式版二维码，开发版之间跳转受限（除非双方都加了调试权限）
跳转后返回时如何接收参数
被跳转的小程序如果通过wx.navigateBack({ delta: 1 })或左上角返回，原小程序的onShow不会触发，只有onResume（App.vue）或页面onShow（需开启enablePullDownRefresh才可靠）。更稳妥的方式是：在跳转前用uni.setStorageSync存一个唯一key，被跳转小程序启动时读取并写回结果，原小程序轮询或监听storage变化。
- 微信不支持跳转回传参数，所谓“回传”本质是两个小程序共享storage或通过云函数中转
- 不要依赖
uni.onAppShow，它在iOS后台切前台时可能延迟数百毫秒，且安卓部分厂商系统不触发 - 如果目标小程序支持
openId互通，可让对方把结果写入云数据库，原小程序用uniCloud.callFunction拉取
跳转本身很简单，难的是边界情况：基础库兜底、参数校验、返回态同步、多端兼容。漏掉任意一环，线上就容易出现“点不动”“白屏”“参数丢失”。
