如何在Retrofit2调用中固定传递硬编码查询参数且不暴露给调用者

方案1：直接在请求URL中硬编码固定参数 #

把obscureArg=magic直接拼在@GET的路径里，接口方法只保留必填参数，调用者完全接触不到这个内部参数：

interface MyApiClient {
    data class MyResponse(val result: String?)

    @GET("/some/api/call?obscureArg=magic")
    fun someApiCall(
        @Query("mandatoryArg") arg: String
    ): Call<MyResponse>
}

Retrofit会自动合并URL中的参数和@Query注解的参数，最终请求会同时携带mandatoryArg和固定的obscureArg=magic，实现最简单直接的参数固化。

方案2：使用Retrofit拦截器（适合多接口统一添加的场景） #

如果多个接口需要添加该固定参数，或者参数值需动态维护但当前固定为"magic"，可以自定义拦截器：

class MagicParamInterceptor : Interceptor {
    override fun intercept(chain: Interceptor.Chain): Response {
        val originalRequest = chain.request()
        // 仅针对目标接口添加参数
        if (originalRequest.url.encodedPath.contains("/some/api/call")) {
            val modifiedUrl = originalRequest.url.newBuilder()
                .addQueryParameter("obscureArg", "magic")
                .build()
            val modifiedRequest = originalRequest.newBuilder()
                .url(modifiedUrl)
                .build()
            return chain.proceed(modifiedRequest)
        }
        return chain.proceed(originalRequest)
    }
}

构建Retrofit实例时添加该拦截器即可：

val retrofit = Retrofit.Builder()
    .baseUrl("your_base_url")
    .addInterceptor(MagicParamInterceptor())
    .addConverterFactory(GsonConverterFactory.create())
    .build()

这种方式无需修改接口方法，就能为指定接口自动注入固定参数，调用者完全无感知。

方案3：封装接口（适合隐藏内部API细节的场景） #

通过封装层隔离内部参数，对外暴露简化后的调用方法：

// 内部隐藏的原始API接口
internal interface InternalMyApiClient {
    data class MyResponse(val result: String?)

    @GET("/some/api/call")
    fun someApiCall(
        @Query("mandatoryArg") arg: String,
        @Query("obscureArg") obscureArg: String
    ): Call<MyResponse>
}

// 对外暴露的封装类
class MyApiWrapper(private val internalApi: InternalMyApiClient) {
    fun someApiCall(arg: String): Call<InternalMyApiClient.MyResponse> {
        return internalApi.someApiCall(arg, "magic")
    }
}

调用者仅能通过MyApiWrapper的方法发起请求，完全无法修改obscureArg的值，彻底隐藏内部实现细节。

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