Retrofit 2.9.0移除自动附加Content-Length请求头的尝试与排查
Retrofit 2.9.0 移除自动添加的 Content-Length 头相关问题说明
问题背景
- Retrofit 2.9.0 发起POST请求时,会自动为请求附加Content-Length请求头
- 对接的服务端出于安全策略,会拒绝携带该头的流量,且无权限修改服务端校验规则
- 目标:在不自行搭建Rest客户端的前提下,移除自动添加的Content-Length头
无效的尝试操作
- 直接调用
Request.Builder的removeHeader("Content-Length")方法无法移除该头,本质原因是*Content-Length是OkHttp桥接拦截器层根据请求体实际大小自动计算追加的,应用层拦截器的移除操作会被后续的自动补全逻辑覆盖 - 通过
addHeader("Content-Length", "任意值")仅能修改头的取值,无法满足服务端完全移除该头的校验要求
已实现的业务代码逻辑
自定义拦截器
class HeaderInterceptor() : Interceptor { override fun intercept(chain: Interceptor.Chain): Response { val builder = chain.request().newBuilder().apply { removeHeader("Content-Length") // 运行时不生效,会被OkHttp桥接层重新添加 } return chain.proceed(builder.build()) } }
Retrofit客户端构建
@Singleton @Provides fun providesUserApi(headerInterceptor: HeaderInterceptor): UsersApi { val loggingInterceptor = HttpLoggingInterceptor().apply { level = HttpLoggingInterceptor.Level.BODY } val client = OkHttpClient.Builder().apply { addInterceptor(tokenInterceptor) addInterceptor(headerInterceptor) }.build() return Retrofit.Builder() .baseUrl(Constants.BASE_USERS_URL) .addConverterFactory(GsonConverterFactory.create()) .client(client) .build() .create(UsersApi::class.java) }
登录接口定义
interface UsersApi { @POST("/api/auth/login") suspend fun login(@Body user: LoginRequest): Response<LoginResponse> }
*注:LoginRequest是承载设备类型、登录账号、密码字段的普通POJO数据类,LoginResponse是服务端返回的登录响应数据类。
实测异常表现
通过HttpLoggingInterceptor的BODY级别日志,可直接确认请求头的存在,无需额外有效性验证:
I/okhttp.OkHttpClient: --> POST https://this_is_api_server.com/api/auth/login I/okhttp.OkHttpClient: Content-Length: 60 I/okhttp.OkHttpClient: {"device_type":"ANDROID","email":"admin","password":"admin"} I/okhttp.OkHttpClient: --> END POST (60-byte body) I/okhttp.OkHttpClient: <-- HTTP FAILED: java.net.SocketException: socket failed: EPERM (Operation not permitted)
根因排查与解决
- 对日志中的域名、IP地址做脱敏处理后,可定位到请求在TCP连接建立阶段就持续抛出Socket权限异常,与最初推测的Content-Length头校验逻辑无关
- 实际根因为Android模拟器的网络栈异常
- 解决方式:完全删除原有模拟器并重新创建后,请求即可正常发送,问题顺利解决
内容的提问来源于stack exchange,提问作者Remzo
相关产品推荐
相关产品推荐

