自定义Deep Link在App关闭时无法唤起且验证始终失败的问题

问题详情 #

应用配置了自定义scheme的DeepLink，但应用处于关闭状态时点击DeepLink无任何反应；同时DeepLinkReceiver中intent.getBooleanExtra(DeepLinkHandler.EXTRA_SUCCESSFUL, false)始终返回false。

现有代码 #

DeepLinkReceiver实现

public class DeepLinkReceiver extends BroadcastReceiver {

@Override
public void onReceive(Context context, Intent intent) {
    String deepLinkUri = intent.getStringExtra(DeepLinkHandler.EXTRA_URI);

    if (intent.getBooleanExtra(DeepLinkHandler.EXTRA_SUCCESSFUL, false)) {
        Timber.d("onReceive: Success deep linking: %s", deepLinkUri);
    } else {
        String errorMessage = intent.getStringExtra(DeepLinkHandler.EXTRA_ERROR_MESSAGE);
        Timber.e("onReceive: Error deep linking %s with message: %s ", deepLinkUri, errorMessage);
    }
}
}

AndroidManifest中的intent-filter配置

<intent-filter>
    <action android:name="android.intent.action.VIEW" />

    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data
        android:scheme="myapp" />
</intent-filter>

解决方案 #

1. 检查BroadcastReceiver的注册完整性 #

确认DeepLinkReceiver已在AndroidManifest中正确注册，且广播action与DeepLinkHandler发送广播时的action一致：

<receiver
    android:name=".DeepLinkReceiver"
    android:exported="true">
    <intent-filter>
        <!-- 替换为DeepLinkHandler实际使用的广播action -->
        <action android:name="com.your.app.DEEP_LINK_COMPLETE" />
    </intent-filter>
</receiver>

如果未注册或action不匹配，接收器将无法收到广播，自然无法处理结果。

2. 排查DeepLinkHandler的处理逻辑 #

EXTRA_SUCCESSFUL持续为false，说明DeepLinkHandler在处理DeepLink时出现异常：

• 确认应用冷启动时，DeepLinkHandler是否能正确获取并处理启动Intent；
• 检查DeepLinkHandler中是否存在未捕获的异常，导致直接返回失败状态；
• 验证启动Intent是否被正确传递到DeepLinkHandler的处理流程中。

3. 改用Activity直接处理DeepLink（更可靠方案） #

广播方式易出现传递丢失问题，推荐直接在入口Activity的onCreate和onNewIntent中处理：

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        processDeepLink(getIntent());
    }

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        setIntent(intent);
        processDeepLink(intent);
    }

    private void processDeepLink(Intent intent) {
        if (Intent.ACTION_VIEW.equals(intent.getAction()) && intent.getData() != null) {
            Uri deepLinkUri = intent.getData();
            Timber.d("Received deep link: %s", deepLinkUri.toString());
            // 此处添加你的DeepLink业务处理逻辑
        }
    }
}

确保该Activity的intent-filter配置与你现有配置一致，无论应用是冷启动还是后台唤醒，都能直接捕获DeepLink Intent。

4. 完善Scheme配置的准确性 #

如果你的DeepLink包含host、path等参数，需补充完整<data>标签配置，示例：

<data
    android:scheme="myapp"
    android:host="app.example.com"
    android:pathPrefix="/detail" />

同时确保测试用的DeepLink格式正确，例如myapp://app.example.com/detail/123。

5. 正确测试DeepLink #

避免使用部分模拟器浏览器测试（部分浏览器不支持自定义scheme），推荐用adb命令测试：

adb shell am start -W -a android.intent.action.VIEW -d "myapp://test" com.your.app.package

替换com.your.app.package为你的应用包名，观察应用是否正常启动并处理DeepLink。

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