使用Node.js构建简单的Web服务器：你的第一个后端应用

引言

在上一篇文章中，我们了解了Node.js是什么，以及如何在本地搭建Node.js开发环境。现在，你已经准备好迈出后端开发的第一步了！本篇文章将指导你使用Node.js的核心模块，从零开始构建一个简单的Web服务器。通过这个实践项目，你将亲身体验Node.js在后端开发中的强大和便捷。

Web服务器是Web应用的核心，它负责接收来自客户端（如浏览器）的请求，处理这些请求，并向客户端发送响应（如HTML页面、图片、JSON数据等）。Node.js内置了http模块，使得构建Web服务器变得非常简单。

1. Node.js的`http`模块

Node.js的http模块是构建Web服务器的基础。它提供了一组函数和类，用于创建HTTP服务器和客户端。我们将主要使用http.createServer()方法来创建一个服务器实例，并使用server.listen()方法来监听端口。

`http.createServer([requestListener])`

这个方法返回一个新的http.Server实例。requestListener是一个可选的函数，它会在每次服务器接收到请求时被调用。这个函数接收两个参数：

req (http.IncomingMessage)：请求对象，包含了客户端请求的所有信息，如URL、请求头、请求方法等。
res (http.ServerResponse)：响应对象，用于向客户端发送响应，如设置响应头、发送数据等。

`server.listen(port[, hostname][, backlog][, callback])`

这个方法用于启动HTTP服务器，使其开始监听指定的端口和主机名。

port：服务器要监听的端口号（例如，80、8080、3000等）。
hostname（可选）：服务器要监听的主机名或IP地址。如果省略，则默认为0.0.0.0（监听所有可用的网络接口）。
callback（可选）：服务器启动成功后执行的回调函数。

2. 构建你的第一个Web服务器

让我们开始编写代码，创建一个简单的“Hello World”Web服务器。

创建一个新的文件，命名为server.js。

在server.js文件中输入以下代码：

// server.js

// 导入Node.js内置的http模块
const http = require("http");

// 定义服务器监听的端口号
const port = 3000;

// 创建一个HTTP服务器实例
const server = http.createServer((req, res) => {
    // 当服务器接收到请求时，这个回调函数会被执行

    // 设置响应头：状态码200表示成功，Content-Type设置为纯文本
    res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });

    // 向客户端发送响应体
    res.end("Hello, World from Node.js Server!\n");
});

// 启动服务器，监听指定端口
server.listen(port, () => {
    console.log(`服务器运行在 http://localhost:${port}/`);
    console.log("请在浏览器中访问此地址。");
});

保存文件。
打开命令行工具，进入到server.js文件所在的目录。
运行以下命令来启动服务器：
1
node server.js

如果一切顺利，你将在命令行中看到类似以下的输出：

1 2	服务器运行在 http://localhost:3000/ 请在浏览器中访问此地址。

现在，打开你的Web浏览器，在地址栏中输入http://localhost:3000/并回车。你将看到浏览器页面上显示“Hello, World from Node.js Server!”。恭喜你，你已经成功创建并运行了你的第一个Node.js Web服务器！

3. 处理不同的请求路径

一个真实的Web应用通常需要处理不同的URL路径，例如/（首页）、/about（关于我们）、/contact（联系我们）等。我们可以通过检查请求对象的req.url属性来判断请求的路径，并根据不同的路径发送不同的响应。

修改server.js文件如下：

// server.js

const http = require("http");
const port = 3000;

const server = http.createServer((req, res) => {
    // 根据请求的URL路径发送不同的响应
    if (req.url === "/") {
        res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
        res.end("<h1>欢迎来到首页！</h1><p>这是一个Node.js服务器。</p>");
    } else if (req.url === "/about") {
        res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
        res.end("关于我们：我们致力于提供优质的Node.js教程。");
    } else if (req.url === "/api/data") {
        // 发送JSON数据
        res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
        const data = {
            name: "Node.js Server",
            version: "1.0.0",
            message: "这是来自API的数据。"
        };
        res.end(JSON.stringify(data));
    } else {
        // 处理未找到的路径（404 Not Found）
        res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
        res.end("404 Not Found - 抱歉，您访问的页面不存在。");
    }
});

server.listen(port, () => {
    console.log(`服务器运行在 http://localhost:${port}/`);
    console.log("请在浏览器中访问以下地址：");
    console.log(`- http://localhost:${port}/`)
    console.log(`- http://localhost:${port}/about`)
    console.log(`- http://localhost:${port}/api/data`)
});

保存文件后，重新运行node server.js。现在，你可以在浏览器中尝试访问http://localhost:3000/、http://localhost:3000/about和http://localhost:3000/api/data，看看不同的响应。

4. 处理请求方法

除了请求路径，我们还可以根据请求方法（GET、POST等）来处理请求。req.method属性可以获取请求方法。

// server.js (部分代码，仅展示请求方法处理)

const http = require("http");
const port = 3000;

const server = http.createServer((req, res) => {
    if (req.url === "/submit") {
        if (req.method === "POST") {
            let body = ";
            req.on("data", chunk => {
                body += chunk.toString();
            });
            req.on("end", () => {
                console.log("接收到的POST数据:", body);
                res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
                res.end("数据已接收！");
            });
        } else {
            res.writeHead(405, { "Content-Type": "text/plain; charset=utf-8" });
            res.end("Method Not Allowed - 请使用POST请求。");
        }
    } else {
        res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
        res.end("Hello, World!");
    }
});

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

要测试POST请求，你可以使用Postman、Insomnia等API测试工具，或者编写一个简单的HTML表单。

5. 错误处理

在实际应用中，服务器可能会遇到各种错误。良好的错误处理机制可以提高应用的健壮性。你可以监听server对象的error事件来捕获服务器错误。

// server.js (部分代码，仅展示错误处理)

const http = require("http");
const port = 3000;

const server = http.createServer((req, res) => {
    // ... 你的请求处理逻辑
});

server.on("error", (err) => {
    console.error("服务器发生错误:", err);
    // 在这里可以进行更复杂的错误处理，例如记录日志、发送通知等
});

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

总结

通过本篇文章的学习，你已经成功使用Node.js的http模块构建了一个简单的Web服务器，并学会了如何处理不同的请求路径和请求方法。这是你迈向后端开发的重要一步。

虽然这个服务器非常基础，但它展示了Node.js在构建高性能、可伸缩的Web应用方面的潜力。在实际项目中，你通常会使用更高级的Web框架，如Express.js、Koa.js等，它们在http模块的基础上提供了更丰富的功能和更便捷的开发体验。但理解底层http模块的工作原理，对于深入学习Node.js后端开发至关重要。

继续探索Node.js的更多模块和框架，你将能够构建出功能强大、性能卓越的后端应用。

参考文献

[1] Node.js官方文档. HTTP. https://nodejs.org/docs/latest/api/http.html
[2] 菜鸟教程. Node.js Web模块. https://www.runoob.com/nodejs/nodejs-web-module.html

阿舰的博客