讲师中心 微信公众号
AI工具推荐 视频效率加速

uni-app如何实现小程序间互相跳转 uni-app navigateToMiniProgram

胖涛同学_2152

胖涛同学_2152

发布时间:2026-05-21 12:32:07

|

752人浏览过

|

来源于php中文网

原创

必须确认目标小程序AppID、envVersion版本、navigateToMiniProgramAppIdList校验配置三者对齐,缺一不可;AppID需同开放平台账号或已关联,envVersion须按环境设为develop/trial/release,配置须手动补入app.json。

uni-app如何实现小程序间互相跳转 uni-app navigatetominiprogram

uni-app 调用 uni.navigateToMiniProgram 前必须确认的 3 件事

不能跳转,90% 是因为这三项没对齐:目标小程序的 AppID、版本、校验配置。不是代码写错,而是平台侧卡住了。

  • 目标小程序的 appid 必须和当前调用方小程序(即你自己的 uni-app 编译后的小程序)在同一微信开放平台账号下,或已绑定为关联小程序(后台「开发管理 → 关联公众号/小程序」里确认)
  • envVersion 参数不能写死成 "release" —— 真机调试时要用 "trial",体验版用 "develop",线上才用 "release";uni-app 不会自动帮你切换
  • 项目 manifest.json 中的「微信小程序设置」里,weapp-appid 填的是你自己的 AppID,但跳转能力本身不依赖它;真正要检查的是「微信开发者工具」中登录账号是否具备目标小程序的开发者权限(否则真机上提示“该小程序不存在”)

uni.navigateToMiniProgram 在 H5 或 App 端根本不会执行

这个 API 是纯微信小程序专属,uni-app 编译到 H5 或 App 时,uni.navigateToMiniProgram 是空函数,既不报错也不跳转 —— 这是设计如此,不是 bug。

Unified LLM Gateway - One API for 70+ AI models. Route to GPT, Claude, Gemini, Qwen, Deepseek, Grok and more
Unified LLM Gateway - One API for 70+ AI models. Route to GPT, Claude, Gemini, Qwen, Deepseek, Grok and more

统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。

下载
  • 如果你需要多端兼容,必须手动降级:H5 用 window.location.href 跳转小程序短链(需提前在目标小程序后台生成),App 端走原生跳转桥接(如 iOS 用 openMiniProgram,Android 用 startActivity 配合微信 SDK)
  • uni-app 官方没有封装跨端跳小程序的统一 API,uni.getProvider 查不到该能力,别白费力气判断
  • 真机测试前务必切到「微信开发者工具」或「微信客户端」运行,其他模拟器或浏览器无效

跳转失败常见错误信息及对应解法

微信返回的错误通常很简短,但每个都指向明确配置点:

  • "errCode: -1, errMsg: 'navigateToMiniProgram:fail invalid appid'" → 检查传入的 appId 字符串是否多空格、含中文引号、大小写错误;注意不是 appID 也不是 AppId,必须全小写且无符号
  • "errCode: -2, errMsg: 'navigateToMiniProgram:fail not bind third party appid'" → 登录 https://mp.weixin.qq.com ,进入「开发管理 → 第三方设置」,把目标小程序的 AppID 加进「绑定的公众号/小程序」列表(即使不是第三方,也要绑)
  • "errCode: -3, errMsg: 'navigateToMiniProgram:fail can not navigate to self mini program'" → 不能跳自己,哪怕只是不同版本也不行;uni-app 编译出的小程序和目标小程序 AppID 必须严格不同

参数传递与路径拼接要注意 URL 编码

path 字段只接受字符串,且微信要求必须是目标小程序已配置的合法页面路径(不能带 ?a=1&b=2 这种裸参数),所有参数必须通过 extraData 传,或手动拼进 path 并做 encodeURIComponent

  • 正确写法:path: '/pages/index/index?uid=' + encodeURIComponent('abc def'),而不是 ?uid=abc def
  • extraData 是对象,会被微信注入到目标小程序 App.onLaunchPage.onLoadoptions 里,但仅限于从「我的小程序」或「发现栏」冷启动时才有效;热启动(已在后台)可能收不到
  • 如果目标小程序用了分包,path 必须写完整分包路径,例如 path: 'subpackage/pages/list/list',不能省略 subpackage/
微信小程序间跳转的成败,几乎不取决于 uni-app 写法,而取决于后台配置、账号关系和运行环境三者的实时一致性。每次改完配置,记得清微信开发者工具缓存、删掉手机微信里的小程序数据再试。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

4343

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

5450

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

4898

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

683

2024.05.22

微信是谁开发的
微信是谁开发的

微信是由张小龙所带领的腾讯广州研发中心产品团队打造开发的,并不是马化腾开发的,而腾讯公司总裁马化腾是在产品策划的邮件中确定这款产品的名称叫做“微信”的。想了解更多微信相关的内容,可阅读本专题下面的相关文章。

5375

2024.11.05

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

0

2026.09.21

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

20

2026.09.20

AionClaw AI智能体与电脑自动化任务执行功能使用教程
AionClaw AI智能体与电脑自动化任务执行功能使用教程

AionClaw专题整理AI智能体与电脑自动化相关功能使用教程,涵盖安装部署、AI任务执行、Skills技能、文件处理、浏览器控制、电脑操作、持久记忆、聊天工具连接以及办公、编程和内容创作等功能,帮助用户快速掌握AionClaw的实际使用方法。

0

2026.09.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn