【Node.js】http服务器详解

最新推荐文章于 2025-11-20 09:54:42 发布

原创最新推荐文章于 2025-11-20 09:54:42 发布 · 1.3k 阅读

21 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

NodeJS

文章目录

Node.js 是目前非常流行的 JavaScript 运行环境，尤其在构建后端服务器时表现出色。本文将详细介绍如何在 Node.js 中创建一个 HTTP 服务器，并逐步探讨它的核心功能与实际应用，帮助你更好地理解和使用 Node.js 构建高效的 HTTP 服务器。

一、Node.js HTTP 模块概述

1. HTTP 模块简介

Node.js 内置了一个功能强大的 HTTP 模块，可以让开发者轻松创建 HTTP 服务器。使用这个模块，你可以监听特定的端口，处理客户端请求，并返回响应。HTTP 模块是 Node.js 构建服务器端应用的核心工具之一，支持处理常见的 GET、POST 等请求方法。

2. HTTP 模块的作用

HTTP 模块提供了多种方法来处理不同的请求类型，并且能够对传入的数据进行解析和操作。开发者可以使用它来处理基本的 Web 请求，创建 REST API，甚至构建实时 Web 应用。

二、创建一个简单的 HTTP 服务器

1. 基本的 HTTP 服务器结构

要在 Node.js 中创建一个最基本的 HTTP 服务器，我们首先需要引入 http 模块，并使用 http.createServer() 方法创建服务器实例。然后通过 listen() 方法指定服务器监听的端口。

以下是一个最基础的 HTTP 服务器代码示例：

const http = require('http');

// 创建 HTTP 服务器
const server = http.createServer((req, res) => {
  res.statusCode = 200; // 设置响应状态码为 200（OK）
  res.setHeader('Content-Type', 'text/plain'); // 设置响应头为纯文本
  res.end('Hello, World!\n'); // 发送响应内容
});

// 让服务器监听 3000 端口
server.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000/');
});

这个服务器在接收到请求时会返回状态码 200，并输出 “Hello, World!”。服务器运行在本地主机的 3000 端口，开发者可以通过浏览器访问 http://localhost:3000 来查看响应。

2. `createServer` 方法的参数详解

req 对象：代表客户端请求，包含请求的 URL、HTTP 方法、头信息等。
res 对象：用于向客户端发送响应，提供了设置状态码、头信息和响应主体的方法。

3. 服务器监听端口

通过 server.listen() 方法，我们可以让服务器监听指定的端口。在生产环境中，通常会监听 80 或 443 端口，但在开发阶段，我们常常使用较高的端口号（如 3000、5000 等）以避免冲突。

三、处理不同的 HTTP 请求

1. 处理 GET 请求

GET 请求是最常见的 HTTP 请求方法，通常用于请求数据或页面内容。我们可以通过 req.method 属性来判断请求类型，从而针对不同的请求类型执行相应的处理逻辑。

以下代码展示了如何处理 GET 请求：

const http = require('http');

const server = http.createServer((req, res) => {
  if (req.method === 'GET') {
    res.statusCode = 200;
    res.setHeader('Content-Type', 'text/plain');
    res.end('This is a GET request!\n');
  } else {
    res.statusCode = 405; // 方法不允许
    res.end('Method Not Allowed');
  }
});

server.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000/');
});

在这个例子中，如果收到的请求是 GET 方法，服务器会返回对应的响应内容，否则返回 405 错误。

2. 处理 POST 请求

POST 请求通常用于提交数据，比如表单数据、文件上传等。我们可以通过监听请求体数据来处理客户端发送的 POST 数据。

以下是处理 POST 请求的示例：

const http = require('http');

const server = http.createServer((req, res) => {
  if (req.method === 'POST') {
    let body = '';

    // 监听数据传输
    req.on('data', chunk => {
      body += chunk.toString(); // 将数据块拼接成字符串
    });

    // 数据接收完成后处理
    req.on('end', () => {
      res.statusCode = 200;
      res.setHeader('Content-Type', 'text/plain');
      res.end(`Received POST data: ${body}\n`);
    });
  } else {
    res.statusCode = 405;
    res.end('Method Not Allowed');
  }
});

server.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000/');
});

在这个示例中，服务器会监听 POST 请求并接收请求体数据，然后将其返回给客户端。

四、处理 URL 路径

在实际应用中，我们需要根据不同的 URL 路径返回不同的内容。通过 req.url 属性，我们可以轻松获取客户端请求的路径，并针对不同的路径执行不同的逻辑。

以下是一个简单的示例，展示了如何根据路径返回不同的响应：

const http = require('http');

const server = http.createServer((req, res) => {
  const { url } = req;

  if (url === '/') {
    res.statusCode = 200;
    res.setHeader('Content-Type', 'text/plain');
    res.end('Welcome to the home page!\n');
  } else if (url === '/about') {
    res.statusCode = 200;
    res.setHeader('Content-Type', 'text/plain');
    res.end('This is the about page.\n');
  } else {
    res.statusCode = 404;
    res.setHeader('Content-Type', 'text/plain');
    res.end('Page not found.\n');
  }
});

server.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000/');
});

在这个例子中，服务器根据请求的 URL 返回不同的页面内容。如果 URL 是 /about，则返回关于页面；如果 URL 不匹配任何已定义的路径，则返回 404 错误。

五、设置 HTTP 响应头

1. 设置常见的响应头

在 HTTP 服务器中，设置正确的响应头是非常重要的。res.setHeader() 方法允许我们为响应设置头信息，比如 Content-Type、Cache-Control 等。

常见的 Content-Type 类型有：

text/plain：纯文本
text/html：HTML 页面
application/json：JSON 数据

以下代码展示了如何设置响应头：

const http = require('http');

const server = http.createServer((req, res) => {
  res.statusCode = 200;
  res.setHeader('Content-Type', 'application/json');
  const responseBody = { message: 'Hello, World!' };
  res.end(JSON.stringify(responseBody));
});

server.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000/');
});