JSON 解析与接口联调最容易踩什么坑？

返回 网络与设备通信 目录

标准回答

先约定字段类型、是否可空、缺省含义、错误码和版本兼容策略，再选择解析工具；收到 JSON 只是传输成功，不代表它满足业务约束。

关键机制

• 字段缺失、显式 null 和空字符串可能代表不同意思；不要让 Kotlin 非空声明或 Java 基本类型默认值掩盖协议问题。
• 大整数编号、时间戳单位、时区和金额精度需要明确，避免跨语言精度损失；未知枚举值要有兼容策略。
• 联调按请求标识串起客户端、网关和服务端日志，核对 URL、方法、header、签名、编码和响应。

通俗例子

后端把超大 deviceId 当 JSON 数字返回，经过某些 JavaScript 中间层可能丢精度；协议约定用字符串表示标识更稳妥。

易混淆点

把所有异常都叫“网络错误”会误导定位。至少区分连接失败、HTTP 错误、解析失败与业务拒绝。

参考资料

• 官方参考

内容来源

• Android 技术札记 · 原条目 json