plus.runtime.openURL 失败主因是平台限制：Android需目标App声明intent-filter并含android:scheme，iOS需Info.plist配置LSApplicationQueriesSchemes白名单；该API仅在App-plus真机环境有效，且仅返回布尔值表示调用是否发起成功。
uni-app 调用 plus.runtime.openURL 打开外部 App 失败的常见原因
绝大多数失败不是因为 API 写错了，而是没过 Android/iOS 的平台限制关。这个 API 本质是调用原生层的「跳转 URL Scheme」或「Intent」，所以必须满足目标 App 公开且注册了对应协议，且你的调用格式完全匹配。
- Android 上：目标 App 必须在
AndroidManifest.xml中声明android:scheme（如weixin://、alipay://），且你传给plus.runtime.openURL的字符串必须严格以该 scheme 开头（比如"weixin://"或带路径的"weixin://dl/scan"） - iOS 上：目标 App 需在
Info.plist中配置LSApplicationQueriesSchemes白名单（如weixin、alipay），否则canOpenURL:直接返回 false，openURL:也静默失败；同时传入的 URL 字符串必须是完整 scheme（如"weixin://"，不能只写"weixin"） - uni-app 的
plus.runtime.openURL在 H5 和小程序环境完全不生效——它只在App-plus编译模式下可用，且仅限真机调试或打包后的原生 App
如何判断目标 App 是否支持 scheme 调用
别猜，直接查文档或抓包验证。微信、支付宝、高德、钉钉等主流 App 都公开了 scheme 文档，但版本迭代后可能失效（比如新版微信已禁用大部分非白名单 scheme）。
- 先查官方文档：搜索 “
APP_NAMEiOS/Android URL Scheme”（例如 “微信 URL Scheme 官方文档”），注意看是否标注「已废弃」或「需审核」 - 在 iOS 真机上用 Safari 手动输入 scheme 测试：比如地址栏输
weixin://，如果弹出“是否打开微信”，说明系统识别成功；若提示“无法打开此链接”，大概率是未加白名单或 scheme 错误 - Android 可用 ADB 命令快速验证：
adb shell am start -W -a android.intent.action.VIEW -d "weixin://"，看是否有 Activity 启动日志 - uni-app 中不要硬编码 scheme，建议封装成配置项，不同平台、不同目标 App 分开管理，避免打包时混用
plus.runtime.openURL 的正确调用姿势和错误处理
这个 API 是异步的，但不返回 Promise，也不触发 success/fail 回调——它只返回布尔值表示“调用是否发起成功”，不代表目标 App 真的打开了。真正的失败往往无声无息，必须自己兜底。
- 必须在
onLaunch或页面onShow等生命周期里调用，不能在mounted阶段就执行（App-plus 环境可能还未 ready） - 调用前务必用
plus.runtime.isApplicationExist或plus.runtime.openURL自身返回值做一次粗略判断：const opened = plus.runtime.openURL('weixin://');<br>if (!opened) {<br> console.warn('openURL failed — maybe scheme not registered or platform restriction');<br> // 这里可 fallback 到 web 页面或提示用户手动操作<br>} - 不要依赖
setTimeout检测是否打开成功——iOS 14+ 和 Android 10+ 对后台启动限制极严，超时判定不可靠 - 对于支付宝、淘宝等需要参数的场景，确保 URL 编码正确：
plus.runtime.openURL('alipay://platformapi/startapp?appId=20000067&url=https%3A%2F%2Fxxx.com')，注意&是 HTML 实体，实际字符串中应为&
替代方案：用 uni.navigateToMiniProgram 打开同平台小程序更可靠
如果你的目标其实是跳转到微信/支付宝内的小程序（而非原生 App），别走 scheme 弯路。uni.navigateToMiniProgram 是 uni-app 官方封装的跨平台 API，在 App-plus、微信小程序、支付宝小程序中都可用，且无需 scheme 白名单。
- 前提：目标小程序必须与当前应用在同一主体下（或已绑定关联关系），且已配置合法的
appId、path、extraData - 调用示例：
uni.navigateToMiniProgram({<br> appId: 'wx1234567890abcdef',<br> path: 'pages/index/index?from=uniapp',<br> extraData: { foo: 'bar' },<br> success: () => console.log('mini program opened'),<br> fail: (err) => console.error('navigateToMiniProgram failed', err)<br>}); - 注意：该 API 在 H5 环境下会降级为跳转普通网页（如果配置了
webUrl），比openURL的兼容性好得多
真正难的从来不是写那行代码，而是搞清楚目标 App 当前认不认你这个 scheme、iOS 白名单有没有漏填、Android 的 intent-filter 是不是少写了 android:exported="true"（Android 12+ 强制要求）。这些细节一错，plus.runtime.openURL 就只是个安静的布尔值。
