如何在Android MapsFragment中实现点击地图隐藏UI并解决空指针问题

• 运行时崩溃触发点：在onCreateView生命周期阶段直接调用mMap.setOnMapClickListener()，此时mMap是由Google Map SDK通过OnMapReadyCallback异步初始化的实例，在该阶段还未完成赋值，自然触发空引用异常
• 此前尝试将点击监听移入onMapReady却无法引用UI控件的原因：原代码中mConstraintLayout、maptype_fab都是onCreateView方法内部声明的局部变量，作用域仅局限于该方法内部，当onMapReady异步回调触发时，局部变量已经超出作用域，无法被正常访问

1. 调整变量作用域：将原本在onCreateView内部声明的所有需要跨回调访问的UI控件，从方法局部变量提升为Fragment的成员变量，保证整个Fragment生命周期内都可以正常访问这些UI引用
2. 调整逻辑执行时机：将所有依赖mMap实例的操作（包括设置地图类型、绑定地图点击监听、判断当前地图模式）全部移入onMapReady回调内部执行，彻底规避空指针问题
3. 优化交互逻辑：在地图点击关闭选择器的逻辑中增加状态判断，仅当MapType选择器处于可见状态时，才执行关闭操作，减少无意义的UI刷新

public class MapsFragment extends Fragment {
    private GoogleMap mMap;
    // 全局可访问的UI成员变量
    private ConstraintLayout mConstraintLayout;
    private FloatingActionButton maptype_fab;
    private View map_def_back, map_sat_back, map_ter_back;
    private TextView map_text_def, map_text_sat, map_text_ter;
    private static final String TAG = "MapsFragment";

    private OnMapReadyCallback callback = new OnMapReadyCallback() {
        @Override
        public void onMapReady(GoogleMap googleMap) {
            // 地图实例完成初始化，完成赋值
            mMap = googleMap;
            LatLng sydney = new LatLng(-34, 151);
            mMap.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
            mMap.moveCamera(CameraUpdateFactory.newLatLng(sydney));
            mMap.setMapType(GoogleMap.MAP_TYPE_SATELLITE);

            // 此时mMap已完成初始化，设置监听不会触发空指针
            mMap.setOnMapClickListener(latLng -> {
                if (mConstraintLayout.getVisibility() == View.VISIBLE) {
                    mConstraintLayout.setVisibility(View.INVISIBLE);
                    maptype_fab.setVisibility(View.VISIBLE);
                }
            });

            // 依赖mMap实例的FAB点击逻辑也在此时绑定
            maptype_fab.setOnClickListener(v -> {
                mConstraintLayout.setVisibility(View.VISIBLE);
                maptype_fab.setVisibility(View.INVISIBLE);
                if (mMap.getMapType() == GoogleMap.MAP_TYPE_NORMAL) {
                    map_def_back.setVisibility(View.VISIBLE);
                    map_text_def.setTextColor(Color.BLUE);
                    Log.d(TAG, "maptype: normal ");
                } else if (mMap.getMapType() == GoogleMap.MAP_TYPE_HYBRID) {
                    map_sat_back.setVisibility(View.VISIBLE);
                    map_text_sat.setTextColor(Color.BLUE);
                    Log.d(TAG, "maptype: satellite ");
                } else {
                    map_ter_back.setVisibility(View.VISIBLE);
                    map_text_ter.setTextColor(Color.BLUE);
                    Log.d(TAG, "maptype: terrain ");
                }
            });
        }
    };

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater,
                             @Nullable ViewGroup container,
                             @Nullable Bundle savedInstanceState) {
        View view = inflater.inflate(R.layout.fragment_maps, container, false);
        // 仅做UI控件绑定，不执行依赖未初始化实例的逻辑
        mConstraintLayout = view.findViewById(R.id.map_type_selection);
        maptype_fab = view.findViewById(R.id.map_type_FAB);
        map_def_back = view.findViewById(R.id.map_def_back);
        map_sat_back = view.findViewById(R.id.map_sat_back);
        map_ter_back = view.findViewById(R.id.map_ter_back);
        map_text_def = view.findViewById(R.id.map_text_def);
        map_text_sat = view.findViewById(R.id.map_text_sat);
        map_text_ter = view.findViewById(R.id.map_text_ter);
        return view;
    }

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        SupportMapFragment mapFragment =
                (SupportMapFragment) getChildFragmentManager().findFragmentById(R.id.map);
        if (mapFragment != null) {
            mapFragment.getMapAsync(callback);
        }
    }
}

• Google Map SDK的实例初始化是完全异步的，所有涉及mMap的方法调用，必须在onMapReady回调触发后执行，该回调是SDK保证地图实例可正常使用的唯一时机
• 跨异步回调需要访问的UI控件，必须声明为Fragment的成员变量，不可使用方法内部的局部变量，否则回调触发时局部变量已被回收，会出现空引用或无法访问的问题
• onCreateView阶段仅负责完成视图绑定、基础静态UI初始化，不要在该阶段执行任何依赖异步初始化实例的操作

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