iOS 15模拟器按Home键触发didChangePlatformBrightness两次问题求助

云原生阿岚

2026-10-3

根因说明

这是iOS 15及以上版本模拟器的已知系统级bug，和Flutter框架的事件透传逻辑无关：模拟器按下Home键切后台时，会错误上报两次平台亮度变更事件，实际iOS实机不会触发该重复回调，Android端逻辑本身也没有异常。

可行解决思路

方案1：添加防抖逻辑，不损失原有动态适配能力
给didChangePlatformBrightness()的处理逻辑添加300ms防抖，短时间内的重复调用会自动合并，双端都兼容，不需要调整原有业务逻辑，代码示例如下：

import 'dart:async';
import 'package:flutter/material.dart';

Timer? _brightnessChangeTimer;

@override
void didChangePlatformBrightness() {
  super.didChangePlatformBrightness();
  // 合并300ms内的重复触发事件
  _brightnessChangeTimer?.cancel();
  _brightnessChangeTimer = Timer(const Duration(milliseconds: 300), () {
    // 此处放置原有的亮度变化处理逻辑
    final currentBrightness = WidgetsBinding.instance.platformDispatcher.platformBrightness;
    // 你的业务代码
  });
}

@override
void dispose() {
  _brightnessChangeTimer?.cancel();
  super.dispose();
}

方案2：仅保留启动时亮度检测，移除运行时监听
如果你的业务不需要动态跟随系统亮度变化，直接取消全局WidgetsBindingObserver的亮度回调监听即可，只在应用启动初始化阶段读取一次platformBrightness值存入全局变量使用，完全规避该问题，双端适配无额外开销。
方案3：iOS端单独过滤后台无效回调
可以结合应用生命周期状态做过滤：当系统为iOS且版本≥15时，仅处理应用处于前台状态时的亮度变更回调，自动忽略切后台时触发的无效事件，不影响实机正常的亮度调整响应。