如何修复Flutter DataTable报错'columns.isNotEmpty': is not true

这个报错的核心原因很直接：你传给DataTable的columns参数是空列表，Flutter的DataTable组件强制要求列集合必须非空，哪怕还没加载到行数据，列也得有初始值。

下面针对你的「点击按钮加载数据」场景，给出几种具体修复方案：

方案1：提前定义固定列（适用于列结构固定的场景） #

如果表格的列是固定的（比如ID、名称、操作这类固定表头），直接在初始化时给columns赋值非空列表，点击按钮只更新行数据即可：

// 初始化时就定义好固定列
List<DataColumn> _columns = const [
  DataColumn(label: Text('ID')),
  DataColumn(label: Text('商品名称')),
  DataColumn(label: Text('价格')),
];
List<DataRow> _rows = [];

// 按钮点击触发的加载方法
void _loadTableData() async {
  // 模拟接口请求行数据
  final fetchedRows = await _fetchRowsFromApi();
  setState(() {
    _rows = fetchedRows;
  });
}

// 构建UI
@override
Widget build(BuildContext context) {
  return DataTable(
    columns: _columns,
    rows: _rows,
  );
}

方案2：动态列+加载状态控制（适用于列从接口获取的场景） #

如果列是从接口动态获取的，需要在数据加载完成前，用加载组件替代DataTable，避免渲染空列的DataTable：

bool _isLoading = true;
List<DataColumn> _columns = [];
List<DataRow> _rows = [];

void _loadData() async {
  try {
    // 先请求列数据，再请求行数据
    final fetchedColumns = await _fetchColumnsFromApi();
    final fetchedRows = await _fetchRowsFromApi();
    
    setState(() {
      _columns = fetchedColumns;
      _rows = fetchedRows;
      _isLoading = false;
    });
  } catch (e) {
    // 接口出错时设置兜底列，避免空列表
    setState(() {
      _columns = const [DataColumn(label: Text('提示'))];
      _rows = [const DataRow(cells: [DataCell(Text('数据加载失败'))])];
      _isLoading = false;
    });
  }
}

@override
Widget build(BuildContext context) {
  return _isLoading
      ? const Center(child: CircularProgressIndicator())
      : DataTable(columns: _columns, rows: _rows);
}

方案3：排查setState中的误操作 #

检查你的按钮点击方法里，是否在某些分支（比如接口返回空、异常捕获）中不小心把_columns置成了空列表。确保任何情况下_columns都至少有一个列对象。

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