Retrofit动态修改POST请求参数名：根据输入切换email/user_name

这个需求挺常见的，我来给你分享几个实用的原生解决方案，不用额外折腾第三方工具，都是Retrofit自带的特性~

方法一：使用@QueryMap（多动态参数场景首选） #

这种方式灵活性拉满，适合需要动态控制多个参数名的情况，我们可以把动态参数塞进Map里，根据输入类型决定键名：

首先修改你的Retrofit接口：

@POST("login")
Call<LoginResponse> login(@QueryMap Map<String, String> dynamicParams, @Query("password") String password);

然后在调用接口前，先判断输入内容是邮箱还是用户名，再构建对应的参数Map：

// 假设input是EditText获取到的内容，password是密码输入框的值
Map<String, String> params = new HashMap<>();
if (isEmail(input)) { // 这里需要你自己实现邮箱判断逻辑，比如用正则校验
    params.put("email", input);
} else {
    params.put("user_name", input);
}

// 发起请求
yourRetrofitApi.login(params, password).enqueue(new Callback<LoginResponse>() {
    // 你的回调逻辑...
});

如果想把密码也统一放进Map管理，接口还能简化：

@POST("login")
Call<LoginResponse> login(@QueryMap Map<String, String> allParams);

调用时把密码也加入Map即可：

params.put("password", password);

方法二：使用@QueryName（单个动态参数最优解） #

如果只有这一个参数需要动态切换名称，用@QueryName会更简洁直观，它允许你直接传入参数名的字符串：

修改接口定义：

@POST("login")
Call<LoginResponse> login(@QueryName String paramKey, String paramValue, @Query("password") String password);

调用时直接根据判断结果传入对应的参数名：

String paramKey = isEmail(input) ? "email" : "user_name";
yourRetrofitApi.login(paramKey, input, password).enqueue(new Callback<LoginResponse>() {
    // 你的回调逻辑...
});

补充：邮箱校验的简单实现 #

你需要一个基础的邮箱判断方法，比如用正则表达式：

private boolean isEmail(String input) {
    if (TextUtils.isEmpty(input)) return false;
    String emailRegex = "^[a-zA-Z0-9_+&*-]+(?:\\.[a-zA-Z0-9_+&*-]+)*@(?:[a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,7}$";
    Pattern pattern = Pattern.compile(emailRegex);
    Matcher matcher = pattern.matcher(input);
    return matcher.matches();
}

这两种方法都是Retrofit官方支持的特性，稳定性和兼容性都有保障，我个人更推荐在这个场景下用@QueryName，代码更清爽~

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