GetX多控制器初始化优化：解决移动端广告首点击不展示问题

核心原因 #

问题本质是广告SDK初始化或插屏广告预加载未完成——尽管代码逻辑无错，但应用启动阶段广告资源还处于未就绪状态，快速点击时广告实例尚未准备好，自然无法触发展示。

可行解决方案 #

• 给广告控制器添加就绪状态标识
  在广告控制器中新增一个响应式状态变量，标记广告是否加载完成。点击事件触发前先判断该状态，仅当广告就绪时才执行展示逻辑，同时给用户反馈提示。

  class AdController extends GetxController {
    RxBool isInterstitialReady = false.obs;
    InterstitialAd? _interstitialAd;
  
    @override
    void onInit() {
      super.onInit();
      _preloadInterstitial();
    }
  
    void _preloadInterstitial() {
      InterstitialAd.load(
        adUnitId: '你的广告单元ID',
        request: const AdRequest(),
        adLoadCallback: InterstitialAdLoadCallback(
          onAdLoaded: (ad) {
            _interstitialAd = ad;
            isInterstitialReady.value = true;
            // 监听广告关闭事件，自动预加载下一条
            ad.fullScreenContentCallback = FullScreenContentCallback(
              onAdDismissedFullScreenContent: (ad) {
                ad.dispose();
                _preloadInterstitial();
              },
            );
          },
          onAdFailedToLoad: (error) {
            // 加载失败后延迟重试
            Future.delayed(const Duration(seconds: 3), _preloadInterstitial);
          },
        ),
      );
    }
  
    void showInterstitial() {
      if (isInterstitialReady.value && _interstitialAd != null) {
        _interstitialAd?.show();
        isInterstitialReady.value = false; // 展示后重置状态，等待下一轮加载
      } else {
        Get.snackbar('提示', '广告加载中，请稍后再试');
      }
    }
  }
  

• 调整GetX控制器初始化顺序
  将广告控制器的初始化优先级提前，避免因GetX懒加载特性导致广告启动过晚。在main函数中先初始化广告控制器，再处理其他业务控制器：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    // 优先初始化广告控制器，触发预加载
    Get.put(AdController());
    // 再初始化其他业务控制器
    Get.put(HomeController());
    Get.put(ProfileController());
    // ...其余控制器
    runApp(const MyApp());
  }
  

• 在启动页等待广告加载
  利用启动页（Splash）的停留时间完成广告预加载，等广告就绪或超时后再进入主页面，确保用户操作时广告已准备完毕：

  class SplashScreen extends StatefulWidget {
    const SplashScreen({super.key});
  
    @override
    State<SplashScreen> createState() => _SplashScreenState();
  }
  
  class _SplashScreenState extends State<SplashScreen> {
    @override
    void initState() {
      super.initState();
      _waitAndNavigate();
    }
  
    void _waitAndNavigate() async {
      final adController = Get.find<AdController>();
      // 等待广告就绪，最多等待3秒避免启动页过长
      await Future.wait([
        adController.isInterstitialReady.firstWhere((ready) => ready),
        Future.delayed(const Duration(seconds: 3)),
      ]);
      Get.offAll(const MainScreen());
    }
  
    @override
    Widget build(BuildContext context) {
      return const Scaffold(
        body: Center(child: CircularProgressIndicator()),
      );
    }
  }
  

• 确认广告SDK初始化时机
  确保广告SDK的初始化在WidgetsFlutterBinding.ensureInitialized()之后执行，部分SDK需要绑定完成才能正常初始化，否则会导致预加载延迟：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    // 先初始化广告SDK
    await MobileAds.instance.initialize();
    // 再初始化控制器并启动应用
    Get.put(AdController());
    runApp(const MyApp());
  }
  

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