Flutter：Dialog中使用GridView出现RenderViewport固有尺寸错误

错误原因 #

GridView是懒加载的视口组件，无法计算并返回固有尺寸；而你代码中AlertDialog的Column设置了mainAxisSize: MainAxisSize.min，会尝试获取子组件的固有尺寸来确定自身大小，两者的行为冲突导致了该错误。

修复方案 #

方案1：仅修复GridView #

给GridView.builder添加shrinkWrap: true属性，让它根据子项内容包裹自身，同时保留你设置的固定高度限制：

SizedBox(
  height: 200,
  child: GridView.builder(
    shrinkWrap: true, // 关键修复
    physics: const NeverScrollableScrollPhysics(), // 可选，禁用GridView内部滚动
    gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
      crossAxisCount: 2,
    ),
    itemCount: filterOptions.length,
    itemBuilder: (BuildContext context, int index) {
      return ListTile(
        title: Text(filterOptions[index]),
        onTap: () {
          Navigator.of(context).pop();
        },
      );
    },
  ),
),

方案2：让整个Dialog内容可滚动 #

如果Dialog内选项较多，建议把Column包裹在SingleChildScrollView中，实现整个内容的滚动，同时配合shrinkWrap和禁用GridView内部滚动：

showDialog(
  context: context,
  barrierDismissible: true,
  builder: (BuildContext context) {
    return AlertDialog(
      title: const Text('Options'),
      content: SingleChildScrollView( // 添加滚动容器
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Container(
              color: AppColors.kBlueColor,
              child: const ListTile(
                title: Text('Sort By:', style: TextStyle(color: Colors.white)),
              ),
            ),
            ListTile(
              title: const Text('Date Created - Newest First'),
              onTap: () {
                Navigator.of(context).pop();
              },
            ),
            ListTile(
              title: const Text('Date Created - Oldest First'),
              onTap: () {
                Navigator.of(context).pop();
              },
            ),
            ListTile(
              title: const Text('Alphabetical (A-Z)'),
              onTap: () {
                Navigator.of(context).pop();
              },
            ),
            ListTile(
              title: const Text('Alphabetical (Z-A)'),
              onTap: () {
                Navigator.of(context).pop();
              },
            ),
            Container(
              color: AppColors.kBlueColor,
              child: const ListTile(
                title: Text('Filter:', style: TextStyle(color: Colors.white)),
              ),
            ),
            ListTile(
              title: const Text('Status'),
              onTap: () {
                Navigator.of(context).pop();
              },
            ),
            SizedBox(
              height: 200,
              child: GridView.builder(
                shrinkWrap: true,
                physics: const NeverScrollableScrollPhysics(), // 禁用内部滚动
                gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
                  crossAxisCount: 2,
                ),
                itemCount: filterOptions.length,
                itemBuilder: (BuildContext context, int index) {
                  return ListTile(
                    title: Text(filterOptions[index]),
                    onTap: () {
                      Navigator.of(context).pop();
                    },
                  );
                },
              ),
            ),
            ListTile(
              title: const Text('Organization'),
              onTap: () {
                Navigator.of(context).pop();
              },
            ),
          ],
        ),
      ),
      actions: <Widget>[
        TextButton(
          child: const Text('Close'),
          onPressed: () {
            Navigator.of(context).pop();
          },
        ),
      ],
    );
  },
);

为什么有效 #

• shrinkWrap: true：让GridView根据子项的实际大小来确定自身主轴尺寸，不再尝试计算固有尺寸，解决了与Column的冲突。
• NeverScrollableScrollPhysics()：避免GridView自身滚动与外层SingleChildScrollView的滚动产生嵌套冲突，确保交互流畅。

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