本文详解如何基于现有错误码体系，在 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 中声明权限
Java注释规范Skills下载当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
<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 最佳实践的离线提示能力——既延续了原有架构风格，又填补了关键用户体验空白。
