node如何下发json

Node.js 如何高效下发 JSON 数据：从基础到实践

在前后端分离架构盛行的今天，JSON（JavaScript Object Notation）因其轻量级、易读、与语言无关的特性，已成为前后端数据交互的主流格式，Node.js 作为基于 V8 引擎的 JavaScript 运行时，凭借其异步非阻塞 I/O 模型和高性能，常被用作后端服务来处理和下发 JSON 数据，本文将详细介绍 Node.js 下发 JSON 数据的多种方式，从基础 API 到高级优化,并结合实际场景给出最佳实践。

基础篇：使用原生 HTTP 模块下发 JSON

Node.js 内置的 http 和 https 模块是创建服务器的核心工具，无需额外依赖即可实现 JSON 数据下发,以下是基本步骤：

创建 HTTP 服务器并设置响应头

JSON 数据需要通过 HTTP 响应传递给客户端，关键在于正确设置 Content-Type 为 application/json,确保客户端能正确解析数据格式。

const http = require('http');
// 模拟要下发的 JSON 数据
const jsonData = {
  code: 200,
  message: 'success',
  data: {
    id: 1,
    name: 'Node.js JSON 示例',
    timestamp: Date.now()
  }
};
const server = http.createServer((req, res) => {
  // 1. 设置响应头：Content-Type 为 application/json，charset=utf-8 避免中文乱码
  res.setHeader('Content-Type', 'application/json; charset=utf-8');
  // 2. 将 JavaScript 对象转换为 JSON 字符串（使用 JSON.stringify）
  const jsonString = JSON.stringify(jsonData);
  // 3. 发送响应数据
  res.end(jsonString);
});
server.listen(3000, () => {
  console.log('服务器已启动，访问 http://localhost:3000');
});

关键细节说明

Content-Type 设置：必须明确为 application/json，否则浏览器可能将其当作普通文本处理（如直接显示字符串而非解析为 JSON）。
JSON.stringify()：将 JavaScript 对象/数组序列化为 JSON 字符串，可传入第二个参数（ replacer）和第三个参数（ space）格式化输出，JSON.stringify(jsonData, null, 2) 会生成带缩进的 JSON，便于调试（生产环境建议不使用以减少体积）。
中文乱码问题：通过 charset=utf-8 确保中文字符正确显示，避免客户端出现或乱码。

进阶篇：使用 Express 框架简化 JSON 下发

原生 http 模块虽灵活，但处理路由、中间件等功能时较为繁琐，Express 作为 Node.js 最流行的 Web 框架，提供了更简洁的 API 来处理 JSON 响应。

安装 Express

npm init -y
npm install express

使用 Express 下发 JSON

Express 内置了 JSON 解析中间件，并提供了 res.json() 方法,能自动设置响应头并序列化对象。

const express = require('express');
const app = express();
// 模拟 JSON 数据
const jsonData = {
  code: 200,
  message: 'Express JSON 示例',
  data: [
    { id: 1, product: 'Node.js 实战' },
    { id: 2, product: 'Express 开发指南' }
  ]
};
// 定义路由
app.get('/api/data', (req, res) => {
  // res.json() 会自动设置 Content-Type 为 application/json 并序列化对象
  res.json(jsonData);
});
// 启动服务
app.listen(3000, () => {
  console.log('Express 服务器已启动，访问 http://localhost:3000/api/data');
});

Express 的优势

自动处理响应头：res.json() 无需手动设置 Content-Type，框架会自动完成。
支持链式调用：可结合 res.status() 设置状态码，如 res.status(201).json({ created: true })。
中间件支持：通过 app.use(express.json()) 可解析请求体中的 JSON 数据（适用于 POST/PUT 请求），实现双向 JSON 交互。

优化篇：提升 JSON 下发的性能与安全性

在实际业务中，JSON 数据下发不仅需要功能实现，还需考虑性能、缓存、安全性等问题。

数据压缩：减少传输体积

对于较大的 JSON 数据，启用 Gzip 压缩可显著减少网络传输时间，Express 可通过 compression 中间件实现：

npm install compression

const express = require('express');
const compression = require('compression');
const app = express();
// 启用 Gzip 压缩
app.use(compression());
app.get('/api/large-data', (req, res) => {
  // 模拟大数据（如 1000 条记录）
  const largeData = Array(1000).fill().map((_, i) => ({ id: i, name: `Item ${i}` }));
  res.json({ data: largeData });
});

缓存策略：降低服务器压力

对不常变化的 JSON 数据，可通过 Cache-Control 响应头让客户端或 CDN 缓存数据,减少重复请求：

app.get('/api/static-data', (req, res) => {
  const staticData = { config: { theme: 'dark', lang: 'zh-CN' } };
  res.set('Cache-Control', 'public, max-age=3600'); // 缓存 1 小时
  res.json(staticData);
});

安全性：防止 JSON 劫持与数据泄露

JSON 劫持防护：通过设置 X-Content-Type-Options: nosniff 响应头，防止浏览器将 JSON 解析为可执行脚本：
```
res.set('X-Content-Type-Options', 'nosniff');
```

敏感数据过滤：使用 JSON.stringify 的 replacer 参数过滤敏感字段（如密码、Token）：

const user = { id: 1, name: 'Alice', password: '123456' };
const filteredUser = JSON.stringify(user, (key, value) => {
  return key === 'password' ? undefined : value; // 过滤 password 字段
});
res.end(filteredUser);

错误处理：统一 JSON 错误响应

通过全局错误中间件，统一错误响应格式,便于前端处理：

// 模拟一个错误路由
app.get('/api/error', (req, res, next) => {
  const err = new Error('服务器内部错误');
  err.status = 500;
  next(err);
});
// 全局错误处理中间件
app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(err.status || 500).json({
    code: err.status || 500,
    message: err.message || '服务器错误',
    data: null
  });
});

实战篇：结合数据库动态下发 JSON

实际业务中，JSON 数据通常来自数据库（如 MongoDB、MySQL），以下以 Express + MongoDB 为例，演示动态查询并下发 JSON 数据。

安装依赖

npm install mongoose

代码实现

const express = require('express');
const mongoose = require('mongoose');
const app = express();
// 连接 MongoDB（假设已安装并启动 MongoDB）
mongoose.connect('mongodb://localhost:27017/test', {
  useNewUrlParser: true,
  useUnifiedTopology: true
});
// 定义数据模型
const User = mongoose.model('User', {
  name: String,
  age: Number,
  email: String
});
// 模拟插入数据（仅第一次运行时需要）
// User.insertMany([
//   { name: 'Bob', age: 25, email: 'bob@example.com' },
//   { name: 'Charlie', age: 30, email: 'charlie@example.com' }
// ]);
// 获取用户列表（JSON 格式）
app.get('/api/users', async (req, res) => {
  try {
    const users = await User.find(); // 从数据库查询数据
    res.json({
      code: 200,
      message: '获取用户列表成功',
      data: users
    });
  } catch (err) {
    res.status(500).json({
      code: 500,
      message: '数据库查询失败',
      data: null
    });
  }
});
app.listen(3000, () => {
  console.log('服务器已启动，访问 http://localhost:3000/api/users');
});