如何在Retrofit中将Int类型字段转换为String类型？

我来给你几个实用的方案解决这个问题，都是实际开发中常用的：

方案一：直接修改接口参数类型（最简单直接） #

既然你需要把field3以String类型发送请求，最直接的方式就是修改接口方法里的参数类型，同时保留默认值为字符串"0"：

@FormUrlEncoded
@POST("login")
fun login(
    @Field("field1") field1: String,
    @Field("field2") field2: String,
    @Field("field3") field3: String = "0" // 改为String类型，默认值设为"0"
): Observable<String>

调用的时候，如果你的数据源是Int类型，只需要调用toString()方法转成字符串传入即可：

// 示例调用
val myIntValue = 123
api.login("user123", "password456", myIntValue.toString())

这个方案优点是代码改动最小，逻辑清晰，适合大多数场景。

方案二：自定义Converter保留原参数类型 #

如果因为某些原因你不想修改接口的Int参数定义（比如要保持参数类型的语义一致性），可以通过自定义Retrofit的Converter来自动完成Int到String的转换：

1. 创建自定义Converter.Factory #

class IntToStringConverterFactory : Converter.Factory() {
    override fun requestBodyConverter(
        type: Type,
        parameterAnnotations: Array<Annotation>,
        methodAnnotations: Array<Annotation>,
        retrofit: Retrofit
    ): Converter<*, RequestBody>? {
        // 只处理Int类型的参数（包括基本类型Int和装箱类型Integer）
        if (type == Int::class.java || type == Int::class.javaObjectType) {
            // 获取Retrofit默认的RequestBody转换器
            val delegate = retrofit.nextRequestBodyConverter<Any>(this, type, parameterAnnotations, methodAnnotations)
            // 包装转换器，将Int转为String后再交给默认转换器处理
            return Converter<Int, RequestBody> { value ->
                delegate.convert(value.toString())
            }
        }
        // 非Int类型参数交给后续转换器处理
        return super.requestBodyConverter(type, parameterAnnotations, methodAnnotations, retrofit)
    }
}

2. 在Retrofit构建时添加自定义Converter #

注意要把自定义的ConverterFactory放在GsonConverterFactory之前，这样Retrofit会优先使用我们的转换器处理Int类型：

Retrofit.Builder()
    .addConverterFactory(IntToStringConverterFactory()) // 优先添加自定义转换器
    .addConverterFactory(GsonConverterFactory.create())
    .addCallAdapterFactory(RxJava2CallAdapterFactory.create())
    .baseUrl("your_base_url_here")
    .client(get())
    .build()

这样你的原接口方法完全不需要修改，Retrofit会自动把Int类型的field3转成String发送请求，默认值0也会被转为"0"。

方案三：使用@FieldMap手动处理（不推荐，仅作补充） #

如果上述两种方案都不适合，你也可以改用@FieldMap来传递参数，手动处理Int到String的转换：

@FormUrlEncoded
@POST("login")
fun login(
    @Field("field1") field1: String,
    @Field("field2") field2: String,
    @FieldMap optionalFields: Map<String, String>
): Observable<String>

调用时构建参数Map，手动把Int转为String：

// 处理默认值：如果没有传入field3，就添加"0"
val params = mutableMapOf<String, String>()
val myIntValue = 456
params["field3"] = myIntValue.toString()
// 或者如果不需要传field3，就put("field3", "0")

api.login("user123", "password456", params)

这个方案比较繁琐，还要手动处理默认值，所以一般不推荐，除非有特殊需求。

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