Ionic项目在Android Studio模拟器运行失败：Google Maps插件加载异常

针对你遇到的CapacitorGoogleMapsPlugin无法加载的错误，尝试以下解决方案：

1. 统一Capacitor插件与核心版本 #

你的@capacitor/core和@capacitor/android版本为6.1.2，但@capacitor/google-maps是6.0.1，版本不匹配会导致插件加载异常。执行以下命令统一版本：

npm install @capacitor/google-maps@6.1.2
npx cap sync android

2. 确认Android端插件注册 #

检查Android项目的MainActivity.java文件（路径：android/app/src/main/java/[你的包名]/MainActivity.java），确保插件已正确注册。在onCreate方法中添加注册代码（Capacitor 6+通常自动注册，但手动添加可确保生效）：

import com.capacitorjs.plugins.googlemaps.CapacitorGoogleMapsPlugin;

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    registerPlugin(CapacitorGoogleMapsPlugin.class);
}

3. 彻底清理并重新构建项目 #

执行完整的清理构建流程，避免缓存问题：

# 构建Web项目
npm run build
# 同步到Android
npx cap sync android
# 进入Android目录清理构建缓存
cd android
./gradlew clean
./gradlew assembleDebug

同时在Android Studio中执行File -> Invalidate Caches...，勾选清除文件系统缓存后重启IDE。

4. 移除冲突的旧依赖 #

你的package.json中包含@ionic-native/core和angularfire2这类旧版本依赖，它们与当前Capacitor + Angular 18的环境可能存在冲突。执行以下命令移除：

npm uninstall @ionic-native/core angularfire2

5. 验证Google Maps API配置 #

确保AndroidManifest.xml中已正确配置Google Maps API密钥（路径：android/app/src/main/AndroidManifest.xml）：

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="你的Google Maps API密钥"/>

内容的提问来源于stack exchange，提问作者José Manuel Ruíz Bolaños