Flutter集成uni_links时自定义scheme URL启动App立即闪退

崩溃发生在Flutter main函数执行前，说明问题出在iOS原生启动链路阶段，和Dart层业务代码无关。由于Universal Link拉起正常，可排除签名、核心引擎、基础运行环境故障，排查范围直接收敛到Custom URL Scheme相关配置与原生启动逻辑，按以下步骤操作即可定位问题：

1. 校验Info.plist配置合法性 #

打开ios/Runner/Info.plist文件，定位到CFBundleURLTypes配置段逐项检查：

• 自定义Scheme仅填写纯字符串即可，禁止添加://后缀，比如scheme为myapp就直接填myapp，误填带后缀的格式会导致系统解析URL时直接触发崩溃
• 检查所有Target（主程序、通知扩展、分享扩展等）是否重复声明了同一个URL Scheme，iOS 15上重复声明会引发进程拉起冲突闪退
• 不要将当前App的自定义Scheme加入LSApplicationQueriesSchemes数组，该数组仅用于声明需要跳转的第三方App Scheme，自身Scheme填入后会触发iOS 15的权限校验逻辑崩溃
• 正确配置参考：

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLName</key>
    <string>你的App包名</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>你的自定义Scheme</string>
    </array>
  </dict>
</array>

2. 检查AppDelegate生命周期回调逻辑 #

Flutter的Dart引擎在application:didFinishLaunchingWithOptions回调中完成初始化，这个阶段的崩溃会直接导致Dart层main函数无法执行：

• 检查所有URL相关参数的获取逻辑，必须做可选值判空，禁止强拆解包。iOS 15上系统通过Scheme拉起App时，部分场景传参为空，强取launchOptions[UIApplicationLaunchOptionsURLKey]会直接触发空值崩溃
• 检查第三方SDK（支付、分享、推送类）的初始化与URL回调顺序，这类SDK通常要求在Flutter引擎初始化前完成Scheme回调处理，顺序错误会触发SDK内部断言闪退。可临时注释所有第三方SDK初始化、自定义URL处理逻辑，仅保留Flutter默认初始化代码测试，逐步缩小问题范围
• 检查是否存在拦截openURL回调后返回错误值的逻辑，返回NO且未做兼容处理在iOS 15上会被系统判定为启动失败直接终止进程

3. 适配iOS 15 Scene生命周期逻辑 #

iOS 15优先走Scene多场景生命周期，配置不匹配会直接导致启动崩溃：

• 如果项目开启了UIApplicationSceneManifest配置（即使用SceneDelegate），必须在scene:willConnectToSession:options:和scene:openURLContexts:回调中实现Scheme参数处理逻辑，仅在AppDelegate中实现旧版单生命周期URL回调会导致系统找不到处理入口，直接终止App
• 如果是默认Flutter项目未使用SceneDelegate，检查Info.plist中是否误开启了UIApplicationSceneManifest开关，开启后系统会尝试加载不存在的SceneDelegate类，直接触发崩溃

4. 无侵入快速定位崩溃点 #

不需要额外埋点，用系统工具即可直接拿到崩溃原因：

• 打开Xcode连接测试设备/选中模拟器，进入Product -> Scheme -> Edit Scheme，在Run配置的Diagnostics分类中勾选Zombie Objects（僵尸对象检测），通过Xcode运行App后触发Scheme拉起，Xcode会直接定位到崩溃的具体代码行
• 也可以直接查看设备崩溃日志：进入Xcode的Window -> Devices and Simulators，选中对应测试设备，点击View Device Logs，找到和自己App包名一致的最新崩溃记录，查看Application Specific Information字段，会直接打印崩溃的明确原因，比如配置错误、未实现方法、权限缺失等
• 模拟器测试Scheme拉起时使用标准命令：xcrun simctl openurl booted 你的scheme://任意测试路径，不要发起空路径的Scheme请求，iOS 15对空路径Scheme请求会直接判定为无效拉起终止进程

5. 对照验证 #

新建空白Flutter项目，配置和现有项目完全一致的自定义Scheme，不引入任何第三方依赖、不添加额外原生逻辑，在相同iOS 15测试环境下验证Scheme拉起：

• 空白项目拉起正常：问题出在现有项目的配置冲突或第三方依赖，按前面步骤逐项回滚排查即可
• 空白项目同样崩溃：检查测试设备是否安装了其他声明了相同Scheme的App，相同Scheme被多个App声明时，iOS 15的拉起优先级逻辑会导致冲突闪退

内容的提问来源于stack exchange，提问作者Y.A.D