# 导航错误：未找到深度链接路由：/user/profile?id=123

- **ID:** `flutter/navigation-deep-link-not-found`
- **领域:** flutter
- **类别:** runtime_error
- **验证级别:** ai_generated
- **修复率:** 85%

## 根因

深度链接URL与导航器路由表中任何已注册的路由不匹配，通常是由于缺少路由定义或路径格式不正确。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| Flutter 3.16 | active | — | — |
| go_router 12.0.0 | active | — | — |
| Navigator 2.0 | active | — | — |

## 解决方案

1. ```
   Define the route in the router configuration. For go_router: GoRouter(routes: [GoRoute(path: '/user/profile/:id', builder: (context, state) => UserProfilePage(id: state.pathParameters['id']!))])
   ```
2. ```
   If using Navigator 2.0, override the 'onGenerateRoute' method to parse the deep link and return a MaterialPageRoute. Example: onGenerateRoute: (settings) { if (settings.name == '/user/profile') { return MaterialPageRoute(builder: (_) => UserProfilePage(id: settings.arguments as String)); } return null; }
   ```
3. ```
   Test the deep link with a custom URI scheme: 'myapp://user/profile/123'. Ensure the scheme is registered in Android/iOS and the router handles it.
   ```

## 无效尝试

- **** — go_router and Navigator 2.0 require route patterns with parameter placeholders like '/user/profile/:id', not full URLs. (85% 失败率)
- **** — Platform-level deep link setup alone is insufficient; the Flutter router must handle the path. (90% 失败率)
- **** — Deep links often include a host (e.g., 'myapp.com/user/profile'), and the router must match the full path. (75% 失败率)