Alpha版React应用出现无自定义Scheme深层链接崩溃错误

错误核心 #

Alpha版本崩溃原因明确：应用未配置自定义URL Scheme，但代码中尝试创建Deep Link，错误日志如下：

Exception com.facebook.react.common.JavascriptException: Error: Cannot make a deep link into a standalone app with no custom scheme defined, stack:
<unknown>@854:963
E@836:3496
<unknown>@836:567
<unknown>@460:2224
h@2:1585
<unknown>@6:57
h@2:1585
d@2:958
global code@1241:3
  at com.facebook.react.modules.core.ExceptionsManagerModule.reportException (ExceptionsManagerModule.java:72)
  at java.lang.reflect.Method.invoke
  at com.facebook.react.bridge.JavaMethodWrapper.invoke (JavaMethodWrapper.java:372)
  at com.facebook.react.bridge.JavaModuleWrapper.invoke (JavaModuleWrapper.java:188)
  at com.facebook.react.bridge.queue.NativeRunnable.run
  at android.os.Handler.handleCallback (Handler.java:938)
  at android.os.Handler.dispatchMessage (Handler.java:99)
  at com.facebook.react.bridge.queue.MessageQueueThreadHandler.dispatchMessage (MessageQueueThreadHandler.java:27)
  at android.os.Looper.loopOnce (Looper.java:201)
  at android.os.Looper.loop (Looper.java:288)
  at com.facebook.react.bridge.queue.MessageQueueThreadImpl$4.run (MessageQueueThreadImpl.java:228)
  at java.lang.Thread.run (Thread.java:920)

排查与修复步骤 #

• 检查Alpha版本的AndroidManifest配置
  确认Alpha包的AndroidManifest.xml里是否添加了自定义Scheme的intent-filter——Prod版本正常说明Prod已配置，大概率是Alpha构建时漏掉了：

  <activity
      android:name=".MainActivity"
      android:label="@string/app_name"
      android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
      android:launchMode="singleTask"
      android:windowSoftInputMode="adjustResize">
      <!-- 新增intent-filter配置自定义Scheme -->
      <intent-filter>
          <action android:name="android.intent.action.VIEW" />
          <category android:name="android.intent.category.DEFAULT" />
          <category android:name="android.intent.category.BROWSABLE" />
          <!-- 替换为你的自定义Scheme，比如myapp:// -->
          <data android:scheme="myapp" />
      </intent-filter>
  </activity>
  

  同时检查gradle构建脚本，确认Alpha变体中没有覆盖或移除该配置。

• 在代码中添加Scheme存在性检查
  调用Linking.openURL、Linking.createURL等Deep Link相关方法前，先判断Scheme是否可用，避免无配置时崩溃：

  import { Linking } from 'react-native';
  
  // 示例：打开Deep Link前先做检查
  const openDeepLink = async () => {
    const scheme = 'myapp://';
    const isAvailable = await Linking.canOpenURL(scheme);
    if (isAvailable) {
      await Linking.openURL(`${scheme}path/to/page`);
    } else {
      // 处理无Scheme的情况，比如提示用户或跳转至其他页面
      console.log('自定义Scheme未配置，无法打开Deep Link');
    }
  };
  

• 核对构建配置一致性
  如果使用Expo或其他构建工具，检查Alpha构建时是否加载了正确的配置文件（比如Expo的app.json中android.scheme和ios.scheme是否在Alpha环境下正确设置），避免构建脚本在Alpha版本中遗漏Scheme配置。

• 检查签名与构建渠道差异
  确认Alpha版本的签名方式、构建渠道是否和Prod一致——极少数情况下签名差异会导致配置不生效，可作为最后排查项。

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