CardView内嵌MapView无法自动加载，需多次点击才显示完整地图求助

你遇到的核心问题是没有正确处理MapView的生命周期，同时RecyclerView的复用机制和全局mMap变量导致地图加载异常：

• 在onBindViewHolder中直接调用mp.onCreate(null)不符合MapView的生命周期规范，MapView的生命周期方法必须和它所在的Activity/Fragment同步。
• 全局的mMap会被多个ViewHolder覆盖，导致只有最后一个绑定的MapView能正确获取地图实例。
• 未处理ViewHolder复用时MapView的状态恢复，导致未点击的卡片地图无法初始化。

下面是修复后的完整步骤和代码：

1. 修改ViewHolder，持有独立的MapView和GoogleMap实例 #

每个ViewHolder维护自己的MapView和对应GoogleMap，避免全局变量冲突：

public class ViewHolder extends RecyclerView.ViewHolder {
    TextView itemTitle, itemDetail;
    ImageView itemImage;
    MapView mapView;
    GoogleMap googleMap;

    public ViewHolder(View itemView) {
        super(itemView);
        itemTitle = itemView.findViewById(R.id.item_title);
        itemDetail = itemView.findViewById(R.id.item_detail);
        itemImage = itemView.findViewById(R.id.item_image);
        mapView = itemView.findViewById(R.id.mapView);
        
        // 初始化MapView，传入空Bundle（需恢复状态可传入对应数据）
        mapView.onCreate(new Bundle());
        mapView.getMapAsync(new OnMapReadyCallback() {
            @Override
            public void onMapReady(GoogleMap map) {
                googleMap = map;
                googleMap.getUiSettings().setZoomControlsEnabled(false);
                // 先设置默认配置，具体位置在onBindViewHolder中更新
            }
        });
    }

    // 更新地图位置的方法
    public void updateMapLocation(double lat, double lng, String markerTitle) {
        if (googleMap != null) {
            LatLng location = new LatLng(lat, lng);
            googleMap.clear(); // 清除复用残留的标记
            googleMap.addMarker(new MarkerOptions().position(location).title(markerTitle));
            googleMap.animateCamera(CameraUpdateFactory.newLatLngZoom(location, 13.0f));
        }
    }

    // MapView生命周期方法，供宿主组件调用
    public void onResume() {
        if (mapView != null) {
            mapView.onResume();
        }
    }

    public void onPause() {
        if (mapView != null) {
            mapView.onPause();
        }
    }

    public void onDestroy() {
        if (mapView != null) {
            mapView.onDestroy();
        }
    }
}

2. 修改RecyclerAdapter的绑定逻辑 #

移除onBindViewHolder中错误的生命周期调用，改用ViewHolder提供的方法更新地图：

@Override
public ViewHolder onCreateViewHolder(ViewGroup viewGroup, int i) {
    View v = LayoutInflater.from(viewGroup.getContext())
            .inflate(R.layout.card_layout, viewGroup, false);
    return new ViewHolder(v);
}

@Override
public void onBindViewHolder(ViewHolder viewHolder, int i) {
    viewHolder.itemTitle.setText(titles[i]);
    viewHolder.itemDetail.setText(details[i]);
    viewHolder.itemImage.setImageResource(images[i]);
    
    // 替换为你的实际位置数据，这里用示例固定值
    double lat = Double.parseDouble("1.344376");
    double lng = Double.parseDouble("103.862162");
    viewHolder.updateMapLocation(lat, lng, "Marker on board");
    
    // 触发地图重绘
    viewHolder.mapView.postInvalidate();
}

// 重写回收方法，处理MapView销毁，避免内存泄漏
@Override
public void onViewRecycled(ViewHolder holder) {
    super.onViewRecycled(holder);
    holder.onDestroy();
}

3. 同步MapView与宿主的生命周期 #

在你的Activity/Fragment中，遍历RecyclerView的可见ViewHolder，调用对应的MapView生命周期方法：

// Activity的onResume方法
@Override
protected void onResume() {
    super.onResume();
    for (int i = 0; i < recyclerView.getChildCount(); i++) {
        RecyclerAdapter.ViewHolder holder = (RecyclerAdapter.ViewHolder) recyclerView.getChildViewHolder(recyclerView.getChildAt(i));
        holder.onResume();
    }
}

// Activity的onPause方法
@Override
protected void onPause() {
    super.onPause();
    for (int i = 0; i < recyclerView.getChildCount(); i++) {
        RecyclerAdapter.ViewHolder holder = (RecyclerAdapter.ViewHolder) recyclerView.getChildViewHolder(recyclerView.getChildAt(i));
        holder.onPause();
    }
}

• 如果位置数据是动态的，可在updateMapLocation中添加判重逻辑，避免不必要的地图更新。
• 确保MapView的android:visibility="visible"，避免因视图不可见导致的加载延迟。
• 检查Manifest中Google Maps API密钥和权限是否配置正确。

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