# NavigationError: deep link route not found: /user/profile?id=123

- **ID:** `flutter/navigation-deep-link-not-found`
- **Domain:** flutter
- **Category:** runtime_error
- **Verification:** ai_generated
- **Fix Rate:** 85%

## Root Cause

The deep link URL does not match any registered route in the Navigator's route table, often due to missing route definition or incorrect path format.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| Flutter 3.16 | active | — | — |
| go_router 12.0.0 | active | — | — |
| Navigator 2.0 | active | — | — |

## Workarounds

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']!))])** (95% success)
   ```
   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; }** (85% success)
   ```
   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.** (80% success)
   ```
   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.
   ```

## Dead Ends

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