Flutter Firestore倒计时秒数不一致问题排查求助

在Flutter应用中从Firestore读取Timestamp转换为DateTime，实现「天:时:分:秒」的倒计时功能。目前所有倒计时目标时间均显示为00:00:00，但秒数显示不一致（忽略目标日期已过期的情况）。数据通过基础服务从Firestore拉取，分页限制20条，当前仅加载10条数据。

实现代码 #

class CountdownLabel extends StatefulWidget {
  final DateTime startDate;

  const CountdownLabel({
    super.key,
    required this.startDate,
  });

  @override
  CountdownLabelState createState() => CountdownLabelState();
}

class CountdownLabelState extends State<CountdownLabel> {
  Timer? timer;

  @override
  void initState() {
    super.initState();

    timer = Timer.periodic(const Duration(seconds: 1), (timer) {
      setState(() {});
    });
  }

  Duration get durationUntilStart {
    Duration duration = widget.startDate.difference(DateTime.now());
    return duration >= duration ? duration : const Duration(seconds: 0);
  }

  Widget _durationInHoursMinSecsWidget(BuildContext context) {
    return Row(
      mainAxisSize: MainAxisSize.min,
      children: [
        componentWidget(durationUntilStart.inDays.toString()),
        hoursMinSecSeparator,
        componentWidget(durationUntilStart.inHours.remainder(24).toString()),
        hoursMinSecSeparator,
        componentWidget(durationUntilStart.inMinutes.remainder(60).toString()),
        hoursMinSecSeparator,
        componentWidget(durationUntilStart.inSeconds.remainder(60).toString())
      ],
    );
  }

  Widget get hoursMinSecSeparator => Text(
        ':',
      );

  Widget componentWidget(String text) {
    return Row(
      children: [
        Text(
          text,
        ),
      ],
    );
  }

  @override
  Widget build(BuildContext context) {
    return Row(
      children: [
        _durationInHoursMinSecsWidget(context),
      ],
    );
  }
}

排查方向 #

• 修复核心逻辑错误：durationUntilStart中的duration >= duration是恒成立的无效判断，无法正确处理过期时间。应改为return duration.isNegative ? const Duration(seconds: 0) : duration;，否则负数duration会导致inSeconds.remainder(60)返回异常值（如负数），造成秒数显示不一致。
• 统一倒计时更新机制：每个CountdownLabel独立创建Timer，多个实例的触发时间存在偏差。可改用全局Timer统一通知所有倒计时组件更新，或使用Ticker替代Timer，保证更新同步性。
• 验证Timestamp转换准确性：打印所有startDate的具体值，确认从Firestore Timestamp转换为DateTime时是否存在时区偏差、精度丢失，确保所有目标时间确实一致。
• 监控组件生命周期：在initState和dispose中添加日志，检查Timer是否被重复创建或意外销毁，同时确认父Widget是否频繁重建导致startDate被重置。
• 处理数值显示逻辑：当duration为负数时，remainder(60)会得到负数，需将显示数值处理为非负整数，例如使用durationUntilStart.inSeconds.remainder(60).abs().toString()，或直接在duration为负时返回0。

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