Retrofit2动态构造含config.items数组格式Query参数的URL请求咨询

刚接触Retrofit2遇到这种特殊的参数格式确实有点懵，我之前做电商项目的时候也碰到过类似的需求，给你分享个直接可行的方案：

核心思路 #

服务器要求的config.items[0].id=xxx&config.items[0].opt1Id=xxx这种格式，本质是把数组的每个元素拆成独立的键值对，我们可以手动构建一个参数Map，再通过Retrofit的@QueryMap来传递。

具体步骤 #

1. 先定义Item数据类

用来封装每个商品的id和opt1Id，方便后续处理：

// Kotlin版本
data class OrderItem(val id: String, val opt1Id: String)

// Java版本
public class OrderItem {
    private String id;
    private String opt1Id;

    public OrderItem(String id, String opt1Id) {
        this.id = id;
        this.opt1Id = opt1Id;
    }

    // 记得加getter方法
    public String getId() { return id; }
    public String getOpt1Id() { return opt1Id; }
}

2. 写个工具方法构建参数Map

遍历你的Item列表，给每个元素生成对应的参数键（比如config.items[0].id），然后把键值对放进Map里：

// Kotlin版本
fun buildOrderItemsQueryMap(items: List<OrderItem>): Map<String, String> {
    val queryMap = mutableMapOf<String, String>()
    items.forEachIndexed { index, item ->
        // 按服务器要求的格式生成键
        queryMap["config.items[$index].id"] = item.id
        queryMap["config.items[$index].opt1Id"] = item.opt1Id
    }
    return queryMap
}

// Java版本
public static Map<String, String> buildOrderItemsQueryMap(List<OrderItem> items) {
    Map<String, String> queryMap = new HashMap<>();
    for (int i = 0; i < items.size(); i++) {
        OrderItem item = items.get(i);
        queryMap.put("config.items[" + i + "].id", item.getId());
        queryMap.put("config.items[" + i + "].opt1Id", item.getOpt1Id());
    }
    return queryMap;
}

3. 定义Retrofit接口

用@GET指定基础接口路径，再用@QueryMap接收我们构建好的参数Map：

// Kotlin版本（用协程的话加suspend）
interface OrderApi {
    @GET("confirmOrder")
    suspend fun confirmOrder(@QueryMap queryMap: Map<String, String>): Response<YourOrderResponse>
}

// Java版本
public interface OrderApi {
    @GET("confirmOrder")
    Call<YourOrderResponse> confirmOrder(@QueryMap Map<String, String> queryMap);
}

4. 调用接口

把你的Item列表转换成参数Map，直接传给接口方法就行：

// Kotlin示例
val items = listOf(
    OrderItem("12939837", "0"),
    OrderItem("12939837", "0")
)
val queryParams = buildOrderItemsQueryMap(items)
// 调用Retrofit接口
val response = orderApi.confirmOrder(queryParams)

补充说明 #

• 你例子里的参数用了冒号（:），但正常URL参数格式是用等号（=）的，大概率是笔误~如果服务器真的要求冒号分隔，那得换用@Url注解手动拼接完整URL，不过这种情况非常少见。
• 这个方法支持1-10个Item的动态生成，不管多少个元素，遍历后都会自动生成对应的参数键。

内容的提问来源于stack exchange，提问作者Vishwanath.M