Expo iOS App Links后台运行时点击崩溃问题排查

使用Expo开发的App，已在app.json中配置App Links（配置代码如下），且部署了有效的AASA文件。当前为TestFlight构建版本，无堆栈跟踪信息，未编写自定义链接处理代码，依赖Expo自动导航至post.js页面。首次从WhatsApp点击mydomain.net/post?id=6链接时，App可正常启动并跳转至正确页面；但当App处于后台未被杀死时，再次点击该链接，App发生崩溃。

已配置的app.json iOS部分 #

"ios": {
    "associatedDomains": ["applinks:mydomain.net"],
    "supportsTablet": true,
    "bundleIdentifier": "com.mydomain",
    "buildNumber": "7",
    "runtimeVersion": {
        "policy": "sdkVersion"
    }
}

排查方向： #

• 强制获取崩溃日志：TestFlight版本可通过Xcode连接测试设备，在Window > Devices and Simulators里查看对应设备的崩溃日志；也可以让测试用户在iOS设置的隐私与安全性 > 分析与改进 > 分析数据中找到App的崩溃记录，过滤Crash类型条目，调用栈信息是定位问题的关键。
• 临时替换Expo默认导航逻辑：后台唤起时可能存在路由栈状态冲突，试试在App.js中添加自定义链接监听：

  import { Linking } from 'react-native';
  import { useNavigation } from '@react-navigation/native';
  
  const App = () => {
    const navigation = useNavigation();
    
    useEffect(() => {
      const handleUrl = (event) => {
        const url = event.url;
        const params = new URLSearchParams(new URL(url).search);
        const postId = params.get('id');
        navigation.navigate('Post', { id: postId });
      };
      Linking.addEventListener('url', handleUrl);
      return () => Linking.removeEventListener('url', handleUrl);
    }, [navigation]);
  
    // 其他App逻辑...
  };
  

  如果手动处理后不再崩溃，说明Expo默认导航逻辑和后台状态存在冲突。
• 校验AASA文件与设备关联状态：后台唤起时iOS会重新校验AASA配置，可能存在缓存问题。试试删除App重装，或者在iOS设置里清除Safari缓存后再测试；同时确认AASA文件的paths配置包含/post?id=*这类规则，确保链接能被正确匹配。
• 检查runtimeVersion配置：当前用了sdkVersion策略，确保TestFlight构建的SDK版本和项目本地SDK版本完全一致。试试把runtimeVersion改成固定字符串（比如"1.0.0"），重新构建TestFlight版本测试，排除JS bundle版本不匹配的问题。
• 测试多场景唤起：换用Safari、微信等其他App唤起后台的App，看是否只有WhatsApp场景下崩溃，排除第三方App唤起方式的差异。
• 排查post.js页面的生命周期异常：后台唤起时会触发页面的focus或mount生命周期，检查post.js里的异步操作（比如数据请求、状态更新）是否有未处理的异常，比如未校验id参数是否存在，或者状态更新时组件已卸载。

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