Android WebView网络切换后无法自动重连问题求助

核心问题分析 #

你的代码存在几个关键问题导致网络恢复后WebView不重连：

1. 静态注册非静态内部类Receiver：NetworkChangeReceiver是MainActivity的非静态内部类，静态注册到Manifest中会导致系统无法实例化（非静态内部类依赖外部Activity实例），所以Manifest里的注册完全无效。
2. 广播注册逻辑冲突：你同时做了动态注册和静态注册，且动态注册每次调用startWebview()都会重复注册新的Receiver实例，不仅浪费资源还可能导致逻辑混乱。
3. 重连触发条件限制过严：网络断开时你设置了shouldLoadWebView = false，但网络恢复时这个变量还是false，导致isNetworkAvailable() && shouldLoadWebView条件不成立，无法触发reconnect()。
4. Android版本适配问题：CONNECTIVITY_ACTION广播在Android 7.0（API 24）之后，静态注册无法收到大部分网络变化事件，必须用动态注册或NetworkCallback替代。

修复步骤 #

1. 移除Manifest中的静态Receiver注册 #

直接删掉Manifest里的<receiver>节点，非静态内部类无法静态注册，动态注册更适合Activity生命周期内的网络监听。

2. 修正广播接收逻辑，调整触发条件 #

当网络恢复时，不管shouldLoadWebView当前值是什么，都应该尝试重连；只有网络断开时才显示 fallback 图并标记shouldLoadWebView = false。

3. 规范动态注册与注销流程 #

在Activity的onResume()中注册广播，onPause()中注销，避免重复注册和内存泄漏。

4. 优化网络状态判断 #

确保网络状态判断逻辑准确，处理getActiveNetwork()可能返回null的情况。

修改后的完整代码示例 #

MainActivity核心代码 #

public class MainActivity extends AppCompatActivity {
    private WebView mWebView;
    private String mainPageUrl = "你的网页地址";
    private boolean shouldLoadWebView = false;
    private NetworkChangeReceiver networkReceiver;

    @SuppressLint("SetJavaScriptEnabled")
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        mWebView = findViewById(R.id.webview);
        // 初始化WebView配置（省略你的其他配置）
        startWebview();
    }

    private void startWebview() {
        if (isNetworkAvailable()) {
            shouldLoadWebView = true;
            mWebView.loadUrl(mainPageUrl);
        } else {
            showFallbackImage();
            shouldLoadWebView = false;
        }
    }

    private void reconnect() {
        if (isNetworkAvailable()) {
            shouldLoadWebView = true;
            // 避免重复加载相同URL
            if (!mainPageUrl.equals(mWebView.getUrl())) {
                mWebView.loadUrl(mainPageUrl);
            }
        } else {
            showFallbackImage();
            shouldLoadWebView = false;
        }
    }

    private void showFallbackImage() {
        mWebView.setBackgroundResource(R.drawable.loading);
        mWebView.loadUrl("about:blank");
    }

    // 改为静态内部类，消除外部实例依赖
    public static class NetworkChangeReceiver extends BroadcastReceiver {
        @Override
        public void onReceive(Context context, Intent intent) {
            if (context instanceof MainActivity) {
                MainActivity activity = (MainActivity) context;
                if (activity.isNetworkAvailable()) {
                    activity.reconnect();
                } else {
                    activity.showFallbackImage();
                    activity.shouldLoadWebView = false;
                }
            }
        }
    }

    private boolean isNetworkAvailable() {
        ConnectivityManager connectivityManager = (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE);
        if (connectivityManager == null) {
            return false;
        }
        Network activeNetwork = connectivityManager.getActiveNetwork();
        if (activeNetwork == null) {
            return false;
        }
        NetworkCapabilities capabilities = connectivityManager.getNetworkCapabilities(activeNetwork);
        return capabilities != null &&
                (capabilities.hasTransport(NetworkCapabilities.TRANSPORT_WIFI) ||
                        capabilities.hasTransport(NetworkCapabilities.TRANSPORT_CELLULAR) ||
                        capabilities.hasTransport(NetworkCapabilities.TRANSPORT_ETHERNET));
    }

    @Override
    protected void onResume() {
        super.onResume();
        // 动态注册广播
        networkReceiver = new NetworkChangeReceiver();
        IntentFilter filter = new IntentFilter(ConnectivityManager.CONNECTIVITY_ACTION);
        registerReceiver(networkReceiver, filter);
    }

    @Override
    protected void onPause() {
        super.onPause();
        // 注销广播避免内存泄漏
        if (networkReceiver != null) {
            unregisterReceiver(networkReceiver);
        }
    }
}

替代方案：使用NetworkCallback（Android 7.0+推荐） #

如果应用最低支持API 24及以上，推荐用官方推荐的ConnectivityManager.NetworkCallback替代广播，更可靠：

private ConnectivityManager.NetworkCallback networkCallback;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    
    mWebView = findViewById(R.id.webview);
    startWebview();
    setupNetworkCallback();
}

private void setupNetworkCallback() {
    ConnectivityManager connectivityManager = (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE);
    networkCallback = new ConnectivityManager.NetworkCallback() {
        @Override
        public void onAvailable(Network network) {
            super.onAvailable(network);
            // 网络恢复，主线程操作WebView
            runOnUiThread(() -> reconnect());
        }

        @Override
        public void onLost(Network network) {
            super.onLost(network);
            // 网络断开
            runOnUiThread(() -> {
                showFallbackImage();
                shouldLoadWebView = false;
            });
        }
    };
    connectivityManager.registerDefaultNetworkCallback(networkCallback);
}

@Override
protected void onDestroy() {
    super.onDestroy();
    // 注销回调
    ConnectivityManager connectivityManager = (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE);
    if (networkCallback != null) {
        connectivityManager.unregisterNetworkCallback(networkCallback);
    }
}

额外注意事项 #

• 确保Manifest添加必要权限：<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />和<uses-permission android:name="android.permission.INTERNET" />。
• WebView操作必须在主线程执行，NetworkCallback回调在子线程，需用runOnUiThread包裹。

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