Android端banno-plugin-framework-bridge无法在新WebView打开_target="_top"链接

安全阿岳

2026-6-13

针对Banno插件Android端展开视图加载异常的排查方案

确认Bridge加载与初始化时机
在Next.js中，建议在组件挂载完成后（通过useEffect钩子）动态导入Bridge模块并执行enableRouter()，避免DOM未就绪时执行导致失效：
```
useEffect(() => {
  const initBridge = async () => {
    const bridge = await import('jack-henry/banno-plugin-framework-bridge');
    bridge.enableRouter();
  };
  initBridge();
}, []);
```
检查锚标签的href格式与属性完整性
确保href使用符合Banno规范的插件内完整路径（如/plugin/your-plugin-id/expand-view），避免相对路径；同时确认target="_top"属性未被Next.js的路由逻辑或其他组件覆盖，直接使用原生<a>标签而非嵌套在Next.js的<Link>组件中。

手动规避Next.js的路由拦截
如果必须使用Next.js相关路由逻辑，可手动阻止默认拦截行为，强制触发原生跳转：

<a 
  target="_top" 
  href="/plugin/xxx/expand" 
  onClick={(e) => {
    e.preventDefault();
    window.location.href = e.target.href;
  }}
>
  点击打开展开视图
</a>

验证Bridge初始化状态
在初始化代码中添加日志，确认enableRouter()是否成功执行，排查模块加载失败或执行异常的情况：

useEffect(() => {
  const initBridge = async () => {
    try {
      const bridge = await import('jack-henry/banno-plugin-framework-bridge');
      bridge.enableRouter();
      console.log('Bridge router enabled successfully');
    } catch (err) {
      console.error('Bridge load/init failed:', err);
    }
  };
  initBridge();
}, []);