Flutter中Firestore Timestamp转格式化字符串出现临时报错如何解决

报错原因 #

该临时报错由StreamBuilder的加载时序问题导致：

• 新建帖子提交到Firestore后，Stream会第一时间收到新文档快照，此时后端写入的timestamp字段还未完成回传，或是前端临时生成的文档数据中post_fecha字段未完成赋值，处于null状态
• 你编写的formatearFecha函数要求入参为非空Timestamp类型，实际传入了null值，调用timestamp.seconds时就触发了空指针错误
• 等后端完整的文档数据同步回前端后，post_fecha有了有效值，渲染就恢复正常，因此报错仅短暂出现

解决方法 #

1. 给日期格式化函数增加空安全处理 #

把入参修改为可空类型，增加判空逻辑，空值时返回兜底展示字符串：

String formatearFecha(Timestamp? timestamp){
  // 传入null直接返回兜底文本
  if (timestamp == null) return '加载中...';
  var dateFromTimeStamp = DateTime.fromMillisecondsSinceEpoch(timestamp.seconds * 1000);
  return DateFormat('dd-MM-yyyy HH:mm').format(dateFromTimeStamp);
}

2. 给StreamBuilder增加加载状态判断 #

在StreamBuilder的builder逻辑中，先判断快照的加载状态，未拿到完整数据时展示加载占位组件，不要直接渲染列表：

StreamBuilder(
  stream: 你的帖子数据流,
  builder: (context, snapshot) {
    // 加载中展示占位
    if (snapshot.connectionState == ConnectionState.waiting) {
      return const Center(child: CircularProgressIndicator());
    }
    // 无数据时展示空状态
    if (!snapshot.hasData) {
      return const Center(child: Text('暂无帖子'));
    }
    // 拿到完整数据再渲染列表
    final listaFiltrada = snapshot.data!.docs;
    return ListView.builder(
      // 原有列表渲染逻辑
    );
  },
)

3. （可选）新建帖子时本地提前赋值timestamp #

如果不想展示加载兜底文本，可以在新建帖子提交阶段，本地先给post_fecha赋当前时间的Timestamp值，从源头避免空值出现：

final nuevoPost = Post(
  // 其他帖子字段赋值
  post_fecha: Timestamp.now(),
);
// 再提交到Firestore

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