React Native Android集成Google Mobile Ads时出现“Cannot read property 'BannerAd' of undefined”错误求助

我在新MacBook上给React Native 0.79.1项目配置Google Mobile Ads，当前环境依赖如下：

node -v: v22.15.0
npm -v: 10.9.2
java --version: openjdk 17.0.15 2025-04-15
OpenJDK Runtime Environment Homebrew (build 17.0.15+0)
OpenJDK 64-Bit Server VM Homebrew (build 17.0.15+0, mixed mode, sharing)

已执行步骤 #

• 创建项目：npx @react-native-community/cli init test1
• 安装广告包：npm install react-native-google-mobile-ads（注：原输入未完成，推测为该命令）

兄弟，我来帮你排查这个「Cannot read property 'BannerAd' of undefined」错误！这个问题大多是包没有正确集成、初始化不到位或者链接出了问题，你可以按下面的步骤逐一排查：

1. 先确认包安装是否完整
   先检查安装命令有没有报错，要是之前没执行完，重新跑一遍npm install react-native-google-mobile-ads，然后看看项目根目录的node_modules里有没有react-native-google-mobile-ads这个文件夹，确保安装成功。

2. 检查Android端的配置是否齐全

   • 打开android/app/src/main/AndroidManifest.xml，确认已经添加了AdMob的App ID（替换成你自己的ID）：

     <meta-data
         android:name="com.google.android.gms.ads.APPLICATION_ID"
         android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
     

   • 打开android/build.gradle，检查是否添加了Google服务的classpath：

     buildscript {
         dependencies {
             // 其他依赖项
             classpath 'com.google.gms:google-services:4.4.1'
         }
     }
     

   • 再打开android/app/build.gradle，确保末尾添加了Google服务插件：

     apply plugin: 'com.google.gms.google-services'
     

3. 确认包是否正确链接
   React Native 0.60+支持自动链接，但偶尔会有异常，你可以手动触发一次链接：

   npx react-native link react-native-google-mobile-ads
   

4. 检查初始化代码是否正确
   在App启动的时候必须先初始化广告库，比如在App.js里添加：

   import { MobileAds } from 'react-native-google-mobile-ads';
   
   // 初始化广告服务
   MobileAds.initialize();
   

5. 清理缓存后重新构建
   缓存问题经常导致这类奇怪的错误，执行下面的命令清理后重新运行：

   # 清理Android构建缓存
   cd android && ./gradlew clean
   # 回到项目根目录重新运行Android项目
   cd .. && npx react-native run-android
   

6. 检查导入语句是否正确
   确保你导入BannerAd的方式是官方推荐的：

   import { BannerAd, BannerAdSize } from 'react-native-google-mobile-ads';
   

   别用那种指向内部文件的导入方式，比如import { BannerAd } from 'react-native-google-mobile-ads/src/BannerAd';，这种很容易出问题。

要是上面的步骤都试过还是不行，你可以看看Android Studio的Logcat输出，有没有更详细的报错信息，这会帮你定位更具体的问题~

备注：内容来源于stack exchange，提问作者lsmpascal