Node返回JSON数据方法与实例详解

学习文章要努力，但是不要急！今天的这篇文章《Node后端返回JSON数据方法与实例》将会介绍到等等知识点，如果你想深入学习文章，可以关注我！我会持续更新相关文章的，希望对大家都能有所帮助！

使用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字符串返回。

示例代码：

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数据。

关键步骤：

示例代码：

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简化了流程，适合大多数场景；原生方式有助于理解底层机制。根据项目需求选择即可。

文中关于js全栈教程的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Node返回JSON数据方法与实例详解》文章吧，也可关注golang学习网公众号了解相关技术文章。