升级Target API至31后谷歌地图SDK抛出Comparison method违反约定异常求助

• 升级Google Maps SDK版本
  com.google.android.gms:play-services-maps:17.0.0是未适配Android 12（API 31）的旧版本，内部排序逻辑不符合Java 7+ TimSort的契约要求。直接升级到最新稳定版（如18.2.0及以上），官方大概率已修复该适配问题。

• 临时兼容方案（无法立即升级时）
  在Application的onCreate方法中添加以下代码，强制JVM使用旧版排序算法规避TimSort的契约检查：

System.setProperty("java.util.Arrays.useLegacyMergeSort", "true");

注意：这只是临时 workaround，长期仍需升级SDK解决根本问题。

• 排查自定义地图逻辑
  即便异常栈指向Google SDK，若存在自定义地图覆盖物、标记排序，或对SDK返回数据做二次排序的逻辑，需检查自定义Comparator是否满足排序契约：

  • 自反性：a.compareTo(a)必须返回0
  • 对称性：若a.compareTo(b) == 0，则b.compareTo(a)也必须为0
  • 传递性：若a.compareTo(b) > 0且b.compareTo(c) > 0，则a.compareTo(c)必须>0

• 核对API 31适配配置
  确保AndroidManifest.xml中配置了Android 12所需的相关权限与配置，比如后台定位权限ACCESS_BACKGROUND_LOCATION（若涉及后台定位场景），配置缺失可能触发SDK内部异常分支。

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