Flutter中AutoRoute处理DeepLink无效，如何修复？

1. 先确认DeepLink的实际路径值 #

你代码里已经打印了link.path，先看控制台输出的路径是否和你判断的一致。比如你测试的URL是my-url/ru/reset-password，实际获取到的link.path可能是/ru/reset-password，但也可能因为平台配置问题，路径格式和预期不符（比如不带前置斜杠、包含域名等），根据打印结果调整判断条件。

2. 优化DeepLink匹配逻辑 #

可以直接用AutoRoute自带的匹配能力代替手动判断，避免路径匹配失误：

deepLinkBuilder: (link) {
  final matchedRoutes = _appRouter.matchDeepLink(link);
  return DeepLink(matchedRoutes ?? [ResetPassRoute()]);
}

如果坚持手动判断，确保link.path的匹配条件完全贴合实际输出值。

3. 补全平台端DeepLink配置 #

Android端 #

在AndroidManifest.xml的主Activity标签内添加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="my-url"
        android:host="ru"
        android:pathPrefix="/reset-password" />
</intent-filter>

注意根据你的URL结构调整scheme、host和pathPrefix，比如如果URL是my-url://ru/reset-password，上述配置就适用。

iOS端 #

在Info.plist中添加URL Scheme配置：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>my-url</string>
        </array>
        <key>CFBundleURLName</key>
        <string>ru</string>
    </dict>
</array>

如果使用Universal Links，需要额外配置关联域名，但先确保基础URL Scheme配置正确。

4. 修复路由配置的重复问题 #

你的路由配置里RegistrationRoute.page重复出现了两次：一次嵌套在MainRoute的children里，一次是独立路由。这种重复会导致路由匹配混乱，建议移除嵌套的那一项，保留独立路由：

@AutoRouterConfig()
class AppRouter extends _$AppRouter {
  @override
  List<AutoRoute> get routes => [
        AutoRoute(page: MainRoute.page, initial: true, children: [
          AutoRoute(page: HomeRoute.page),
          AutoRoute(page: HelpRoute.page),
          AutoRoute(page: AboutRoute.page),
          AutoRoute(page: ContactsRoute.page),
          AutoRoute(page: ConfidenceRoute.page),
          AutoRoute(page: TermsRoute.page),
          AutoRoute(page: FavoriteRoute.page),
          AutoRoute(page: CreateRoute.page),
          AutoRoute(page: MessageRoute.page),
          AutoRoute(page: ProfileRoute.page),
          // 移除此处的RegistrationRoute.page
        ]),
        AutoRoute(page: RegistrationRoute.page),
        AutoRoute(page: ResetPassRoute.page),
      ];
}

5. 用标准方式测试DeepLink #

确保测试URL的传递方式正确：

• Android：使用adb命令测试：adb shell am start -W -a android.intent.action.VIEW -d "my-url://ru/reset-password" com.your.package.name
• iOS：使用模拟器命令测试：xcrun simctl openurl booted my-url://ru/reset-password

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