Node.js 代码实战:用 http 模块从零搭建 HTTP 服务器(千古前端图文教程)

原创2026-10-02 23:50:411,690 阅读
文章标签:文档教程前端

Node.js 代码实战:用 http 模块从零搭建 HTTP 服务器(千古前端图文教程)

本篇教程以《千古前端图文教程》中「Node.js 代码举例」为核心,从两个可直接运行的 JS 文件出发,逐步演示如何用 Node.js 内置的 http 模块创建服务器、监听端口、响应浏览器请求,并深入剖析 createServer 回调中的 request / response 两个参数。读完本文,你将掌握 Node.js 搭建 HTTP 服务器的最小可运行代码,并能顺着示例进一步组合 fs、path、MySQL 等模块,构建出真正能读写文件、操作数据库的完整服务端程序。

一、写服务器之前:先认识 Node.js 的内置模块与 CommonJS

Node.js 是 JavaScript 在服务器端的运行环境(平台),它跳过了 Apache、Nginx 等独立 HTTP 服务器软件,直接具备搭建 Web 服务的能力。这一点在仓库的 01-Node.js介绍.md 中有详细说明。前端同学学 Node.js 的第一个典型场景,就是用 JS 写一个自己的 HTTP 服务器。

Node.js 应用由模块组成,采用 CommonJS 模块规范。模块分为三类:内置模块、第三方模块、自定义模块。本文用到的 http 就是 Node.js 自带的内置模块,与 fs(文件系统)、path(路径)、os(操作系统)、net(网络)等并列,具体分类说明可参考 05-Node.js内置模块:fs文件模块.md。

内置模块通过 require() 加载,这也是 CommonJS 规范的核心语法(详见 04-Node.js模块化规范:CommonJS.md):

const http = require('http');  // 引入 node.js 里面的一个 http 包。因为引入之后,我们不会去修改它,所以用常量来表示

注意两点:

  • require 内置模块时传入的是包名(http),而不是文件路径;只有引入自定义模块时才需要写路径(如 require('./main.js'))。
  • 因为 require 返回的模块对象后续不会被重新赋值,所以用 const 声明,这是一种更安全的习惯。

二、第一个 HTTP 服务器:http.createServer() + server.listen()

新建一个文件 server01.js,输入如下代码:

const http = require('http');  // 引入 node.js 里面的一个 http 包。因为引入之后,我们不会去修改它,所以用常量来表示

// 创建一台服务器
var server = http.createServer(function () {   // 当有人来访问这台服务器时,就会执行 function 回调函数
    console.log('有人来访问我了');
});

server.listen(8080);   // 要让服务器设置为监听状态,端口设置为 8080

注意看注释。这段代码虽然只有三行,却完整地走完了“创建服务器 → 设置监听端口”的全过程:

  • http.createServer(callback):创建一台 HTTP 服务器。传入的 callback 是请求回调函数——每当有请求访问这台服务器时,回调函数就会执行一次。
  • server.listen(8080):让服务器进入监听状态,端口设置为 8080。端口号可以任意指定(避开已被占用的端口即可),浏览器端访问时需要用同一个端口。

如何运行并验证

把上面的 JS 文件跑起来,然后在浏览器端输入 http://localhost:8080/:

node server01.js

每请求一次,服务器的控制台就会打印一次 有人来访问我了。也就是说,你在浏览器里每刷新一次页面,Node 进程的终端里就会多出一行日志。

这里体现的正是 Node.js 的事件驱动、非阻塞 I/O 模型:服务器创建后并不会阻塞等待,而是把“处理请求”交给回调函数,请求到达时由事件循环调度执行。相关背景可参阅 01-Node.js介绍.md。

三、向浏览器输出内容:response.write() 和 response.end()

上面的服务器只会打印日志,浏览器访问时看不到任何内容。接下来,我们把代码修改如下,新建 server02.js:

const http = require('http');

// 创建一台服务器
var server = http.createServer(function (request, response) {   // 当有人来访问这个服务器时,就会执行 function 这个回调函数
    console.log('有人来访问我了');

    response.write('smyhvae');  // 向浏览器输出内容
    response.end();   // 结束了,浏览器你走吧。

});

server.listen(8080);

function 回调函数里可以设置两个参数:request 和 response。其中:

  • request(请求对象):封装了浏览器发来的请求信息,比如请求路径、请求方法、请求头等。
  • response(响应对象):用来向浏览器输出内容。

response.write() 表示向浏览器输出一些内容,可以多次调用,连续输出多段内容;response.end() 表示响应结束,浏览器收到“结束”信号后才会完成这次请求的展示。如果只调用 write() 而不调用 end(),浏览器会一直处于等待状态。

运行后暴露出的问题

将上面的 JS 代码跑起来,访问浏览器时你会发现一个现象:无论我们在浏览器端输入 http://localhost:8080/1.html,还是输入 http://localhost:8080/2.jpg,浏览器上显示的都是 smyhvae。

原因很简单:当前的服务器没有读取 request 中的任何信息,它对所有路径的请求都一视同仁,统一返回同一段内容。要解决这个问题,就需要根据请求的路径(request.url)分发不同的响应,这正是下一节要做的。

四、进阶:根据 request.url 区分不同请求

承接上文的问题——服务器需要知道“用户访问的是哪个路径”,才能返回对应的内容。Node.js 的 request 对象上有一个 url 属性,保存了本次请求的路径。基于这一点,我们对代码做如下增强:

const http = require('http');

// 创建一台服务器
var server = http.createServer(function (request, response) {
    console.log('有人来访问我了,请求路径是:' + request.url);

    // 根据不同的请求路径,返回不同的内容
    if (request.url === '/1.html') {
        response.write('这是 1.html 页面的内容');
    } else if (request.url === '/2.jpg') {
        response.write('这是 2.jpg 图片的响应');
    } else {
        response.write('404 Not Found');
    }

    response.end();
});

server.listen(8080);

运行后:

  • 访问 http://localhost:8080/1.html → 浏览器显示“这是 1.html 页面的内容”;
  • 访问 http://localhost:8080/2.jpg → 浏览器显示对应的响应内容;
  • 访问其他任意路径 → 浏览器显示 404 Not Found。

这就是最原始的“路由分发”逻辑。真实项目里通常借助 Express、Koa 等框架做更完善的路由,但底层原理就是基于 request.url(以及 request.method)的判断。

五、实战组合:服务器 + fs 读取文件 + path 拼接路径

真实的 Web 服务器不会把内容硬编码在 write() 里,而是从磁盘读取 HTML 文件再返回。Node.js 内置的 fs(文件系统)模块恰好提供了这个能力。仓库的 05-Node.js内置模块:fs文件模块.md 详细讲解了文件读取,其中异步读取的语法格式为:

fs.readFile(file[, options], callback(error, data))

把 http 与 fs 组合起来,就是一个最简“静态文件服务器”的雏形:

const http = require('http');
const fs = require('fs');

var server = http.createServer(function (request, response) {
    // 异步读取当前目录下的 index.html,再把内容返回给浏览器
    fs.readFile('index.html', 'utf8', function (err, data) {
        if (err) {
            response.write('文件读取失败:' + err.message);
        } else {
            response.write(data);   // 把整个 HTML 文件内容输出给浏览器
        }
        response.end();
    });
});

server.listen(8080);

这样,你只要在 server01.js / server02.js 的同级目录放一个 index.html,访问 http://localhost:8080/ 就能看到页面的真实渲染效果,而不是一行字符串。

如果需要嵌套读取多个文件(比如同时读取 HTML 和 CSS),可以用 Promise 或 async ... await 封装 fs.readFile,这一写法的完整代码同样在 05-Node.js内置模块:fs文件模块.md 中(包含 fsRead() 的 Promise 封装与 async function ReadList() 两种写法)。

另外,在实际开发中,手动拼接文件路径很容易出错,推荐使用 path 模块。仓库的 06-Node.js内置模块:path路径模块.md 给出了常用 API,其中有两个在服务器场景下非常实用:

  • __dirname:当前执行文件所在的完整目录(常量);
  • path.join():用平台特定的分隔符拼接多个路径片段,并规范化结果。

例如,把上面的读取路径改得更严谨:

const path = require('path');

// 拼接出 index.html 的完整路径,避免受启动目录影响
let filePath = path.join(__dirname, 'index.html');
fs.readFile(filePath, 'utf8', function (err, data) { /* ... */ });

六、客户端视角:浏览器如何请求这台服务器

服务器写好了,浏览器端怎么请求它?这正是 Ajax 的用武之地。仓库的 02-Ajax入门和发送http请求.md 系统讲解了浏览器端发起 HTTP 请求的五个步骤:创建 XMLHttpRequest 对象 → open() 设置请求方法与 URL → send() 发送请求 → 注册 onreadystatechange 事件 → 服务端响应、获取返回数据。

把客户端代码与本文的服务器对接起来,就构成了完整的前后端交互链路:

// 浏览器端(index.html 中)请求 Node.js 服务器
var xmlhttp = new XMLHttpRequest();

// 请求本机的 Node 服务器,端口与 server.listen(8080) 保持一致
xmlhttp.open('get', 'http://localhost:8080/1.html');

xmlhttp.send();

xmlhttp.onreadystatechange = function () {
    // readyState 为 4 且 status 为 200,表示响应已就绪
    if (xmlhttp.readyState == 4 && xmlhttp.status == 200) {
        console.log('数据返回成功:' + xmlhttp.responseText);
    }
};

在这个例子中,服务器端通过 response.write() 输出的内容,就是客户端 responseText 拿到的字符串。理解这条“浏览器发请求 → Node 服务器回调 → response 回写 → 浏览器收数据”的链路,是前后端联调的基础。

七、服务端的数据来源:Node.js 连接 MySQL 数据库

当服务器需要返回动态数据(而不是静态文件)时,数据通常来自数据库。仓库的 07-Node.js操作MySQL数据库.md 演示了 Node.js 连接 MySQL 并执行增删改查的完整流程,核心套路是三步:

const mysql = require("mysql");

// 1、配置连接参数
let options = {
    host: "localhost",
    // port: "3306", // 可选,默认 3306
    user: "root",
    password: 'xxx', // 这里改成你自己的数据库连接密码
    database: "qiangu_database",
};

// 2、创建连接对象并建立连接
let connection = mysql.createConnection(options);
connection.connect((err) => {
    if (err) {
        console.log(err);           // 数据库连接失败
    } else {
        console.log("数据库连接成功");
    }
});

// 3、执行 SQL 语句
let strSql = 'select * from qiangu_student_table';
connection.query(strSql, (err, result) => {
    if (err) {
        console.log(err);
    } else {
        console.log('查询结果:' + JSON.stringify(result));
    }
});

把这段数据库逻辑放进本文的 http.createServer 回调中,就能实现“浏览器请求 → 服务器查库 → 返回 JSON 数据”的动态接口:

const http = require('http');
const mysql = require('mysql');

var server = http.createServer(function (request, response) {
    let connection = mysql.createConnection({ /* host、user、password、database 等配置 */ });
    connection.query('select * from qiangu_student_table', (err, result) => {
        if (err) {
            response.write(JSON.stringify({ code: 500, msg: err.message }));
        } else {
            response.write(JSON.stringify(result));   // 把查询结果以 JSON 返回
        }
        response.end();
        connection.end();   // 释放连接
    });
});

server.listen(8080);

备注:如果连接时提示 Client does not support authentication protocol requested by server,需要在 MySQL 终端执行 ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password'; 后再 flush privileges;,具体说明见 07-Node.js操作MySQL数据库.md。

八、小结

本文从两个最小可运行的代码文件出发,走通了 Node.js 服务端开发的完整入门链路:

阶段 核心 API / 模块 效果
建服务器 http.createServer(callback) + server.listen(8080) 监听端口,请求到达时触发回调
输出内容 response.write() + response.end() 向浏览器返回内容并结束响应
路径分发 request.url 根据访问路径返回不同内容
静态文件 fs.readFile() + path.join() / __dirname 读取磁盘文件并返回给浏览器
前后端交互 浏览器端 XMLHttpRequest 请求 Node 服务器并接收响应
动态数据 mysql 模块 + connection.query() 查询数据库并返回 JSON 数据

如果你想继续深入,仓库中以下文档与本篇主题直接相关,可作为延伸阅读:

把 http 服务器的“骨架”,配上 fs 的“静态内容”、mysql 的“动态数据”、Ajax 的“客户端入口”,你就已经具备用 JavaScript 独立搭建一个前后端联通的小型 Web 服务的能力了。

登录后查看全文
Web