JSON格式请求体

张开发
2026/4/19 19:26:14 15 分钟阅读

分享文章

JSON格式请求体
一、JSON 核心规则必须遵守键名必须用双引号 不能用单引号 / 无引号支持数据类型字符串/数字/布尔值/null/对象/数组键值对用:分隔多个用,分隔最后一个键值对末尾不能加逗号{}表示对象[]表示数组二、标准 JSON 示例分 3 种常用场景1. 最简单单层 JSON 对象{ id: 1001, orderNo: DD20250615001, driverName: 张三, phone: 13800138000, status: TRANSPORTING, isCompleted: false, amount: 150.50, remark: null }2. 带数组的 JSON{ orderId: 1001, orderName: 物流运输订单, picKeys: [ tos-cn-i-a9rns2rl98/be61d6c402994eb497bd47608966462d.png, tos-cn-i-a9rns2rl98/123456.png ], orgIds: [1001, 1002, 1003], status: WAITING_TRANSPORT }3. 多层嵌套 JSON企业级接口标准格式{ code: 200, msg: 查询成功, data: { orderId: 1001, orderNo: DD20250615001, content: [ { blockId: 1, title: 货物详情, pic: [ pic1.png, pic2.png ], fileUrls: [ https://xxx.com/pic1.png, https://xxx.com/pic2.png ] } ], currentOrgId: 1001, driverInfo: { driverId: 666, driverName: 张三, isOnline: true } } }三、纯数组 JSON列表接口专用[ { id: 1001, name: 订单1 }, { id: 1002, name: 订单2 } ]// ✅ 合法标准格式 { remark: null // 字段有明确的值null空值 } // ❌ 语法错误格式 { remark: // 冒号后面**没有任何值**JSON语法不允许 }一、逐行对比差异// ✅ 合法标准格式 { remark: null // 字段有明确的值null空值 } // ❌ 语法错误格式 { remark: // 冒号后面**没有任何值**JSON语法不允许 }二、核心知识点必记1. JSON 语法铁律键值对必须完整键: 值值不能为空只能是以下 6 种类型字符串abc数字123布尔true/false空值null对象{}数组[] 你第二段里remark:后面光秃秃没值违反语法规则2.null代表什么remark: null表示字段存在值是明确的空没有内容所有解析工具Java、JS、Python都能正常识别3. 如果你想表示「空内容」正确写法有两种// 1. 空值推荐后端常用 remark: null // 2. 空字符串表示有值只是内容为空 remark: 三、后端开发实战后果你在写接口、传参数时用第一段正常接收、正常赋值给实体类用第二段直接抛解析异常Jackson/FastJson 报错程序直接崩掉四、极简总结remark: null✅ 合法代表字段为空remark:非法语法错误无法解析想表示空内容要么写null要么写绝对不能空着

更多文章