learnyounode 实战：基于 Node.js `http` 模块与 `fs.createReadStream()` 构建 HTTP 文件流服务器

• 教程
• CLI

【免费下载链接】learnyounode

Learn You The Node.js For Much Win! An intro to Node.js via a set of self-guided workshops.

项目地址：
https://gitcode.com/gh_mirrors/le/learnyounode

点击查看 免费下载

导读

本文基于 learnyounode 练习项目中的 HTTP 文件服务器（http_file_server）题目展开。该练习要求开发者使用 Node.js 核心模块 http 创建一个 HTTP 服务器，该服务器为每一次请求返回同一个文本文件，并且强制要求使用 fs.createReadStream() 以流（stream）的方式把文件内容直接"管道"给 HTTP 响应，而不是一次性读完整个文件再返回。读完本文后，你将掌握 http.createServer() 的回调签名、request/response 的流属性、src.pipe(dst) 流式传输的核心用法，以及 learnyounode 在验证本题时对 fs.createReadStream() 的源码级检测机制，从而写出既通过验证又具备实战价值的文件服务器。

一、题目要求：面向所有请求返回同一个文件

题目原文（见 exercises/http_file_server/problem.es.md）核心要求如下：

• 编写一个 HTTP 服务器（而非 TCP 服务器），为收到的每一次请求返回同一个文本文件；
• 服务器监听的端口号来自命令行第一个参数（process.argv[2]）；
• 要返回的文件路径来自命令行第二个参数（process.argv[3]）；
• 必须使用 fs.createReadStream() 以流的方式把文件内容写入响应体。

与早期练习（如 my_first_io 的同步读文件、my_first_async_io 的异步读文件）不同，本题刻意强调"流式传输"：文件可能很大，正确做法是把文件流与响应流直接连接，而不是把整个文件读进内存再一次性 end() 出去。

对应的英文原版见 exercises/http_file_server/problem.md，其中还补充了一句关键信息：程序文件名应为 http-file-server.js，验证命令为：

$ {appname} verify http-file-server.js

在 learnyounode 中 {appname} 即 learnyounode，因此实际操作时运行：

$ learnyounode verify http-file-server.js

二、核心 API：http.createServer() 与回调签名

由于要创建的是 HTTP 服务器而不是通用 TCP 服务器，应使用 Node 核心模块 http。它和 net 模块类似，同样提供 http.createServer() 方法，区别在于它所创建的服务器使用 HTTP 协议通信。

http.createServer() 接收一个回调函数，该回调在服务器每一次收到连接时被调用，签名如下：

function callback (request, response) { /* … */ }

两个参数分别是代表本次 HTTP 请求与对应响应的对象：

• request：用于获取请求相关信息，例如请求头（header）和查询字符串（query-string）；
• response：用于向客户端返回数据，包括响应头部（headers）和响应体（body）。

关键点：request 和 response 都是 Node 流（stream）！这意味着可以直接使用流式抽象来收发数据——这正是本题能用 pipe 连接文件流与响应流的理论基础。

http.createServer() 返回 server 实例，需要调用 server.listen(portNumber) 开始监听指定端口。题目给出的典型模板：

const http = require('http')
const server = http.createServer(function (req, res) {
// 处理请求的逻辑…
})
server.listen(8000)

http 模块的完整文档存放在本仓库 docs-nodejs/http.html，可对照查阅 createServer、response 流式接口等细节。

三、流式文件传输：fs.createReadStream() 与 src.pipe(dst)

fs 核心模块提供面向文件的流式 API。题目要求使用 fs.createReadStream() 为命令行参数指定的文件创建读取流，该方法返回一个 Readable 流对象；随后借助管道语法 src.pipe(dst) 把数据从源流 src 传输到目标流 dst。

在本场景中，源流是文件系统流，目标流是 HTTP 响应流，一句代码即可完成连接：

fs.createReadStream(process.argv[3]).pipe(res)

这样做的好处是：文件数据以小块（chunk）方式边读边发，内存占用与文件大小无关，浏览器端也能尽早收到数据。

四、完整可运行的标准答案

仓库中 exercises/http_file_server/solution/solution.js 给出了官方标准解法，全文如下：

'use strict'
const http = require('http')
const fs = require('fs')

const server = http.createServer(function (req, res) {
res.writeHead(200, { 'content-type': 'text/plain' })

fs.createReadStream(process.argv[3]).pipe(res)
})

server.listen(Number(process.argv[2]))

逐行解读：

注意两点：端口参数建议显式用 Number() 转换；文件路径为 process.argv[3]，因为 argv[0] 是 node 可执行文件、argv[1] 是脚本路径。

五、代码实现细节与边界注意

1. 为什么不能只用 fs.readFileSync 一次性读完

虽然用 fs.readFileSync() 也能"返回文件内容"，但这样做：一是把整个文件载入内存，大文件场景下内存不可控；二是阻塞了事件循环；三是不符合本题的显式约束。learnyounode 的验证器甚至会专门检测这一行为（见下文第六节），因此必须使用 fs.createReadStream()。

2. response 流的结束时机

使用 pipe 时，管道机制会自动在源流结束后调用 res.end() 结束响应，无需手动管理。若改用 res.write() 逐块写入，则必须自行在数据读完时调用 res.end()。

3. 错误处理（延伸建议）

文件不存在或读取失败时，管道不会自动向客户端报错。更健壮的做法是监听流的 error 事件并设置适当的响应状态码：

const stream = fs.createReadStream(process.argv[3])
stream.on('error', function () {
res.statusCode = 500
res.end('Internal Server Error')
})
stream.pipe(res)

标准答案未包含错误处理以保持简洁，但这是生产环境的重要补充。

六、源码级验证机制：如何确认你用了 createReadStream

本题的验证逻辑在 exercises/http_file_server/exercise.js 中实现，理解它有助于写出能通过验证的程序。

1. 测试数据与随机端口

验证器在 addSetup 阶段会：

• 调用 lib/rndport.js 中的 rndport() 生成随机端口（实现为 1024 + Math.floor(Math.random() * 64511)，即 1024～65534 之间），solution 与被测程序各用一个端口；
• 用 boganipsum 生成一段随机文本，写入系统临时目录下的 _learnyounode_<pid>.txt 文件，作为两个进程共同使用的测试文件；
• 把端口和文件路径依次 unshift 到被测程序与标准解的命令行参数中，对应代码中的 process.argv[2]（端口）与 process.argv[3]（文件路径）。

测试结束后通过 rimraf 清理临时文件。

2. 探测与对比

验证器在延迟 500ms（等待服务器启动）后，使用 hyperquest 向两个端口发起 HTTP 请求，并在 5 秒超时后结束响应流；随后通过 comparestdout 对比被测程序与标准解输出的内容是否一致，因此返回的文件内容必须与标准答案完全相同（包括换行与随机文本本身）。

3. createReadStream 的强制检测

验证器通过 wrappedexec 在被测进程启动前注入 exercises/my_first_io/wrap.js 这个包装模块。该模块遍历 fs（及 fs.promises、util）的所有方法并逐一包裹，借助调用栈判断用户主程序是否调用了对应 fs 方法，把调用记录保存在 ctx.fsCalls 中。

随后，exercise.js 中的 addVerifyProcessor 对所有被记录的非 createReadStream 的 fs 调用逐一触发失败提示 fail.no_createReadStream，并要求 badCalls.length === 0 才算通过：

const badCalls = Object.keys(exercise.wrapData.fsCalls).filter(function (m) {
exercise.emit('fail', exercise.__('fail.no_createReadStream', { method: 'fs.' + m + '()' }))
return !(/createReadStream/).test(m)
})
callback(null, badCalls.length === 0)

即：凡是被检测到的 fs 调用，方法名都必须匹配 createReadStream，否则验证失败。这意味着使用 fs.readFileSync、fs.readFile 等任何其他 fs 方法都会被判定为错误答案。

4. 测试用例佐证

仓库 test/http_file_server 目录下的用例印证了上述判定规则：

• test/http_file_server/valid_01.js：合法实现，通过 require('fs').createReadStream(process.argv[3]).pipe(res) 流式返回文件，并且用 process.argv[2] | 0 把端口参数转成整数；
• test/http_file_server/invalid_02.js：错误实现，在服务器回调外先调用 fs.readFileSync(process.argv[3])，响应中又用 res.end(require('fs').readFileSync(…)) 一次性返回，属于典型反例；
• test/http_file_server/invalid_03.js：另一错误实现，错把文件路径当作 process.argv[2] 读取，并同样使用 readFileSync 而非流。

对比 valid_01.js 与两个 invalid 用例，可以直观看出"用 createReadStream 管道 + 正确索引命令行参数"是本题唯一通过路径。

七、常见错误与排查建议

八、小结

http_file_server 是 learnyounode 中从"读文件"走向"写服务器"的关键一环：它同时考察了 http 模块的服务器创建、request/response 的流本质、fs.createReadStream() 的文件流 API 以及 pipe 管道传输。从仓库源码可以确认，其验证器不仅对比输出内容，还会通过包装 fs 方法的方式强制检测 createReadStream 的使用，体现了 learnyounode 强调正确技术选型（流式而非整读）的设计意图。掌握本题后，你可以自然过渡到后续 http_uppercaserer、http_json_api_server 等基于 HTTP 流的进阶练习。

延伸阅读

• HTTP 文件服务器题目（英文）
• HTTP 文件服务器题目（简体中文）
• 标准答案
• 验证器实现
• fs 方法包装检测模块
• 随机端口工具
• Node.js http 模块文档（仓库镜像）
• nodejs 官方文档镜像目录

赞

分享

• 教程
• CLI

【免费下载链接】learnyounode

Learn You The Node.js For Much Win! An intro to Node.js via a set of self-guided workshops.

项目地址：
https://gitcode.com/gh_mirrors/le/learnyounode

点击查看 免费下载

相关推荐

• learnyounode 实战：用 Node.js http 模块与 fs.createReadStream 构建 HTTP 文件服务器（HTTP FILE SERVER）

  learnyounode 实战：用 Node.js http 模块与 fs.createReadStream 构建 HTTP 文件服务器（HTTP FILE S

  教程
  CLI

• learnyounode 实战：用 Node http 模块与 fs.createReadStream 构建 HTTP 文件服务器

  learnyounode 实战：用 Node http 模块与 fs.createReadStream 构建 HTTP 文件服务器 本文基于 learnyoun

  教程
  CLI

• learnyounode 实战：用 Node.js 的 `http` 模块与 `fs.createReadStream()` 构建 HTTP 文件服务器（http_file_server 练习）

  learnyounode 实战：用 Node.js 的 http 模块与 fs.createReadStream 构建 HTTP 文件服务器（http_file

  教程
  CLI

上一篇：
Umi-OCR快速上手指南：5分钟掌握离线OCR核心技巧

下一篇：
Python通达信数据获取完整教程：从零开始掌握金融数据分析

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考