iOS 微信 H5 付出无法返回 APP 的问题

针对 iOS 微信 H5 付出无法返回 APP 的问题，结合 Universal Links 的办理方案，以下是综合多篇技术文档和实践经验的完整指南：

---

一、核心原理

微信 H5 付出默认通过 redirect_url 参数控制付出后跳转，但 iOS 的沙盒机制会逼迫在 Safari 中打开该 URL。通过 ​Universal Links 可绕过此限制，实现从微信直接返回 APP。其优势在于无需用户确认跳转，且支持 HTTPS 安全校验。

---

二、具体实现步骤

1. 配置 Universal Links

(1) 服务端配置

• 创建 apple-app-site-association 文件（无后缀），内容示比方下：
  1. [/code] [code]{
  2.   "applinks": {
  3.     "details": [
  4.       {
  5.         "appIDs": ["TeamID.com.yourdomain.app"],
  6.         "components": [
  7.           { "/": "/wxpay/*", "?": { "redirect_url": "*" } }
  8.         ]
  9.       }
  10.     ]
  11.   }
  12. }

  复制代码
• 将该文件摆设到 HTTPS 服务器的根目次或 .well-known 子目次。
  

(2) 客户端配置

• 在 Xcode 的 Signing & Capabilities 中启用 Associated Domains，填写格式：applinks:yourdomain.com 
  
• 在 AppDelegate 中添加 Universal Links 处理惩罚逻辑：
  1. [/code] [code]func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
  2.     guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
  3.           let url = userActivity.webpageURL else { return false }
  4.     // 解析支付结果并跳转对应页面
  5.     NotificationCenter.default.post(name: .wxPayCallback, object: url.query)
  6.     return true
  7. }

  复制代码

---

2. 付出请求改造

(1) 修改 redirect_url 参数

• 将 H5 付出请求中的 redirect_url 替换为 Universal Links 格式：
  1. [/code]
  2. [code]// 前端示例（需 URL 编码）
  3. const universalLink = 'https://yourdomain.com/wxpay?order_id=123';
  4. window.location.href = `https://wx.tenpay.com/...&redirect_url=${encodeURIComponent(universalLink)}`;

  复制代码
  留意：yourdomain.com 需与 apple-app-site-association 中配置的域名一致。
  

(2) 请求头添加 Refere。

---

3. 付出结果处理惩罚

(1) Universal Links 回调解析

• 当用户付出完成后，微信会通过 Universal Links 唤醒 APP，在 AppDelegate 中解析 URL 参数：
  1. func handlePaymentCallback(url: URL) {
  2.     let params = URLComponents(url: url, resolvingAgainstBaseURL: false)?.queryItems
  3.     let status = params?.first(where: { $0.name == "result" })?.value
  4.     if status == "success" {
  5.         // 刷新订单状态页面
  6.         NotificationCenter.default.post(name: .refreshOrderStatus, object: nil)
  7.     }
  8. }

  复制代码

(2) WebView 状态恢复

• 通过通知机制逼迫刷新 WebView：
  1. NotificationCenter.default.addObserver(self, selector: #selector(reloadWebView), name: .wxPayCallback, object: nil)
  3. @objc func reloadWebView() {
  4.     webView.load(URLRequest(url: URL(string: "https://yourdomain.com/order/123")!))
  5. }

  复制代码

---

三、避坑指南

• ​Universal Links 缓存问题
  iOS 可能缓存关联域配置，测试时需在「设置」-「开发者」-「Associated Domains Development」中清除缓存。
  
• ​Referer 格式要求
  部分案例表明，Referer 必要以 :// 末端（如 https://yourdomain.com://）才能通过微信校验。
  
• ​HTTPS 逼迫要求
  Universal Links 必须使用 HTTPS 且证书有用，测试环境可用 Let's Encrypt 免费证书。
  
• ​微信白名单限制
  需确保 yourdomain.com 已添加到微信商户平台的「H5付出授权域名」列表中。
  

---

四、扩展方案（混合模式）

若 Universal Links 配置复杂，可结合 URL Scheme 作为备用方案：

• ​双重回调地址
  1. const redirectURL = isIOS ? universalLink : 'your_app_scheme://wxpay';

  复制代码
• ​AppDelegate 兼容处理惩罚
  同时监听 Universal Links 和 URL Scheme 回调。
  

---

通过上述方案，可实现微信 H5 付出在 iOS 端的闭环跳转。建议在关键节点添加日志追踪，并和谐后端配合举行付出状态轮询，以应对网络延迟等非常场景。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。