Android WebView已注册的@JavascriptInterface方法无法被JS识别调用
问题成因
一、JS接口注解绑定规则不匹配导致方法不存在
- Android WebView的
addJavascriptInterface机制识别@JavascriptInterface注解时,仅会扫描传入的具体实现类的公开方法,不会向上追溯类实现的接口上的注解定义。 - 当前实现类
AddCard3dsJavaScript中override的paylandsSuccess、paylandsFail方法并未添加@JavascriptInterface注解,仅在接口IAddCard3dsJavaScript的方法上添加了注解。这会导致WebView绑定HTMLOUT对象时,不会将上述两个方法暴露给JS层,最终JS拿到的HTMLOUT是无任何可调用方法的空对象,自然抛出Uncaught TypeError: window.parent.HTMLOUT.paylandsFail is not a function错误。 - 之前尝试将接口名改为
window.parent.HTMLOUT时不报错的本质原因:addJavascriptInterface会把传入的字符串作为window全局对象下的顶层属性名创建,此时注入的是一个名为“window.parent.HTMLOUT”的孤立全局变量,和JS代码访问的window.parent.HTMLOUT路径(window的parent属性下的HTMLOUT节点)完全不匹配。JS执行if判断时拿到的window.parent.HTMLOUT为undefined,直接跳过了方法调用分支,因此不会触发方法不存在的报错,自然也不会执行方法体逻辑。
二、跨域嵌套iframe的同源策略限制
- 触发报错的JS代码是运行在第三方3ds支付的跨域iframe内部的,这段代码原本的适用场景是普通浏览器网页的同域通信逻辑:主页面直接在window上暴露
HTMLOUT对象,同域的支付iframe可以直接访问parent window的自定义属性完成方法调用。 - 在Android WebView场景下,WebView从API 17开始,默认JS接口仅会绑定到WebView加载的顶级页面的window上下文,不会自动穿透到嵌套的子iframe;同时跨域iframe的JS代码受浏览器同源策略限制,根本无法直接读取/访问parent window上的自定义注入对象,即便顶级window上确实存在
HTMLOUT对象,跨域场景下的直接访问也会被浏览器拦截。
解决方案
第一步:修正JS接口的注解定义
将@JavascriptInterface注解直接添加到实现类AddCard3dsJavaScript的override方法上,不要仅在接口方法上添加注解,确保WebView可以正确识别需要暴露给JS的方法:
class AddCard3dsJavaScript(private val presenter: IAddCard3dsCallback) : IAddCard3dsJavaScript { @JavascriptInterface override fun paylandsSuccess() { presenter.onPaylands3dsSuccess() } @JavascriptInterface override fun paylandsFail() { presenter.onPaylands3dsFailed() } }
第二步:适配跨域iframe的通信场景
推荐使用postMessage桥接的通用方案,完全规避同源策略的限制:
- 在WebView完成页面加载后,向顶级window注入全局message监听逻辑,接收子iframe发出的支付状态消息,收到合法消息后直接调用本地注入的
HTMLOUT方法:
// 页面加载完成后注入监听逻辑 addCardWebView?.webViewClient = object : WebViewClient() { override fun onPageFinished(view: WebView?, url: String?) { super.onPageFinished(view, url) view?.evaluateJavascript( """ window.addEventListener('message', function(event) { // 校验消息来源为可信的3ds域名,避免安全风险 if (event.origin !== "你的3ds支付合法域名") return; // 匹配对应消息触发本地回调 if (event.data === 'PAYLANDS-ERROR') { window.HTMLOUT.paylandsFail(); } }) """.trimIndent(), null ) } }
- 该方案下,子iframe的postMessage发送行为不受跨域限制,顶级页面收到消息后,在自身的window上下文里调用本地注入的方法,完全不会触发跨域访问拦截,也不需要依赖子iframe直接访问parent window的自定义对象。
如果3ds验证页面和WebView加载的顶级页面为同域,可以在完成第一步的注解修正后,补充开启WebView的跨域访问配置,让注入的HTMLOUT对象可以被子iframe正常访问:
addCardWebView?.settings.apply { javaScriptEnabled = true // 允许跨域的JS接口访问 allowUniversalAccessFromFileURLs = true allowFileAccessFromFileURLs = true }
内容的提问来源于stack exchange,提问作者Sergei Mikhailovskii
相关产品推荐
相关产品推荐

