PagerFragment中Google Map无法显示问题求助

嘿，我之前也碰到过Fragment里Google Map显示空白的情况，结合你提到的文件清单，大概率是这几个细节没处理到位，咱们一步步排查：

1. Manifest配置检查 #

首先确认Manifest里的关键配置有没有漏：

• 必须添加的权限：

  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- 如果需要定位功能 -->
  

• 地图所需的OpenGL特性声明：

  <uses-feature android:glEsVersion="0x00020000" android:required="true" />
  

• API密钥的元数据必须放在<application>标签内部，不能放在外面：

  <application ...>
      <meta-data
          android:name="com.google.android.geo.API_KEY"
          android:value="@string/google_maps_key" />
      <!-- 其他组件配置 -->
  </application>
  

2. SecondFragment的地图初始化逻辑 #

Fragment中嵌套MapFragment必须用SupportMapFragment，而且获取方式要注意：

• 在fragment_second.xml里，确保地图控件是Support版本：

  <fragment
      android:id="@+id/map"
      android:name="com.google.android.gms.maps.SupportMapFragment"
      android:layout_width="match_parent"
      android:layout_height="match_parent" />
  

• 在SecondFragment.java中，必须用getChildFragmentManager()获取嵌套的MapFragment，不能用getFragmentManager()：

  public class SecondFragment extends Fragment implements OnMapReadyCallback {
      private GoogleMap mMap;
  
      @Override
      public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
          View root = inflater.inflate(R.layout.fragment_second, container, false);
          // 注意这里用getChildFragmentManager，适配嵌套Fragment场景
          SupportMapFragment mapFragment = (SupportMapFragment) getChildFragmentManager().findFragmentById(R.id.map);
          mapFragment.getMapAsync(this);
          return root;
      }
  
      @Override
      public void onMapReady(GoogleMap googleMap) {
          mMap = googleMap;
          // 可以加个Log确认这个方法是否被执行，排查是否初始化失败
          Log.d("MapDebug", "地图已成功加载");
          // 添加标记的示例代码
          LatLng testPoint = new LatLng(39.9042, 116.4074);
          mMap.addMarker(new MarkerOptions().position(testPoint).title("测试标记"));
          mMap.moveCamera(CameraUpdateFactory.newLatLngZoom(testPoint, 12));
      }
  }
  

  另外要确保Fragment实现了OnMapReadyCallback接口，否则getMapAsync()不会触发回调。

3. API密钥与Google Cloud配置 #

这是最容易踩坑的点：

• 登录Google Cloud控制台，确认Maps SDK for Android服务已启用（很多人创建密钥后忘记启用服务，直接导致地图空白）。
• 检查密钥的限制是否正确：如果设置了包名和SHA-1指纹，一定要和你当前测试的应用完全匹配。可以先临时取消密钥的限制（设置为“无限制”），如果地图能显示了，就说明是限制配置的问题。

4. 布局与依赖检查 #

• fragment_second.xml里的地图控件宽高必须设为match_parent，如果是wrap_content可能导致地图无法渲染。
• 检查有没有其他布局控件覆盖在地图上方，比如透明的View或者LinearLayout，导致看不到地图。
• 确认build.gradle(Module)里添加了正确的Maps依赖：

  dependencies {
      implementation 'com.google.android.gms:play-services-maps:18.1.0' // 建议用最新稳定版
  }
  

  同时项目级build.gradle里要包含Google Maven仓库：

  repositories {
      google()
  }
  

5. 权限检查（针对Android 6.0+） #

如果你的应用目标SDK是23以上，需要动态申请位置权限，虽然这不会直接导致地图空白，但如果需要显示当前位置的标记，权限缺失会导致标记不显示。可以先测试不依赖位置的标记是否能显示，再处理权限问题。

按照上面的步骤逐一排查，应该就能解决空白的问题啦！

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