Expo中Branch.subscribe()在Android端无法触发的技术问题

我之前也遇到过类似的坑！深度链接能打开App但就是触发不了Branch的订阅回调，大概率是配置或监听时机的问题，下面一步步帮你排查解决：

1. 先确认App配置是否正确（重中之重） #

首先检查app.json里的Branch和Android Intent配置，这是最容易出错的地方：

{
  "expo": {
    "scheme": "my-app",
    "android": {
      "package": "com.yourcompany.myapp",
      "intentFilters": [
        {
          "action": "VIEW",
          "data": [
            {
              "scheme": "my-app",
              "host": "*"
            },
            {
              "scheme": "https",
              "host": "your-app-slug.app.link", // 替换成你的Branch域名
              "pathPrefix": "/"
            }
          ],
          "category": ["BROWSABLE", "DEFAULT"]
        }
      ]
    },
    "plugins": [
      [
        "expo-branch",
        {
          "apiKey": "YOUR_BRANCH_API_KEY", // 从Branch后台复制
          "androidAppDomain": "your-app-slug.app.link"
        }
      ]
    ]
  }
}

• 确保intentFilters同时包含自定义scheme和Branch的https域名，这样Android才能把Branch链接正确路由给Branch SDK。
• 插件配置里的API Key和域名必须和Branch后台完全一致。

2. 把Branch监听放在App根组件，尽早初始化 #

不要在子组件里调用Branch.subscribe()，因为子组件挂载可能晚于链接打开的时机，导致错过事件。直接在App根组件的挂载钩子中设置监听：

类组件写法 #

import React from 'react';
import { DangerZone } from 'expo';
const { Branch } = DangerZone;

class App extends React.Component {
  componentDidMount() {
    console.log("App 已挂载");
    
    // 1. 订阅Branch事件
    this.branchSubscription = Branch.subscribe((bundle) => {
      console.log("终于拿到Branch数据了！", bundle);
      // 这里处理你的业务逻辑，比如跳转对应页面
    });

    // 2. 处理App冷启动/后台唤醒的初始链接
    Branch.getLatestReferringParams()
      .then(params => {
        console.log("初始Branch参数：", params);
        if (params && params['+clicked_branch_link']) {
          // 冷启动时的链接处理逻辑
        }
      })
      .catch(err => console.error("获取初始参数失败：", err));
  }

  componentWillUnmount() {
    // 记得清理订阅
    this.branchSubscription?.();
  }

  render() {
    return <YourAppMainContent />;
  }
}

export default App;

函数组件写法 #

import React, { useEffect } from 'react';
import { DangerZone } from 'expo';
const { Branch } = DangerZone;

export default function App() {
  useEffect(() => {
    console.log("App 已挂载");
    
    const unsubscribeBranch = Branch.subscribe((bundle) => {
      console.log("Branch回调触发！", bundle);
      // 处理业务逻辑
    });

    // 处理冷启动/后台唤醒的初始链接
    Branch.getLatestReferringParams()
      .then(params => {
        if (params?.['+clicked_branch_link']) {
          console.log("冷启动链接参数：", params);
        }
      });

    return () => unsubscribeBranch();
  }, []);

  return <YourAppMainContent />;
}

3. 正确测试，避免用Expo Go直接测自定义scheme #

Expo Go本身的scheme是exp://，会干扰自定义scheme的测试结果。建议：

• 使用Expo Dev Client构建测试包，它会保留你的自定义scheme配置。
• 或者直接构建独立的Android APK安装到设备上测试。

4. 验证Branch链接的有效性 #

确保你测试的是Branch后台生成的正式链接（比如https://your-app-slug.app.link/xxxx），而不是自己拼接的my-app://xxxx——普通scheme链接只能打开App，但不会触发Branch的回调，因为没有携带Branch的元数据。

5. 排除其他干扰 #

如果你的App同时使用了Linking.addEventListener处理深度链接，可能会抢占Branch的事件捕获，建议暂时注释掉其他深度链接逻辑，先测试Branch是否正常工作。

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