Flutter中Timer.periodic重复触发多实例问题解决咨询

下面是几个可行的解决思路，核心都是确保全局仅存在一个定时器实例：

方案1：自定义单例类管理定时器 #

创建全局单例类统一管控定时器的创建、运行与销毁，从根源避免重复实例化。

代码示例：

class TimerManager {
  // 单例实例
  static final TimerManager _instance = TimerManager._internal();
  Timer? _periodicTimer;

  factory TimerManager() => _instance;

  TimerManager._internal();

  // 启动定时器（仅当无活跃实例时创建）
  void startPeriodicTimer() {
    if (_periodicTimer?.isActive != true) {
      _periodicTimer = Timer.periodic(const Duration(minutes: 1), (timer) {
        print('some code here');
      });
    }
  }

  // 取消定时器（例如App退后台时调用）
  void cancelTimer() {
    _periodicTimer?.cancel();
    _periodicTimer = null;
  }

  // 检查定时器状态
  bool get isTimerActive => _periodicTimer?.isActive ?? false;
}

在目标页面中调用：

@override
void initState() {
  super.initState();
  // 进入页面时启动，单例会自动判断是否已存在活跃定时器
  TimerManager().startPeriodicTimer();
}

// 可选：监听App生命周期，后台暂停、前台恢复
@override
void didChangeAppLifecycleState(AppLifecycleState state) {
  super.didChangeAppLifecycleState(state);
  if (state == AppLifecycleState.paused) {
    TimerManager().cancelTimer();
  } else if (state == AppLifecycleState.resumed) {
    TimerManager().startPeriodicTimer();
  }
}

方案2：借助全局状态管理工具（以Provider为例） #

如果项目已使用状态管理，可将定时器逻辑托管到全局状态中，确保状态唯一性。

示例代码：

// 定义Timer状态类
class TimerProvider with ChangeNotifier {
  Timer? _timer;

  void startTimer() {
    if (_timer?.isActive != true) {
      _timer = Timer.periodic(const Duration(minutes: 1), (timer) {
        print('some code here');
        // 需要更新UI时可调用notifyListeners()
      });
    }
  }

  void stopTimer() {
    _timer?.cancel();
    _timer = null;
  }

  bool get isTimerRunning => _timer?.isActive ?? false;
}

在main.dart注册Provider：

void main() {
  runApp(
    ChangeNotifierProvider(
      create: (context) => TimerProvider(),
      child: const MyApp(),
    ),
  );
}

在目标页面使用：

@override
void initState() {
  super.initState();
  final timerProvider = Provider.of<TimerProvider>(context, listen: false);
  timerProvider.startTimer();
}

方案3：绑定WidgetsBinding全局监听 #

通过WidgetsBinding监听App生命周期，同时维护全局定时器变量，避免重复创建。

示例代码：

// 全局范围定义定时器变量
Timer? globalTimer;

void main() {
  runApp(const MyApp());
  // 添加生命周期监听
  WidgetsBinding.instance.addObserver(LifecycleObserver());
}

class LifecycleObserver extends WidgetsBindingObserver {
  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    super.didChangeAppLifecycleState(state);
    if (state == AppLifecycleState.resumed) {
      _startGlobalTimer();
    } else if (state == AppLifecycleState.paused) {
      globalTimer?.cancel();
      globalTimer = null;
    }
  }

  void _startGlobalTimer() {
    if (globalTimer?.isActive != true) {
      globalTimer = Timer.periodic(const Duration(minutes: 1), (timer) {
        print('some code here');
      });
    }
  }
}

以上方案均能实现「无论进入多少次页面，仅维持一个每分钟执行一次的定时器」的需求。

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