Net项目中Kotlin序列化BodyRequest解析问题解析

在Kotlin开发中，网络请求库Net因其简洁高效的特性受到开发者青睐。然而，近期有开发者反馈在使用Net进行POST请求时遇到了JSON序列化异常问题，本文将深入分析该问题的成因及解决方案。

问题现象

开发者尝试使用Net库发送包含嵌套JSON数组的POST请求时，虽然代码中明确指定了字段值，但实际生成的请求体中所有嵌套字段值均变为null。示例代码中构建的productList数组内对象字段在请求时丢失了原始值。

根本原因

Net库在设计上保持轻量级原则，其核心实现存在两个关键特性：

1. 无内置JSON框架：Net未集成任何第三方JSON序列化库（如Gson、kotlinx.serialization等），这是为了避免强依赖和包体积膨胀。

2. 基础类型支持：文档明确说明仅支持基础数据类型（String/Int等）的直接序列化，复杂对象需要开发者自行处理。

解决方案

方案一：自定义扩展函数

通过扩展函数增强序列化能力，以下示例展示如何实现：

fun HttpRequestBuilder.jsonAdvanced(data: Map<String, Any>) {
    val json = Json { encodeDefaults = true }
    body = TextContent(json.encodeToString(data), ContentType.Application.Json)
}

方案二：手动构建请求体

对于复杂结构，推荐完全控制序列化过程：

val requestBody = buildJsonObject {
    put("memberId", "1")
    putJsonArray("productList") {
        addJsonObject {
            put("goodsSku", "1000083552")
            put("goodsQty", 1)
        }
    }
}.toString()

Post<List<Coupon>>(Api.COUPON_LIST) {
    body = TextContent(requestBody, ContentType.Application.Json)
}

最佳实践建议

1. 统一序列化策略：项目应确立统一的JSON处理方案，推荐使用kotlinx.serialization

2. 基础建设：可封装网络层提供高级序列化支持：

inline fun <reified T> Net.postWithBody(url: String, body: T) {
    val json = Json.encodeToString(body)
    // ...发送请求
}

3. 类型安全：为复杂请求创建数据类：

@Serializable
data class CouponRequest(
    val memberId: String,
    val productList: List<ProductItem>
)

总结

Net库的轻量级设计使其在简单场景下表现优异，但处理复杂JSON结构时需要开发者理解其设计哲学并适当扩展。通过自定义序列化逻辑或引入合适的JSON库，可以既保持Net的简洁性又满足业务需求。建议开发者在项目初期就建立完善的网络层封装，以应对后续可能出现的各种数据交互场景。