根本原因是UC浏览器默认拦截weixin://协议且未正确传递客户端IP。需手动开启「打开外部应用」权限，启用兼容模式或修改about:config中external-scheme-enabled为true，并确保后端透传真实IP、前端对微信链接做中转封装。
UC浏览器访问电商或支付页面时，点击微信支付按钮后页面卡在加载状态、弹出“当前浏览器暂不支持唤起”提示，或直接跳转失败，根本原因是其默认拦截外部协议调用且未正确传递客户端IP，导致微信H5支付链路中断。
确认并开启UC浏览器外部协议调用权限
打开UC浏览器右上角「菜单」→「设置」→「安全与隐私」→「网站权限管理」→「打开外部应用」，确保该开关已开启。
这一步必须手动开启，UC浏览器默认关闭此权限，关闭状态下所有 weixin:// 协议均被静默拦截，且无任何提示，用户完全感知不到拦截行为。
若找不到「打开外部应用」选项，请先升级UC浏览器至最新版（v15.0.0.1234及以上），旧版本该入口可能位于「高级设置」→「系统权限」中。
启用UC浏览器兼容模式（专治H5支付白屏/跳转失败）
方法一：进入「设置」→「浏览设置」→「兼容模式」→开启「启用兼容模式（模拟Chrome 57内核）」。
方法二：若方法一无效，在地址栏输入 about:config → 搜索 external-scheme-enabled → 将其值设为 true。
【修改 about:config 后需完全退出UC浏览器（包括后台进程），再重新启动才生效】
一站式排查小程序隐私授权报错（errno 104 / buttonId is wrong 等）+ 标准修改模式。适用：隐私协议配置、隐私弹窗不弹、授权报错、隐私接口调用失败。已抽离具体项目，适用于任何微信小程序。
后端必须正确获取并透传客户端真实IP
微信H5支付要求下单时提交的 spbill_create_ip 参数必须与用户实际发起支付请求的IP完全一致，UC浏览器常因代理头缺失或错乱导致IP识别失败，触发“网络环境未能通过安全验证”错误。
使用以下Java方法获取真实客户端IP，覆盖全部常见代理场景：
public static String getRemoteHost(HttpServletRequest request) {
String ip = request.getHeader("x-forwarded-for");
if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip)) { ip = request.getHeader("Proxy-Client-IP"); }
if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip)) { ip = request.getHeader("X-Forwarded-For"); }
if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip)) { ip = request.getHeader("WL-Proxy-Client-IP"); }
if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip)) { ip = request.getHeader("X-Real-IP"); }
if (ip == null || ip.length() == 0 || "unknown".equalsIgnoreCase(ip)) { ip = request.getRemoteAddr(); }
return ip.equals("0:0:0:0:0:0:0:1") ? "127.0.0.1" : ip;
}
前端绕过限制的中转封装方案
第一步：判断当前 UA 是否为 UC 浏览器（含 Android/iOS）：
if (navigator.userAgent.indexOf('UCBrowser') > -1 || navigator.userAgent.indexOf('UCWEB') > -1) { … }
第二步：对微信预下单返回的 weixin:// 链接做二次封装——安卓端拼接 https://wx.tenpay.com/mmpayweb-bin/checkmweb? 中转页，iOS端改用 https://wx.tenpay.com/mmpayweb-bin/checkmweb? 并强制添加 redirect_url 参数。
第三步：中转页 URL 必须对原始 scheme 做 encodeURIComponent，否则 iOS UC 浏览器会因特殊字符截断导致唤起失败。这一步操作起来很简单，直接把封装好的中转链接赋给 window.location.href 即可。
