Android无网络提示框实现教程

本文深入解析了在Android Java老项目中如何优雅实现“无网络”错误提示对话框，重点纠正了常见误判网络状态的陷阱（如错误使用ConnectivityManager常量），提出将网络检测逻辑下沉至ApiCallBack.onFailure()中精准识别真实断网场景，并主动触发统一错误码NO_NETWORK_ERROR，从而与现有错误处理体系无缝集成；同时指导UI层通过专用轻量级AlertDialog提供用户可操作的重试或跳转设置选项，并强调权限声明、API兼容性适配、日志分级等关键实践，帮助开发者以低侵入方式显著提升离线场景下的用户体验与代码健壮性。

本文详解如何基于现有错误码体系，在 Android Java 项目中优雅集成「无移动数据与 Wi-Fi」场景的提示对话框，涵盖状态码识别、网络检测逻辑、UI 响应联动及最佳实践。

本文详解如何基于现有错误码体系，在 Android Java 项目中优雅集成「无移动数据与 Wi-Fi」场景的提示对话框，涵盖状态码识别、网络检测逻辑、UI 响应联动及最佳实践。

在 Android 老项目中扩展网络异常提示能力，关键不在于“新建一个 Dialog”，而在于精准识别网络不可用状态，并将其与已有的错误处理流程无缝对齐。你已定义 NO_NETWORK_ERROR = 3，且 ApiCallBack 的 onFailure() 中尚未覆盖该场景——这是核心缺口。

✅ 正确做法：在 onFailure() 中主动检测网络并触发对应错误码

你提供的答案中直接在 loginStatusInfo.observe() 里用 ConnectivityManager.TYPE_MOBILE == 0 判断网络，这是错误的：TYPE_MOBILE 是常量（值为 0），并非实时状态，该判断恒为 true，会导致误弹窗。

正确路径是：在 ApiCallBack.onFailure() 中检测真实网络连通性，并主动调用 onError() 抛出 NO_NETWORK_ERROR。这样既复用统一错误分发机制，又保证逻辑内聚。

? 步骤一：增强 ApiCallBack.onFailure() 的网络感知能力

@Override
public void onFailure(Call<ApiResponse<T>> call, Throwable t) {
    if (t instanceof IOException || t instanceof UnknownHostException) {
        // 关键：检测当前是否真的无网络
        if (!isNetworkAvailable()) {
            if (getLogControlManager().isLog()) {
                Log.w(PARABIT_SDK_LOG, "No network detected → triggering NO_NETWORK_ERROR");
            }
            onError(new ApiErrorCodeInfo(StatusCodeUtil.NO_NETWORK_ERROR, 
                "No internet connection available"));
            return; // 阻止后续默认错误处理
        }
    }

    // 其他非网络类异常走原有逻辑
    if (t instanceof UnknownHostException) {
        onError(new ApiErrorCodeInfo(StatusCodeUtil.URL_INVALID, t.getLocalizedMessage()));
    } else {
        onError(new ApiErrorCodeInfo(StatusCodeUtil.INTERNAL_SERVER_ERROR, 
            t.getLocalizedMessage()));
    }
}

// 工具方法：安全检测网络（兼容 API < 23）
private boolean isNetworkAvailable() {
    ConnectivityManager cm = (ConnectivityManager) 
        application.getSystemService(Context.CONNECTIVITY_SERVICE);
    if (cm == null) return false;

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        NetworkCapabilities capabilities = cm.getNetworkCapabilities(cm.getActiveNetwork());
        return capabilities != null &&
               capabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET) &&
               capabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_VALIDATED);
    } else {
        NetworkInfo activeNetwork = cm.getActiveNetworkInfo();
        return activeNetwork != null && activeNetwork.isConnected();
    }
}

⚠️ 注意：需在 AndroidManifest.xml 中声明权限

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

✅ 步骤二：确保 UI 层正确响应 NO_NETWORK_ERROR

你已在 loginStatusInfo.observe() 中添加了 NO_NETWORK_ERROR 分支，这是正确的——但请务必使用 networkErrorDialog() 而非 loginErrorDialog()（如答案所示），以区分语义：

else if (loginStatusInfo.getStatus() == StatusCodeUtil.NO_NETWORK_ERROR) {
    hideLoadingDialog();
    networkErrorDialog(getString(R.string.network_require_msg)); // 专用 Dialog
}

同时，建议 networkErrorDialog() 实现为轻量级 AlertDialog，避免依赖复杂布局：

private void networkErrorDialog(String message) {
    new AlertDialog.Builder(this)
        .setTitle("Network Unavailable")
        .setMessage(message)
        .setPositiveButton("Retry", (d, w) -> {
            // 重试逻辑，例如重新触发登录请求
            loginViewModel.login();
        })
        .setNegativeButton("Settings", (d, w) -> {
            // 跳转系统网络设置
            startActivity(new Intent(Settings.ACTION_WIFI_SETTINGS));
        })
        .show();
}

? 总结与最佳实践

• 不要在 UI 层重复检测网络：将网络状态判断下沉至 ApiCallBack，保持业务逻辑与 UI 解耦；
• 避免硬编码常量比较：使用 StatusCodeUtil.NO_NETWORK_ERROR 而非字面量 3，提升可维护性；
• 区分错误类型语义：NO_NETWORK_ERROR 应导向用户可操作的提示（如跳转设置），而非泛化错误页；
• 兼容性兜底：isNetworkAvailable() 必须适配低版本 API，getActiveNetworkInfo() 在 Android 10+ 已废弃，高版本需用 NetworkCapabilities；
• 日志分级：网络不可用属于预期场景，建议用 Log.w() 而非 Log.e()，便于后期监控过滤。

通过以上改造，你的老项目便拥有了健壮、可维护、符合 Android 最佳实践的离线提示能力——既延续了原有架构风格，又填补了关键用户体验空白。

今天关于《Android无网络提示框实现教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！