服务器向客户端返回JSON数据以及向主题发布JSON消息，是现代Web和物联网系统中最常用的两种数据交互模式，前者通过HTTP接口实现请求-响应，后者借助MQTT等协议实现实时推送，二者共同构成了前后端及设备间数据流通的骨干。参考2
服务器返回JSON数据格式的常见实现方式
在Web开发中,服务器返回JSON数据通常通过RESTful API实现，客户端发送HTTP请求，服务器处理后将数据以JSON格式放在响应体中返回，这种方式广泛用于移动端和前端应用的数据获取，除了REST，WebSocket也常用于返回JSON，它支持双向通信，适合需要服务器主动推送数据的场景，比如实时看板或在线协作工具。
REST API中返回JSON的标准流程
- 客户端发起请求,指定Accept头为application/json。
- 服务器端根据请求路由,调用对应业务逻辑，查询数据库或计算。
- 将结果封装为对象,序列化为JSON字符串。
- 设置响应头Content-Type为application/json，返回给客户端。
WebSocket与SSE的JSON返回对比
| 特性 | WebSocket | SSE (Server-Sent Events) |
|---|---|---|
| 通信方向 | 全双工 | 仅服务器向客户端 |
| 协议 | ws:// | http:// |
| 适用场景 | 实时双向通信，如聊天 | 实时单向推送，如通知 |
| 返回JSON频率 | 任意 | 任意 |
选择哪种方式取决于业务需求,如果只是服务器主动推送JSON数据，SSE更轻量；如果需要双向交互，WebSocket更合适。
从数据库查询结果直接返回JSON的流程
在很多场景下,我们需要将数据库查询结果直接以JSON格式返回给客户端，步骤如下：
- 执行SQL查询,获取结果集（如列表或单条记录）。
- 将结果集映射为数据结构,如字典或对象。
- 使用JSON库（如Jackson、Gson、fastjson）序列化为JSON字符串。
- 在HTTP响应中返回。
需要注意数据类型的转换,比如日期格式、数字精度等，行业共识认为，使用统一的序列化配置可以避免返回时出现格式不一致的问题。
不同语言返回JSON示例
- Node.js (Express)：
res.json({key: value})直接返回JSON。 - Python (Flask)：
return jsonify({'key': 'value'})。 - Java (Spring Boot)：
@RestController自动返回JSON。 - PHP：使用
json_encode()函数。
这些做法在各自生态中都是标准实现,开发者可根据技术栈直接选用。
向MQTT主题发布JSON消息的操作指南
MQTT是物联网领域最常用的消息协议,它的发布/订阅模式非常适合设备间通信，服务器或设备可以向特定主题发布JSON消息，所有订阅该主题的客户端都会收到，一个温度传感器可以定期发布JSON格式的数据到temperature/room1主题，监控端订阅后即可实时显示。参考2
配置MQTT客户端并发布JSON消息
- 引入MQTT客户端库,如Eclipse Paho（Java）、MQTT.js（Node.js）等。
- 连接到MQTT Broker（如Mosquitto、EMQX）。
- 构造JSON消息体,包含需要传递的数据字段。
- 调用publish方法,指定主题和消息内容，设置QoS等级（0、1、2）控制可靠性。
- 发布成功后,所有订阅者将收到该JSON消息。
发布消息的JSON格式示例：
{ "deviceId": "sensor01", "temperature": 25.5, "humidity": 60, "timestamp": "2026-03-01T12:00:00Z" }
发布JSON消息时的常见问题
- 消息大小限制：多数Broker有默认最大消息大小，超出需调整配置。
- 编码问题：确保JSON采用UTF-8编码，避免乱码。
- QoS选择：对于重要数据，建议使用QoS 1或2确保消息不丢失。
订阅主题接收JSON消息的步骤
- 客户端订阅主题,如
client.subscribe("sensors/temperature")。 - 设置消息回调,当收到消息时，解析JSON字符串。
- 处理数据,更新UI或存储。
订阅端同样需要处理序列化异常,确保消息能正确解析。
后端返回JSON数据时的性能优化技巧
当服务器需要返回大量JSON数据时,性能优化至关重要，在分页查询中，只返回当前页数据，避免一次加载过多，使用缓存机制减少数据库查询次数，也是常见手段。
使用异步处理提升JSON返回效率
对于复杂查询,可以采用异步处理，避免阻塞请求线程，比如在Spring中，使用@Async或WebFlux，可以提升并发能力。
序列化优化：选择高效的JSON库
不同JSON库性能差异明显,据统计，在多数情况下，使用Jackson或Gson性能优于其他库，但具体选择还需考虑扩展性和社区支持。
使用缓存减少数据库查询
- 使用Redis缓存热点数据,设置过期时间。
- 对不易变化的数据,采用本地缓存Caffeine。
- 采用懒加载,仅在需要时查询数据库。
数据压缩减少传输量
- 启用HTTP gzip压缩，在服务器端配置过滤器。
- 对于MQTT消息,如果Broker支持，可启用Payload压缩。
- 减少JSON中不必要的字段,仅返回必需数据。
客户端接收JSON数据的解析方法
客户端收到JSON后,需要解析为本地对象，在Android中常用Gson或Moshi，在iOS中使用Codable，在JavaScript中直接用JSON.parse()，解析时注意异常处理，避免因格式错误导致崩溃。
关于服务器返回JSON与主题发布JSON的常见问题
问题1：服务器返回JSON数据时如何处理null值？
解答：在序列化时，可以通过配置忽略null值，减少传输数据量，例如Jackson中设置@JsonInclude(Include.NON_NULL)，或者全局配置，这样客户端接收到的JSON中不会包含null字段，减少解析负担。
问题2：向MQTT主题发布JSON消息如何确保消息可靠性？
解答：通过设置QoS（服务质量）等级，QoS 0最多一次，可能丢失；QoS 1至少一次，保证送达但可能重复；QoS 2正好一次，确保不重复不丢失，根据业务场景选择合适等级，对于关键数据建议使用QoS 2，但会带来一定性能开销。参考2
问题3：数据库查询结果直接返回JSON有哪些性能瓶颈？
解答：主要瓶颈在于数据库查询本身和JSON序列化，大量数据查询会消耗数据库IO，序列化大对象也会占用CPU和内存，优化方法包括分页查询、限制返回字段、使用流式处理等，业内专家指出，对于超大数据量，考虑使用游标或分页避免一次性加载全量数据。
理解服务器返回JSON和向主题发布JSON消息的技术细节，能够帮助开发者更高效地构建数据驱动型应用，无论是传统的Web服务还是新兴的物联网系统，这两种方式都是数据交互的基石。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/%e6%9c%8d%e5%8a%a1%e5%99%a8%e5%a6%82%e4%bd%95%e8%bf%94%e5%9b%9ejson%e6%95%b0%e6%8d%ae%e5%ba%93%e5%92%8c%e5%8f%91%e5%b8%83json%e6%b6%88%e6%81%af%ef%bc%8c%e6%80%8e%e4%b9%88%e5%ae%9e%e7%8e%b0%ef%bc%9f/
