flutter assertion_error ai_generated true

断言失败：'verticalDirection' 为 null 或未设置

Assertion failed: 'verticalDirection' is null or not set

ID: flutter/assertion-failed-vertical-viewport

其他格式: JSON · Markdown 中文 · English
93%修复率
87%置信度
1证据数
2023-09-01首次发现

版本兼容性

版本状态引入弃用备注
Flutter 3.13 active — — —
Flutter 3.16 active — — —
Flutter 3.19 active — — —

根因分析

垂直视口（例如 ListView、Column）在没有指定约束高度的情况下使用，导致无限垂直空间。

English

A vertical viewport (e.g., ListView, Column) is used without specifying a constrained height, causing infinite vertical space.

generic

官方文档

https://api.flutter.dev/flutter/widgets/ScrollView-class.html

解决方案

  1. Wrap the ListView in a Container or SizedBox with a fixed height:
SizedBox(
  height: 300,
  child: ListView(
    children: [...],
  ),
)
  2. If inside a Column, wrap the ListView in an Expanded and ensure the Column has a bounded height (e.g., by wrapping the Column in a SizedBox or Expanded):
Column(
  children: [
    Expanded(
      child: ListView(children: [...]),
    ),
  ],
)
  3. Use a CustomScrollView with slivers if you need mixed scrolling and non-scrolling content.

无效尝试

常见但无效的做法:

  1. Wrapping the ListView in an Expanded widget inside a Column 40% 失败

    Expanded only works when the parent has a fixed height; if the Column itself is unbounded, it still fails.

  2. Setting shrinkWrap: true on the ListView without also constraining the parent 30% 失败

    ShrinkWrap only affects the viewport's own size calculation; the parent widget must still provide a finite height constraint.

  3. Using Flexible instead of Expanded 50% 失败

    Flexible also requires a bounded parent; same fundamental issue.