Flutter中如何判断应用是否处于后台？遇Database is Locked错误

一、监听应用前后台状态（无需第三方包） #

Flutter官方提供WidgetsBindingObserver接口，可直接监听应用生命周期状态变化，精准判断应用处于前台/后台：

实现步骤 #

1. 在页面的State类中混入WidgetsBindingObserver
2. 在initState中注册观察者，dispose中移除观察者
3. 重写didChangeAppLifecycleState方法，根据回调状态做处理

代码示例 #

class _AppState extends State<MyApp> with WidgetsBindingObserver {
  AppLifecycleState? _currentState;
  DateTime? _enterBackgroundTime;

  @override
  void initState() {
    super.initState();
    // 注册观察者
    WidgetsBinding.instance.addObserver(this);
  }

  @override
  void dispose() {
    // 移除观察者，避免内存泄漏
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    setState(() => _currentState = state);

    switch (state) {
      case AppLifecycleState.resumed:
        // 应用回到前台
        print("应用处于前台");
        // 可在此恢复数据库操作
        if (_enterBackgroundTime != null) {
          final stayDuration = DateTime.now().difference(_enterBackgroundTime!);
          print("本次后台停留时长: ${stayDuration.inSeconds}秒");
        }
        break;
      case AppLifecycleState.paused:
        // 应用进入后台
        print("应用处于后台");
        _enterBackgroundTime = DateTime.now();
        // 暂停数据库写操作，释放锁
        _closeDatabaseTransactions();
        break;
      case AppLifecycleState.inactive:
        // 应用处于非活动状态（如来电、下拉通知栏）
        print("应用非活动");
        break;
      case AppLifecycleState.detached:
        // 应用即将退出
        print("应用即将退出");
        _closeDatabase();
        break;
      default:
        break;
    }
  }

  // 自定义方法：关闭未完成的数据库事务
  void _closeDatabaseTransactions() {
    // 根据你使用的数据库插件（如sqflite）实现事务关闭逻辑
    // 示例：取消未提交的事务、关闭临时连接
  }

  // 自定义方法：关闭数据库连接
  void _closeDatabase() {
    // 实现数据库连接关闭逻辑
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Text("当前应用状态: ${_currentState?.name ?? '初始化中'}"),
      ),
    );
  }
}

二、解决Database is Locked错误 #

数据库锁死通常是因为应用进入后台后，仍长时间持有数据库写锁，导致后续操作无法获取锁。结合上述状态监听，可通过以下方式避免：

• 后台时暂停写操作：在AppLifecycleState.paused状态下，立即停止所有未完成的数据库写事务、关闭临时连接，主动释放锁。
• 前台时恢复操作：回到resumed状态后，重新初始化数据库连接，恢复正常读写。
• 优化事务逻辑：确保所有数据库事务尽可能简短，避免长时间占用锁；使用批量操作减少锁持有时间。

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