调用Google Maps搜索地址时抛出NoSuchMethodError问题排查求助

你遇到的NoSuchMethodError90%以上概率是应用本身的依赖配置问题，而非Google Maps API本身的缺陷。

NoSuchMethodError属于程序运行时错误，本质是代码编译阶段能找到对应方法，但运行时加载的类版本中不存在该方法，针对集成Google Maps、地址搜索的场景，常见诱因如下：

• 多Google服务组件版本不一致：项目同时引入的Google Maps、Places、Location等多个Google Play服务组件版本号不匹配，不同版本的底层依赖类方法签名存在差异，运行时加载到了不兼容的类版本
• 混淆配置错误：ProGuard/R8等混淆工具裁剪代码时，误删除了Google Places/Maps相关类的方法，导致运行时找不到对应实现
• 依赖传递冲突：项目中其他第三方库间接引入了和你显式声明版本不一致的Google Maps/Places依赖，覆盖了预期版本，导致方法不兼容
• 用户设备Google Play服务版本过低：用户设备上安装的Google Play服务版本远低于应用编译时依赖的版本，旧版服务中没有对应方法实现

可以按以下顺序排查解决：

• 统一所有Google Play服务依赖版本：项目中所有Google官方服务相关依赖的版本号必须完全一致，例如你使用com.google.android.gms:play-services-maps:18.2.0，同项目的play-services-places、play-services-location等组件也必须使用18.2.0版本
• 补充官方混淆规则：在混淆配置文件中添加Google Maps/Places指定的保留规则，避免方法被误裁剪：

-keep class com.google.android.gms.maps.** { *; }
-keep interface com.google.android.gms.maps.** { *; }
-keep class com.google.android.libraries.places.** { *; }
-keep interface com.google.android.libraries.places.** { *; }

• 强制锁定依赖版本：在项目构建配置中添加依赖强制指定规则，避免传递依赖覆盖预期版本，以Gradle为例：

configurations.all {
    resolutionStrategy.force "com.google.android.gms:play-services-maps:18.2.0"
    resolutionStrategy.force "com.google.android.libraries.places:places:3.0.0"
}

• 添加端侧版本兼容逻辑：代码运行前先校验用户设备上的Google Play服务版本，当版本低于应用依赖的最低版本时，引导用户升级Google Play服务。

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