Android应用Retrofit+OkHttp请求遭WiFi防火墙拦截问题咨询

你遇到的这个情况其实挺典型的——明明Postman能正常请求，Android用Retrofit+OkHttp却在特定WiFi下超时，核心原因就是Postman和Android应用的请求特征不一样，导致防火墙对两者的拦截逻辑有区别。我来拆解几个最可能的差异点，再给你对应的解决思路：

1. 请求头的差异 #

Postman默认会带上一套比较完整的标准请求头（比如User-Agent、Accept、Cache-Control这些），而你的Android应用可能用了Retrofit/OkHttp的默认头，或者没配置某些关键头，这些“不标准”的请求头很容易被防火墙判定为非合规客户端，直接拦截。

解决办法：
打开Postman的请求详情，把所有请求头都复制下来，在你的Retrofit请求里完全复刻。举个Kotlin的例子：

@GET("your-api-endpoint")
fun fetchApiData(
    @Header("User-Agent") userAgent: String = "PostmanRuntime/7.32.3",
    @Header("Accept") accept: String = "*/*",
    @Header("Cache-Control") cacheControl: String = "no-cache"
): Call<YourResponseModel>

如果觉得逐个加麻烦，也可以给OkHttp设置全局拦截器统一添加：

val headerInterceptor = Interceptor { chain ->
    val originalRequest = chain.request()
    val modifiedRequest = originalRequest.newBuilder()
        .header("User-Agent", "PostmanRuntime/7.32.3")
        .header("Accept", "*/*")
        .build()
    chain.proceed(modifiedRequest)
}

val okHttpClient = OkHttpClient.Builder()
    .addInterceptor(headerInterceptor)
    .build()

2. TLS/SSL连接配置差异 #

有些防火墙会针对特定的TLS版本、SSL握手方式做拦截，Postman的默认TLS配置可能刚好符合防火墙要求，而OkHttp的默认配置（比如只支持TLS 1.2）可能不被允许。

解决办法：
调整OkHttp的TLS协议支持范围，尽量覆盖更多常用版本，同时确保证书校验逻辑正常（生产环境别随便跳过证书验证！）：

val sslContext = SSLContext.getInstance("TLSv1.2")
sslContext.init(null, null, null)
val trustManager = sslContext.trustManagers.first() as X509TrustManager

val okHttpClient = OkHttpClient.Builder()
    .sslSocketFactory(sslContext.socketFactory, trustManager)
    .protocols(listOf(Protocol.TLS_1_2, Protocol.TLS_1_3))
    .build()

3. 超时时间设置差异 #

Postman的默认超时时间通常比较长（比如60秒），而你的Android应用可能把连接/读取超时设得太短，防火墙的延迟导致请求在Android端触发超时，但Postman能等够时间完成请求。

解决办法：
适当延长OkHttp的超时时间，比如：

val okHttpClient = OkHttpClient.Builder()
    .connectTimeout(30, TimeUnit.SECONDS)  // 连接超时
    .readTimeout(30, TimeUnit.SECONDS)     // 读取超时
    .writeTimeout(30, TimeUnit.SECONDS)    // 写入超时
    .build()

4. DNS解析差异 #

Postman可能用了系统默认之外的DNS服务器（比如你手动设置过），而Android应用用的是WiFi提供的DNS，这个DNS可能被防火墙篡改，导致解析到错误的API服务器IP，自然连不上。

解决办法：
给OkHttp配置自定义DNS，比如用公共DNS：

val customDns = Dns { hostname ->
    // 用Google DNS解析
    InetAddress.getAllByName(hostname).toList()
    // 或者直接指定IP（如果知道API服务器的正确IP）
    // listOf(InetAddress.getByName("1.1.1.1"))
}

val okHttpClient = OkHttpClient.Builder()
    .dns(customDns)
    .build()

最后一步：抓包对比 #

如果上面的方法都不行，建议用Android Studio的Network Inspector抓Android应用的请求包，再和Postman的请求包对比，看看除了上面几点之外，还有没有其他差异（比如请求方法、参数编码、Cookie等），差异点就是问题所在。

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