使用express的res.json()或原生res.end(json.stringify())返回JSON数据,需设置Content-Type为application/json;推荐Express方式,自动序列化并支持状态码,如res.status(200).json({code: 200, message: ‘成功’, data: {}});原生需手动设置头和字符串化,处理中文时应加charset=utf-8避免乱码。

在node.js后端开发中,返回JSON数据是最常见的操作之一。服务器处理完请求后,通常需要将数据以JSON格式发送给前端或其他调用方,比如ajax请求或API接口。实现这一点非常简单,关键在于设置正确的响应头并使用res.json()或手动写入JSON字符串。
使用Express框架返回JSON(推荐方式)
Express是node.js中最流行的Web框架,内置了便捷的方法来返回JSON数据。
方法说明:
调用res.json()方法,Express会自动设置响应头Content-Type: application/json,并将javaScript对象转换为JSON字符串返回。
- 自动处理JSON序列化
- 正确设置http响应头
- 支持状态码链式调用,如
res.status(200).json({...})
示例代码:
const express = require('express'); const app = express(); app.get('/api/user', (req, res) => { const user = { id: 1, name: '张三', age: 25 }; res.json(user); // 自动返回JSON并设置头信息 }); app.listen(3000, () => { console.log('服务启动在 http://localhost:3000'); });
原生Node.js返回JSON(不使用框架)
如果不使用Express等框架,可以通过Node.js原生的http模块手动返回JSON数据。
关键步骤:
- 设置响应头
Content-Type为application/json - 使用
JSON.stringify()将对象转为字符串 - 通过
res.end()发送数据
示例代码:
const http = require('http'); const server = http.createServer((req, res) => { if (req.url === '/api/data' && req.method === 'GET') { const data = { message: 'Hello JSON!', success: true }; res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' }); res.end(JSON.stringify(data)); } else { res.writeHead(404, { 'Content-Type': 'application/json' }); res.end(JSON.stringify({ error: '接口不存在' })); } }); server.listen(3000, () => { console.log('原生服务运行在 http://localhost:3000'); });
处理中文乱码与字符集
返回JSON时如果包含中文,建议在响应头中明确指定字符集charset=utf-8,避免前端解析出现乱码问题。
Easily find JSON paths within JSON objects using our intuitive Json Path Finder
30 正确写法示例:
res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
使用Express时虽然默认会处理,但在某些代理或编码环境下显式声明更稳妥。
错误处理与统一返回格式
实际项目中,建议统一返回结构,便于前端处理。例如:
res.json({ code: 200, message: '请求成功', data: userData });
对于错误情况:
res.status(500).json({ code: 500, message: '服务器内部错误', data: null });
基本上就这些。无论是使用Express还是原生Node.js,返回JSON的核心就是设置正确的类型头并输出合法的JSON字符串。Express简化了流程,适合大多数场景;原生方式有助于理解底层机制。根据项目需求选择即可。