Ionic 3.19.1安卓端深度链接失效，始终跳转至根页面

我之前帮好几个开发者踩过Ionic 3安卓深度链接的坑，你的情况太典型了——本地ionic serve里用URL跳转顺得不行，一装到安卓设备就直接弹回根页面，这大概率是安卓端的配置没跟上，或者路由初始化的时机没卡对。下面是我整理的几个必查步骤，按顺序来基本能解决问题：

1. 检查AndroidManifest.xml的Intent过滤配置 #

安卓系统需要明确知道你的应用要处理哪些链接，这一步没配置对，系统根本不会把链接传给你的应用。打开platforms/android/app/src/main/AndroidManifest.xml，找到主Activity（一般是MainActivity），确保里面有正确的<intent-filter>，并且加上android:launchMode="singleTask"——这个属性很关键，不然每次打开链接都会重启应用，直接重置到根页面：

<activity android:name="MainActivity" android:launchMode="singleTask">
    <!-- 其他原有配置 -->
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- 替换成你的自定义scheme和host -->
        <data android:scheme="myapp" android:host="example.com" />
    </intent-filter>
</activity>

2. 确认Deeplinks插件的初始化与监听 #

Ionic 3本身的路由在安卓端需要依赖cordova插件来接收系统的Intent。先确保你已经安装了cordova-plugin-deeplinks：

ionic cordova plugin add cordova-plugin-deeplinks --variable URL_SCHEME=myapp --variable DEEPLINK_HOST=example.com
npm install @ionic-native/deeplinks

然后在app.module.ts里导入并添加到providers：

import { Deeplinks } from '@ionic-native/deeplinks';

@NgModule({
  // ...其他配置
  providers: [
    Deeplinks,
    // ...其他providers
  ]
})
export class AppModule {}

最重要的一步：在app.component.ts里监听deeplink事件，并且在平台就绪后处理路由跳转。这里要注意，必须等待platform.ready()完成，否则路由还没初始化，跳转指令会失效：

import { Deeplinks } from '@ionic-native/deeplinks';
import { NavController } from 'ionic-angular';

constructor(private deeplinks: Deeplinks, private navCtrl: NavController) {}

ionViewDidLoad() {
  this.platform.ready().then(() => {
    this.deeplinks.route({
      '/detail/:id': DetailPage,
      '/profile': ProfilePage
    }).subscribe(match => {
      // 匹配到深度链接，跳转到对应页面
      this.navCtrl.push(match.route, match.params);
    }, nomatch => {
      console.error('深度链接匹配失败:', nomatch);
    });
  });
}

3. 处理冷启动与路由初始化时机 #

如果你的应用是完全关闭后通过深度链接打开（冷启动），Ionic的路由模块可能还没完成初始化，这时候直接调用navCtrl.push会无效。可以加个小延迟，或者等待Ionic的导航组件就绪：

// 在app.component.ts的platform.ready()里
setTimeout(() => {
  this.deeplinks.route({/* 路由配置 */}).subscribe(/* 处理逻辑 */);
}, 500);

500ms的延迟在大多数情况下足够覆盖路由初始化的时间，如果你想更严谨，也可以监听导航组件的就绪状态。

4. 用adb命令测试链接是否被正确接收 #

有时候问题出在链接本身，或者系统没把链接传给应用。可以用adb命令直接发送Intent测试：

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

把com.your.app.package换成你应用的包名（可以在config.xml里找到）。如果命令执行后应用能跳转到对应页面，说明系统配置没问题，问题出在Ionic的路由监听；如果还是跳根页面，那就是AndroidManifest的配置有问题。

5. 检查Ionic路由的DeepLinkConfig #

最后确认app.module.ts里的DeepLinkConfig配置正确，每个页面的segment和component对应：

import { DeepLinkConfig } from 'ionic-angular';

export const deepLinkConfig: DeepLinkConfig = {
  links: [
    { component: HomePage, name: 'Home', segment: 'home' },
    { component: DetailPage, name: 'Detail', segment: 'detail/:id' }
  ]
};

@NgModule({
  declarations: [/* 页面 */],
  imports: [
    IonicModule.forRoot(MyApp, {}, deepLinkConfig)
  ]
})

按这个顺序排查，基本能解决安卓端深度链接跳根页面的问题。我之前遇到的大部分情况都是AndroidManifest的launchMode没设对，或者插件监听的时机太早导致路由没就绪。

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