Pixel4 API30模拟器运行谷歌地图Demo偶现两类运行时错误如何解决

架构老林

2026-10-6

谷歌地图Demo Pixel 4 API 30模拟器偶发故障排查

故障背景

在Pixel 4 API 30模拟器上运行基础谷歌地图Demo时出现偶现故障：有时运行正常，有时抛出两类错误。已参考官方指南配置API密钥，未直接将密钥存放在基础代码自带的google_maps_api.xml文件中。

相关配置文件

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.joe.googlemapsdemo">

    <!--
         The ACCESS_COARSE/FINE_LOCATION permissions are not required to use
         Google Maps Android API v2, but you must specify either coarse or fine
         location permissions for the "MyLocation" functionality.
    -->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.GoogleMapsDemo">

        <!--
             The API key for Google Maps-based APIs is defined as a string resource.
             (See the file "res/values/google_maps_api.xml").
             Note that the API key is linked to the encryption key used to sign the APK.
             You need a different API key for each encryption key, including the release key that is used to
             sign the APK for publishing.
             You can define the keys for the debug and release targets in src/debug/ and src/release/.
        -->
        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="${MAPS_API_KEY}" />

        <activity
            android:name=".MapsActivity"
            android:exported="true"
            android:label="@string/title_activity_maps">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

activity_maps.xml

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/map"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MapsActivity" />

MapsActivity.kt

package com.joe.googlemapsdemo

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle

import com.google.android.gms.maps.CameraUpdateFactory
import com.google.android.gms.maps.GoogleMap
import com.google.android.gms.maps.OnMapReadyCallback
import com.google.android.gms.maps.SupportMapFragment
import com.google.android.gms.maps.model.LatLng
import com.google.android.gms.maps.model.MarkerOptions
import com.joe.googlemapsdemo.databinding.ActivityMapsBinding

class MapsActivity : AppCompatActivity(), OnMapReadyCallback {

    private lateinit var mMap: GoogleMap
    private lateinit var binding: ActivityMapsBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        binding = ActivityMapsBinding.inflate(layoutInflater)
        setContentView(binding.root)

        // Obtain the SupportMapFragment and get notified when the map is ready to be used.
        val mapFragment = supportFragmentManager
            .findFragmentById(R.id.map) as SupportMapFragment
        mapFragment.getMapAsync(this)
    }

    /**
     * Manipulates the map once available.
     * This callback is triggered when the map is ready to be used.
     * This is where we can add markers or lines, add listeners or move the camera. In this case,
     * we just add a marker near Sydney, Australia.
     * If Google Play services is not installed on the device, the user will be prompted to install
     * it inside the SupportMapFragment. This method will only be triggered once the user has
     * installed Google Play services and returned to the app.
     */
    override fun onMapReady(googleMap: GoogleMap) {
        mMap = googleMap

        // Add a marker in Sydney and move the camera
        val osaka = LatLng(34.677518,135.3459511)
        mMap.addMarker(MarkerOptions().position(osaka).title("Marker in Osaka"))
        mMap.moveCamera(CameraUpdateFactory.newLatLng(osaka))
    }
}

错误信息

错误1

E/AndroidRuntime: FATAL EXCEPTION: main
    Process: com.joe.googlemapsdemo, PID: 10408
    java.lang.RuntimeException: Unable to start activity ComponentInfo{com.joe.googlemapsdemo/com.joe.googlemapsdemo.MapsActivity}: android.view.InflateException: Binary XML file line #9 in com.joe.googlemapsdemo:layout/activity_maps: Binary XML file line #9 in com.joe.googlemapsdemo:layout/activity_maps: Error inflating class fragment
        at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:3449)
        at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:3601)
        at android.app.servertransaction.LaunchActivityItem.execute(LaunchActivityItem.java:85)
        at android.app.servertransaction.TransactionExecutor.executeCallbacks(TransactionExecutor.java:135)
        at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:95)
        at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2066)
        at android.os.Handler.dispatchMessage(Handler.java:106)
        at android.os.Looper.loop(Looper.java:223)
        at android.app.ActivityThread.main(ActivityThread.java:7656)
        at java.lang.reflect.Method.invoke(Native Method)
        at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:592)
        at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:947)
     Caused by: android.view.InflateException: Binary XML file line #9 in com.joe.googlemapsdemo:layout/activity_maps: Binary XML file line #9 in com.joe.googlemapsdemo:layout/activity_maps: Error inflating class fragment
     Caused by: android.view.InflateException: Binary XML file line #9 in com.joe.googlemapsdemo:layout/activity_maps: Error inflating class fragment
     Caused by: android.content.res.Resources$NotFoundException: Resource ID #0x7f070016 type #0x3 is not valid
        at android.content.res.Resources.getDimensionPixelSize(Resources.java:827)
        at com.google.maps.api.android.lib6.impl.ax.d(:com.google.android.gms.dynamite_mapsdynamite@213016100@21.30.16 (150700-0):5)
        at com.google.maps.api.android.lib6.impl.fh.<init>(:com.google.android.gms.dynamite_mapsdynamite@213016100@21.30.16 (150700-0):6)
        at com.google.maps.api.android.lib6.impl.bo.az(:com.google.android.gms.dynamite_mapsdynamite@213016100@21.30.16 (150700-0):16)
        at com.google.maps.api.android.lib6.impl.cr.o(:com.google.android.gms.dynamite_mapsdynamite@213016100@21.30.16 (150700-0):2)
        at com.google.android.gms.maps.internal.o.aX(:com.google.android.gms.dynamite_mapsdynamite@213016100@21.30.16 (150700-0):22)
        at dx.onTransact(:com.google.android.gms.dynamite_mapsdynamite@213016100@21.30.16 (150700-0):4)
        at android.os.Binder.transact(Binder.java:1043)
        at com.google.android.gms.internal.maps.zza.zza(Unknown Source:10)
        at com.google.android.gms.maps.internal.zzj.onCreateView(Unknown Source:29)
        at com.google.android.gms.maps.SupportMapFragment$zza.onCreateView(Unknown Source:29)
        at com.google.android.gms.dynamic.zad.zaa(Unknown Source:4)
        at com.google.android.gms.dynamic.DeferredLifecycleHelper.zaa(Unknown Source:9)
        at com.google.android.gms.dynamic.DeferredLifecycleHelper.onCreateView(Unknown Source:25)
        at com.google.android.gms.maps.SupportMapFragment.onCreateView(Unknown Source:28)
        at androidx.fragment.app.Fragment.performCreateView(Fragment.java:2963)
        at androidx.fragment.app.FragmentStateManager.ensureInflatedView(FragmentStateManager.java:386)
        at androidx.fragment.app.FragmentStateManager.moveToExpectedState(FragmentStateManager.java:281)
        at androidx.fragment.app.FragmentLayoutInflaterFactory.onCreateView(FragmentLayoutInflaterFactory.java:140)
        at androidx.fragment.app.FragmentController.onCreateView(FragmentController.java:135)
        at androidx.fragment.app.FragmentActivity.dispatchFragmentsOnCreateView(FragmentActivity.java:319)
        at androidx.fragment.app.FragmentActivity.onCreateView(FragmentActivity.java:298)
        at android.view.LayoutInflater.tryCreateView(LayoutInflater.java:1067)
        at android.view.LayoutInflater.createViewFromTag(LayoutInflater.java:995)
        at android.view.LayoutInflater.createViewFromTag(LayoutInflater.java:959)
        at android.view.LayoutInflater.inflate(LayoutInflater.java:657)
        at android.view.LayoutInflater.inflate(LayoutInflater.java:532)
        at com.joe.googlemapsdemo.databinding.ActivityMapsBinding.inflate(ActivityMapsBinding.java:36)
        at com.joe.googlemapsdemo.databinding.ActivityMapsBinding.inflate(ActivityMapsBinding.java:30)
        at com.joe.googlemapsdemo.MapsActivity.onCreate(MapsActivity.kt:22)
        at android.app.Activity.performCreate(Activity.java:8000)
        at android.app.Activity.performCreate(Activity.java:7984)
        at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1309)
        at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:3422)
        at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:3601)
        at android.app.servertransaction.LaunchActivityItem.execute(LaunchActivityItem.java:85)
        at android.app.servertransaction.TransactionExecutor.executeCallbacks(TransactionExecutor.java:135)
        at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:95)
        at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2066)
        at android.os.Handler.dispatchMessage(Handler.java:106)
        at android.os.Looper.loop(Looper.java:223)
        at android.app.ActivityThread.main(ActivityThread.java:7656)
        at java.lang.reflect.Method.invoke(Native Method)
        at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:592)
        at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:947)

错误2

E/AndroidRuntime: FATAL EXCEPTION: GLThread 688 
Process: com.joe.googlemapsdemo, PID: 8853 
java.lang.NullPointerException: Attempt to invoke virtual method 'int android.graphics.Bitmap.getWidth()' on a null object reference 
at com.google.maps.api.android.lib6.gmm6.vector.gl.aj.a(:com.google.android.gms.dynamite_mapsdynamite@201817052@20.18.17 (040700-0):11) 
at com.google.maps.api.android.lib6.gmm6.vector.gl.aj.<init>(:com.google.android.gms.dynamite_mapsdynamite@201817052@20.18.17 (040700-0):3) 
at com.google.maps.api.android.lib6.gmm6.vector.gl.g.<init>(:com.google.android.gms.dynamite_mapsdynamite@201817052@20.18.17 (040700-0):23) 
at com.google.maps.api.android.lib6.gmm6.vector.bt.b(:com.google.android.gms.dynamite_mapsdynamite@201817052@20.18.17 (040700-0):20) 
at com.google.maps.api.android.lib6.gmm6.vector.av.run(:com.google.android.gms.dynamite_mapsdynamite@201817052@20.18.17 (040700-0):56)

故障原因

上述两个偶发报错均和业务代码、API密钥配置无关，是API 30版本模拟器自带的Google Play Services兼容问题导致：

Resources$NotFoundException报错是地图SDK加载模拟器内置的动态maps模块时，无法读取模拟器缓存的资源文件，属于Google Play Services后台更新后缓存异常
GL线程空指针报错是模拟器OpenGL图形加速缓存失效，地图组件加载基础纹理位图失败，属于模拟器图形渲染配置不稳定

解决方案

升级模拟器内置的Google Play Services到最新版本：打开模拟器内置的Play商店，搜索Google Play Services，完成更新后重启模拟器即可
调整模拟器图形渲染配置：打开AVD管理器，编辑对应Pixel 4模拟器，找到「模拟性能」分类下的「图形」选项，将默认的Automatic切换为Software - GLES 2.0，仍有偶发问题可尝试切换为Hardware - GLES 2.0
固定谷歌地图SDK版本：在模块级build.gradle依赖配置中，将谷歌地图SDK指定为稳定正式版本，避免使用动态版本号，参考配置如下：

dependencies {
    // 其他依赖
    implementation 'com.google.android.gms:play-services-maps:18.1.0'
}

若以上方案均未解决，可更换API 31及以上版本的模拟器测试，API 30版本模拟器的谷歌服务模块本身存在较多已知偶发兼容问题

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

Pixel4 API30模拟器运行谷歌地图Demo偶现两类运行时错误如何解决

故障背景 #

相关配置文件 #

AndroidManifest.xml #

activity_maps.xml #

MapsActivity.kt #

错误信息 #

错误1 #

错误2 #

故障原因 #

解决方案 #