自定义URL Scheme在自家App内失效问题排查求助

这种情况我之前帮同事碰过，真的挺闹心——Safari里好好的能唤起App，自家WKWebView里点链接却毫无动静，连个报错日志都找不到，完全摸不着头绪！结合你已经做过的操作，给你几个额外的排查方向：

• 检查WKNavigationDelegate的拦截逻辑
  先确认你的WKWebView有没有设置WKNavigationDelegate，特别是webView:decidePolicyForNavigationAction:decisionHandler:这个方法。很多项目会在这里做统一的导航拦截，比如只允许http/https的链接跳转，或者有其他过滤规则，说不定你的自定义Scheme被无意中拦截了。建议在这个方法里打日志，输出navigationAction.request.url?.scheme，看看有没有收到对应Scheme的请求——如果连日志都没打出来，那问题大概率出在网页端或者WKWebView的基础配置上。

• 排除网页JS的干扰
  有些网页会给链接绑定自定义的点击事件，比如用preventDefault()阻止了默认的跳转行为，而Safari和WKWebView的JS环境可能存在细微差异，导致在Safari里能正常触发，WKWebView里不行。你可以试试在WKWebView的控制台里直接执行window.location.href = "你的自定义Scheme://测试路径"，看能不能唤起App。如果这样能成功，那就是网页里的JS代码搞的鬼，得去排查网页的点击事件逻辑。

• 验证App端的URL处理逻辑是否正常触发
  在AppDelegate的application(_:open:options:)或者SceneDelegate的scene(_:openURLContexts:)方法里打详细日志，包括收到的URL内容。既然Safari能唤起App，那这些方法在Safari触发时应该能打印日志；如果WKWebView里点击链接时这些日志没出现，说明请求根本没从WKWebView发出来，问题还是在WebView这边。

• 尝试极简Demo对比测试
  新建一个空白iOS项目，只做三件事：在info.plist里添加你的自定义Scheme，创建一个WKWebView加载本地的简单HTML（里面只放一个指向自定义Scheme的链接），然后测试点击链接是否能唤起App。如果Demo里正常，那说明你原项目里有其他代码或配置冲突——比如第三方WebView相关的库、自定义的WKWebView子类、或者某些全局的网络配置影响了请求。

• 检查WKWebView的配置细节
  看看你的WKWebViewConfiguration有没有设置一些特殊的属性，比如limitsNavigationsToAppBoundDomains？这个属性如果开启，会限制WebView只能跳转到绑定的域名，自定义Scheme可能会被阻止。另外，也可以试试清空WKWebView的所有缓存，调用WKWebsiteDataStore.default().removeData(ofTypes: WKWebsiteDataStore.allWebsiteDataTypes(), completionHandler: {})后再测试。

内容的提问来源于stack exchange，提问作者Jeff