Flutter PaginatedDataTable内TextFormField使用控制器/焦点节点时输入联动异常求助

你遇到的表格输入框状态联动、焦点错配，核心原因不是Provider配置错误，是PaginatedDataTable的滚动组件复用机制+TextFormField缺少和行数据的稳定绑定共同导致的：

• PaginatedDataTable在滚动、分页切换时，会自动回收离屏的DataCell组件并复用到新的显示行上
• 你当前的TextFormField没有和对应的行做唯一标识绑定，Flutter在组件复用时，会把旧组件的内部状态（输入内容、焦点）错配给新行，才会出现所有输入同步、状态始终绑定最后创建实例的不稳定表现
• 之前你尝试用int行索引做绑定的思路方向没错，但动态行索引本身会随着分页、滚动位置变化，不是稳定值，直接用做Key反而会触发状态匹配冲突，不是int类型不能当Key，是你用的Key值没有和固定行绑定。

• 给所有TextFormField共用同一个TextEditingController或FocusNode实例：这会直接强制所有输入框内容完全同步，和你遇到的第一类异常完全匹配
• 完全依赖TextFormField自带的initialValue属性不单独配置控制器：未设置controller的TextFormField会自动生成临时状态，但这个临时状态不会和固定行绑定，滚动复用时会直接丢失、错位
• 在build方法内临时创建Controller/FocusNode实例：每次组件重建都会生成全新的控制器，旧的状态直接丢失，表现为输入状态绑定最后一次创建的实例

1. 基于行的唯一业务标识做控制器/焦点节点映射 #

不要用动态行索引做绑定基础，直接使用行本身的固定业务ID（比如你代码里的row.codbarras，这个值不会随着滚动、分页变化，天生适合当唯一标识），维护全局和表格数据同生命周期的映射表：

// 映射表建议存在State类或业务Provider内，和表格数据生命周期保持一致，不要放在build方法内
final Map<String, TextEditingController> _qtdeControllers = {};
final Map<String, FocusNode> _qtdeFocusNodes = {};

// 封装统一的获取控制器方法：没有对应行的实例就新建，有就复用，同时同步最新的行数据初始值
TextEditingController _bindQtdeController(String rowUniqueId, String initialValue) {
  if (!_qtdeControllers.containsKey(rowUniqueId)) {
    _qtdeControllers[rowUniqueId] = TextEditingController(text: initialValue);
  }
  // 主动同步控制器内的文本和行最新数据，避免initialValue带来的错位
  if (_qtdeControllers[rowUniqueId]!.text != initialValue) {
    _qtdeControllers[rowUniqueId]!.text = initialValue;
  }
  return _qtdeControllers[rowUniqueId]!;
}

焦点节点的绑定逻辑和控制器完全一致，同样按行的唯一ID做映射，不要重复创建实例。

2. 给每个输入框设置稳定的唯一Key #

用行的唯一业务ID生成固定Key，避免组件复用时的状态错配，替换你原有TextFormField的实现：

DataCell(
  TextFormField(
    // 稳定的唯一Key，和固定行绑定
    key: ValueKey('qtde_input_${row.codbarras}'),
    // 用封装的绑定方法获取对应行的控制器，不要共用实例
    controller: _bindQtdeController(row.codbarras, row.quantidade),
    // 绑定对应行的独立焦点节点
    focusNode: _bindQtdeFocusNode(row.codbarras),
    // 移除全局的autofocus，避免所有输入框抢焦点导致的状态异常
    inputFormatters: [LengthLimitingTextInputFormatter(6)],
    style: TextStyle(color: context.read<DadosAcesso>().color),
    keyboardType: TextInputType.number,
    onChanged: (text) {
      // 原有逻辑保持不变
      updateProdutoQtde(text, index, row.codbarras);
    },
    onEditingComplete: (){
      // 原有逻辑保持不变
      context.read<DadosAcesso>().search = false;
      context.read<DadosAcesso>().focusBusca.requestFocus();
    },
  ),
)

3. 必要的资源回收 #

当表格中的行被永久删除、页面销毁时，要遍历映射表，对不再使用的Controller和FocusNode调用dispose()方法，避免内存泄漏。

• 不要在表格内的TextFormField上全局配置autofocus: true，这会导致每次组件重建时所有输入框都争抢焦点，是你遇到状态不稳定的重要诱因。如果需要自动聚焦，只给当前需要聚焦的那一个输入框单独设置即可。
• 如果用Provider维护映射表，通知状态更新时不要重置整个映射表，只更新对应行的内容就行，不然会把已创建的控制器全部冲掉，回到最初的串线问题。

内容的提问来源于stack exchange，提问作者Fernando Alexandre Wahl