App端支付成功后页面不自动返回，需检查uni.onAppShow是否被覆盖：必须在App.vue或主页面注册且避免重复覆盖，iOS/Android唤回时均依赖此全局监听，而非页面级onShow；同时确保manifest.json中URL Scheme配置正确，否则根本无法唤回App。
App端支付成功后页面不自动返回？检查 uni.onAppShow 是否被覆盖
App端（尤其是iOS）调起微信/支付宝支付后，系统会将应用切到后台再唤回前台，但不会触发页面级的生命周期（比如 onShow），而是走全局的 uni.onAppShow。很多开发者只监听了页面的 onShow，结果支付回来后页面没响应。
- 必须在 App.vue 或主页面的
onLaunch/onShow中注册uni.onAppShow，且确保它不被重复注册或覆盖 - 不要在子页面里单独注册，否则容易丢失监听上下文
- 注意：Android 下部分厂商系统（如华为、小米）可能延迟触发
onAppShow，建议加 100ms 延迟再检查支付状态
怎么安全判断“这次回来是支付成功”？别只依赖 URL 参数
支付 SDK 回调时，App 端无法像 H5 那样靠跳转 URL 传参（比如 ?pay_status=success）。iOS 和 Android 的回调方式不同，且参数不可靠 —— 尤其是 iOS 的 uni.getLaunchOptionsSync() 在支付唤回时返回空对象很常见。
- 推荐做法：支付前把订单号写入本地缓存，比如
uni.setStorageSync('pending_order_id', 'ORD123') - 在
uni.onAppShow中读取该 key，立即调用后端接口查订单状态（不要只查前端缓存） - 查到已支付后，再用
uni.navigateTo跳转到成功页，并清理缓存：uni.removeStorageSync('pending_order_id') - 避免用
uni.getStorageSync('pay_result')这类临时标记，容易因多页并发或冷启动失效
支付成功页跳转后，用户点返回键回到上一页？拦截无效怎么办
App 端原生返回逻辑和 WebView 不同，uni.navigateBack 在某些场景下（比如从非栈顶页跳转、或使用 reLaunch）会失效，用户按物理返回键仍可能回到支付页甚至白屏。
- 支付成功页建议用
uni.redirectTo替代uni.navigateTo，清掉历史栈 - 如果必须保留返回能力，可在成功页的
onUnload里主动调用uni.switchTab或uni.reLaunch到首页，防止用户退回空白页 - Android 上测试时注意：部分机型（如 OPPO）对
onBackPress拦截支持不完整，优先用 UI 层引导（例如隐藏返回按钮 + 提供「去首页」按钮）
真机调试时支付回调不触发？检查 manifest.json 的 scheme 和 URL Scheme 配置
这是最常被忽略的硬性条件：微信/支付宝 SDK 要通过自定义 URL Scheme 唤起你的 App，如果配置错误，支付完成后根本不会回到你的应用，自然没有后续逻辑。
- iOS：确认
manifest.json → App iOS 设置 → URL Scheme填写了与微信开放平台一致的 Bundle ID（如wx123456789），且 Xcode 工程中已添加对应 URL Types - Android：检查
manifest.json → App Android 设置 → 应用包名是否与微信/支付宝后台配置完全一致（含大小写），并确认android:name在AndroidManifest.xml中指向了正确的 Activity - 调试技巧：在手机浏览器里手动访问
your-scheme://?test=1，看能否唤起 App —— 唤不起就先别写支付逻辑
