当前位置：首页 > 行业动态 > 正文

Android网络请求超时如何处理？

admin
行业动态
2025-03-05
2

在Android中处理网络请求超时，可在 HttpURLConnection或第三方库如OkHttp、Retrofit中设置超时时间，并添加异常处理逻辑。

Android网络请求超时处理

一、

在Android开发中，网络请求超时是一个常见的问题，当网络不稳定或服务器响应慢时，可能会导致应用出现卡顿甚至崩溃的情况，为了提升用户体验，合理地处理网络请求超时至关重要。

二、设置超时

在Android中，通常使用OkHttp库进行网络请求，可以通过设置连接超时、读取超时和写入超时时间来避免网络请求长时间挂起，以下是一个示例代码，展示如何设置超时：

import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.util.concurrent.TimeUnit;
public class NetworkUtils {
    private static final int TIMEOUT_SECONDS = 10;
    private static OkHttpClient client;
    static {
        client = new OkHttpClient.Builder()
            .connectTimeout(TIMEOUT_SECONDS, TimeUnit.SECONDS)
            .readTimeout(TIMEOUT_SECONDS, TimeUnit.SECONDS)
            .writeTimeout(TIMEOUT_SECONDS, TimeUnit.SECONDS)
            .build();
    }
    public static void makeRequest(String url) {
        Request request = new Request.Builder()
            .url(url)
            .build();
        try {
            Response response = client.newCall(request).execute();
            if (response.isSuccessful()) {
                System.out.println("Response: " + response.body().string());
            } else {
                System.out.println("Request failed with code: " + response.code());
            }
        } catch (IOException e) {
            System.out.println("Request failed: " + e.getMessage());
        }
    }
}

在上述代码中，我们创建了一个OkHttpClient实例，并设置了连接、读取和写入的超时时间，这样，当请求超时时，将会抛出异常，我们可以在catch块中进行处理。

三、处理网络请求的完整流程

为了更好地展示请求超时的处理机制，我们可以用序列图来描述整个流程：

sequenceDiagram

participant User

participant App

participant HttpClient

participant Server

User->>App: 发起请求

App->>HttpClient: 创建请求

HttpClient->>Server: 发送请求

Server–>>HttpClient: 响应超时

HttpClient->>App: 返回超时异常

App->>User: 提示网络错误

在这个图中，用户发起请求，应用程序通过HttpClient发送请求到服务器，如果响应超时，则HttpClient返回超时异常，应用程序再提示用户网络出错。

四、用户提示与重试机制

除了设置请求超时外，良好的用户体验还需要在请求失败时向用户提供反馈，比如提示他们网络存在问题，并选择是重试还是取消请求，我们可以通过对话框实现这一功能，以下是一个示例代码，展示如何在请求超时时弹出对话框询问用户是否重试：

import android.app.AlertDialog;
import android.content.Context;
import android.os.Bundle;
import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        findViewById(R.id.button).setOnClickListener(v -> makeRequest("https://example.com"));
    }
    private void makeRequest(String url) {
        OkHttpClient client = new OkHttpClient.Builder()
            .connectTimeout(10, TimeUnit.SECONDS)
            .readTimeout(10, TimeUnit.SECONDS)
            .writeTimeout(10, TimeUnit.SECONDS)
            .build();
        Request request = new Request.Builder()
            .url(url)
            .build();
        client.newCall(request).enqueue(new okhttp3.Callback() {
            @Override
            public void onFailure(okhttp3.Call call, IOException e) {
                if (e instanceof java.net.SocketTimeoutException) {
                    runOnUiThread(() -> showRetryDialog(MainActivity.this, url));
                } else {
                    e.printStackTrace();
                }
            }
            @Override
            public void onResponse(okhttp3.Call call, Response response) throws IOException {
                if (response.isSuccessful()) {
                    System.out.println("Response: " + response.body().string());
                } else {
                    System.out.println("Request failed with code: " + response.code());
                }
            }
        });
    }
    private void showRetryDialog(Context context, String url) {
        AlertDialog.Builder builder = new AlertDialog.Builder(context);
        builder.setTitle("网络请求超时");
        builder.setMessage("是否重试？");
        builder.setPositiveButton("重试", (dialog, which) -> makeRequest(url));
        builder.setNegativeButton("取消", (dialog, which) -> dialog.dismiss());
        builder.show();
    }
}

在该代码中，当请求超时时，我们会弹出一个对话框询问用户是否要重试请求，并根据用户的选择进行处理。