Flutter手势触发异常：无法找到/details路由生成器求解

核心问题分析 #

你的报错源于两个关键问题：

1. DetailsPage嵌套MaterialApp：MaterialApp是Flutter路由系统的根节点，子页面中重新创建MaterialApp会导致Navigator使用新的独立导航上下文，无法匹配根MaterialApp中配置的路由。
2. 路由配置未处理参数：原routes配置直接传递固定的text和listDescription，未从arguments中获取传递的Note对象，和Navigator.pushNamed的传参逻辑不匹配。

修复步骤及代码 #

1. 修改根MaterialApp的路由配置

用onGenerateRoute替代routes，它支持处理带参数的路由生成：

class MyApp extends StatelessWidget {
  final String text;
  final int number;
  final String listDescription;

  const MyApp(
      {super.key,
      required this.text,
      required this.number,
      required this.listDescription});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      onGenerateRoute: (settings) {
        if (settings.name == DetailsPage.routeName) {
          // 取出传递的Note参数
          final note = settings.arguments as Note;
          return MaterialPageRoute(
            builder: (ctx) => DetailsPage(note: note),
          );
        }
        return null;
      },
      home: CustomListTile(
        text: text,
        number: number,
        listDescription: listDescription,
      ),
    );
  }
}

2. 修复DetailsPage

移除嵌套的MaterialApp，直接返回Scaffold，调整构造函数接收Note参数：

import 'package:flutter/material.dart';
import 'note.dart';

class DetailsPage extends StatefulWidget {
  static const String routeName = "/details";
  final Note note;

  const DetailsPage({super.key, required this.note});

  @override
  State<DetailsPage> createState() => _DetailsPageState();
}

class _DetailsPageState extends State<DetailsPage> {
  @override
  Widget build(BuildContext context) {
    Widget titleSection = Container(
      padding: const EdgeInsets.all(32),
      child: Row(
        children: [
          Expanded(
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.start,
              children: [
                Container(
                  padding: const EdgeInsets.only(bottom: 0),
                  child: Text(
                    widget.note.title,
                    style: const TextStyle(
                      fontWeight: FontWeight.bold,
                      fontSize: 25,
                    ),
                  ),
                ),
              ],
            ),
          ),
        ],
      ),
    );

    Color color = Theme.of(context).primaryColor;

    Widget buttonSection = Row(
      mainAxisAlignment: MainAxisAlignment.spaceEvenly,
      children: [
        _buildButtonColumn(color, Icons.edit, 'EDIT'),
        _buildButtonColumn(color, Icons.delete, 'DELETE'),
      ],
    );

    Widget textSection = Padding(
      padding: const EdgeInsets.all(20),
      child: Text(
        widget.note.description,
        softWrap: true,
      ),
    );

    return Scaffold(
      appBar: AppBar(
        leading: IconButton(
          icon: const Icon(Icons.arrow_back),
          onPressed: () => Navigator.pop(context),
        ),
        title: Text(widget.note.title),
      ),
      body: ListView(
        children: [
          Image.asset(
            'lib/images/placeholder.jpg',
            width: 600,
            height: 240,
            fit: BoxFit.cover,
          ),
          titleSection,
          buttonSection,
          textSection,
        ],
      ),
    );
  }

  Column _buildButtonColumn(Color color, IconData icon, String label) {
    return Column(
      mainAxisSize: MainAxisSize.min,
      mainAxisAlignment: MainAxisAlignment.center,
      children: [
        Icon(icon, color: color),
        Container(
          margin: const EdgeInsets.only(top: 8),
          child: Text(
            label,
            style: TextStyle(
              fontSize: 12,
              fontWeight: FontWeight.w400,
              color: color,
            ),
          ),
        ),
      ],
    );
  }
}

3. CustomListTile的跳转逻辑保留不变

onTap: () {
  Navigator.pushNamed(context, DetailsPage.routeName,
      arguments: Note(title: text, description: listDescription));
},

关键修复要点 #

• 整个应用只保留一个MaterialApp作为路由根，避免上下文冲突。
• 用onGenerateRoute处理带参数路由，可在生成页面时直接获取传递的参数。
• 页面参数通过构造函数传入，逻辑更清晰；也可保留didChangeDependencies方式获取arguments，但构造函数传参更直观。

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