Flutter中TextField通过TextController赋值显示不一致问题求助

问题描述 #

两个详情页复用同一函数创建带DateTimePicker图标的TextField组件，其中一个页面能正常展示选中的日期时间，另一个页面无法显示。具体情况：

• 两个页面的TextController均在相同位置创建并初始化
• 曾怀疑Context来源不同（一个用buildContext，一个用framework的get context），但两者功能均正常
• 调试确认：两个页面的代码都已将日期时间文本赋值给TextController.text，但仅一个页面能渲染该文本

相关代码 #

页面调用inputDateField的代码：

inputDateField(
// either buildContext or framework `get context`
    context: context,
    textController: _remindedDateController,
    label: 'Reminded At'.i18n,
    getDateTimeValue: () => this.widget.item.remindedAt,
    setDateTimeValue: (DateTime? newValue) {
      this.setState(() {
        this.widget.item.remindedAt = newValue;
        _remindedDateController.text = formatDateTime(newValue);
      });
    },
  ),

inputDateField组件内部的日期选择触发代码：

onPressed: () async {
  final DateTime? newValue = await showOmniDateTimePicker(
    context: context,
    initialDate: getDateTimeValue(),
  );
  if (newValue != null) {
    setDateTimeValue(newValue);
  }
},

排查方向 #

• 检查TextController生命周期
  • 确认无法显示的页面中，_remindedDateController是在initState中初始化，而非build方法内（build方法重建会重新创建controller，导致赋值失效）
  • 检查页面dispose时是否正确销毁controller，避免因controller已被回收导致文本无法更新
• 验证setState的作用范围
  • 在无法显示页面的build方法中添加日志，确认选中日期后是否触发了Widget重建
  • 检查this.widget.item是否为不可变对象，若为不可变类型，修改remindedAt后无法触发状态更新，建议将item转为可观察对象或在setState中确保状态变量被正确更新
• 检查inputDateField组件实现
  • 确认组件内的TextField是否正确绑定了传入的textController，没有在组件内部重新创建controller覆盖传入实例
  • 检查TextField的enabled、readOnly等属性，确保文本渲染不受属性限制
• 验证formatDateTime函数输出
  • 调试打印formatDateTime(newValue)的返回值，确认其为有效非空字符串，格式符合TextField的渲染要求
• Context隐性影响测试
  • 将无法显示页面的Context替换为buildContext重新测试，排除Context层级导致的状态更新不触发问题

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