Android：切换至ViewPager中MapFragment时EditText错误提示未消失

嘿，这个问题我之前做项目时也碰到过，当时折腾了好一会儿才找到根源，咱们一步步来搞定它：

问题根源分析 #

首先，你已经在onPause()里重置了错误提示，但切换到MapFragment时依然残留，大概率是这两个原因：

1. ViewPager的缓存机制：默认offscreenPageLimit是1，意味着当前页面左右各1个Fragment会被保留。如果你的FormFragment（第4个）和MapFragment（第1个）间隔超过1个页面，切换时FormFragment可能不会触发onPause()，而是直接保留视图状态；
2. SurfaceView层级特性：MapFragment里的MapView是基于SurfaceView实现的，它的绘制在单独的Surface层，优先级比普通View高，但EditText的错误提示是用PopupWindow实现的，PopupWindow的层级可能会盖在SurfaceView之上，导致即使FormFragment不可见，提示依然显示。

针对性解决方案 #

方案1：监听Fragment可见性，主动清除错误提示 #

不管生命周期方法是否触发，只要Fragment变得不可见，就强制清除所有EditText的错误提示，这是最稳妥的方法：

如果用的是旧版ViewPager（ViewPager1），重写setUserVisibleHint()方法：

@Override
public void setUserVisibleHint(boolean isVisibleToUser) {
    super.setUserVisibleHint(isVisibleToUser);
    // 当Fragment不再对用户可见时，清除所有错误提示
    if (!isVisibleToUser && getView() != null) {
        clearAllEditTextErrors();
    }
}

如果用的是ViewPager2，可以通过监听生命周期的ON_STOP事件来处理：

@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
    super.onViewCreated(view, savedInstanceState);
    getViewLifecycleOwner().getLifecycle().addObserver(new DefaultLifecycleObserver() {
        @Override
        public void onStop(@NonNull LifecycleOwner owner) {
            clearAllEditTextErrors();
        }
    });
}

然后实现清除错误的工具方法：

private void clearAllEditTextErrors() {
    // 假设你的表单布局根节点是R.id.form_root_layout
    ViewGroup formRoot = getView().findViewById(R.id.form_root_layout);
    if (formRoot == null) return;
    
    // 递归遍历所有子View，清除EditText的错误提示
    traverseAndClearErrors(formRoot);
}

private void traverseAndClearErrors(ViewGroup parent) {
    int childCount = parent.getChildCount();
    for (int i = 0; i < childCount; i++) {
        View child = parent.getChildAt(i);
        if (child instanceof EditText) {
            ((EditText) child).setError(null);
        } else if (child instanceof ViewGroup) {
            traverseAndClearErrors((ViewGroup) child);
        }
    }
}

方案2：调整MapView的层级（备选） #

如果方案1没解决，可能是PopupWindow的层级确实高于SurfaceView，这时候可以调整MapView的层级让它覆盖PopupWindow：

@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
    super.onViewCreated(view, savedInstanceState);
    mMapView = view.findViewById(R.id.map_view);
    mMapView.getMapAsync(this);
    
    // 设置MapView在最上层显示
    mMapView.setZOrderOnTop(true);
    // 保持地图的透明度和触摸交互
    mMapView.getHolder().setFormat(PixelFormat.TRANSLUCENT);
}

⚠️ 注意：这个方法可能会影响地图的触摸事件响应，所以优先用方案1。

方案3：在视图销毁时彻底清除错误 #

确保FormFragment的视图被销毁时，错误提示也被清除，重写onDestroyView()：

@Override
public void onDestroyView() {
    super.onDestroyView();
    clearAllEditTextErrors();
}

为什么切换到RecyclerView Fragment时正常？ #

因为RecyclerView所在的Fragment用的是普通View，它的视图层级会覆盖在FormFragment的视图之上，EditText的错误提示PopupWindow会被普通View遮挡，所以看起来消失了；而MapFragment的SurfaceView层级特殊，不会遮挡PopupWindow，所以残留下来。

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