使用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，避免前端解析出现乱码问题。
正确写法示例：
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简化了流程，适合大多数场景；原生方式有助于理解底层机制。根据项目需求选择即可。
