本文深入探讨了Node.js中使用`http.createServer`时常见的配置错误和响应处理问题。我们将详细讲解如何正确地将请求监听器函数传递给服务器实例，并强调在构建HTTP响应时，确保内容类型（Content-Type）与实际发送的数据（如HTML或JSON）保持一致的重要性，避免发送冲突的数据类型，从而确保客户端能够正确接收并渲染服务器响应。
理解 http.createServer 的正确用法
在使用 Node.js 的 http 模块创建服务器时，http.createServer 方法期望接收一个请求监听器函数作为其核心参数。这个函数会在每次接收到HTTP请求时被调用，并接收 req (请求) 和 res (响应) 对象作为参数。
一个常见的错误是，开发者可能无意中传递了一个空的匿名函数，而不是他们定义好的请求处理函数。例如，以下代码片段展示了这种不正确的用法：
const functionListener = (req,res)=>{
// ... 请求处理逻辑 ...
};
const server = http.createServer(options, functionListener => {
// 这是一个空的匿名函数，与外部的 functionListener 无关
});在这个例子中，http.createServer 接收到的第二个参数是一个箭头函数 functionListener => {}。这个箭头函数内部是空的，并且其参数 functionListener 只是一个局部变量，与外部定义的 functionListener 函数没有任何关联。因此，服务器启动后，任何请求都不会触发预期的处理逻辑。
正确的做法是直接传递已定义好的请求监听器函数的引用：
const http = require('http'); // 确保引入 http 模块
const functionListener = (req, res) => {
// ... 实际的请求处理逻辑 ...
};
// 正确地传递 functionListener 函数的引用
const server = http.createServer(options, functionListener);通过这种方式，当服务器接收到请求时，http.createServer 将会调用 functionListener 函数，并将 req 和 res 对象传递给它，从而执行预期的请求处理逻辑。
规范 HTTP 响应处理：Content-Type 与数据一致性
在处理 HTTP 响应时，确保响应头中的 Content-Type 与实际发送的响应体数据类型一致至关重要。这告诉客户端（如浏览器）如何解析和渲染接收到的数据。
原始代码中存在一个问题，它尝试在同一个请求路径下发送两种不同类型的数据：HTML 和 JSON。
if (req.url == '/') {
res.writeHead(200, "succeeded",{ 'Content-Type': 'text/plain' }); // 注意这里是 text/plain
res.write('This is default Page.
'); // 发送 HTML
res.end(JSON.stringify({ data: 'default!' })); // 接着发送 JSON
}这里存在几个问题：
- Content-Type 不匹配： res.writeHead 设置的 Content-Type 是 text/plain，但随后 res.write 发送的是 HTML 字符串，紧接着 res.end 发送的是 JSON 字符串。浏览器在接收到 text/plain 后，可能不会正确渲染 HTML，也无法解析 JSON。
- 混合响应体： 在同一个响应中先 res.write HTML，再 res.end JSON 是不规范的。res.write 用于逐步发送响应体，而 res.end 则标志着响应体的结束，并且可以发送最后一部分数据。一旦调用 res.end，响应就完成了，不能再写入数据。在上述代码中，res.end 会将 JSON.stringify 的结果追加到 res.write 发送的 HTML 之后，形成一个混合且无效的响应体。
正确处理响应的原则：
- 选择单一的响应类型： 对于一个特定的请求，服务器应该返回单一、明确的数据类型。
- 设置正确的 Content-Type： 在 res.writeHead 或 res.setHeader 中设置的 Content-Type 必须与响应体的数据类型匹配。
- 使用 res.end() 完成响应： res.end() 应该在所有响应数据发送完毕后调用，它会关闭响应流。如果 res.end() 带有参数，该参数会被作为最后一部分响应体发送。
示例：发送 HTML 响应
// 当请求路径为 '/' 时，发送 HTML 页面
if (req.url === '/') {
res.writeHead(200, { 'Content-Type': 'text/html' });
res.end('Welcome to the Default Page!
This is a simple HTML response.
');
}示例：发送 JSON 响应
// 当请求路径为 '/api/data' 时，发送 JSON 数据
if (req.url === '/api/data') {
res.writeHead(200, { 'Content-Type': 'application/json' });
const data = { message: 'Hello API', timestamp: new Date().toISOString() };
res.end(JSON.stringify(data));
}完整且规范的服务器示例
结合以上修正，以下是一个功能完整且符合最佳实践的 Node.js HTTP 服务器示例：
const http = require('http');
const port = 3000; // 定义端口号
const options = {
keepAlive: true, // 保持连接活跃
};
// 请求监听器函数
const requestListener = (req, res) => {
console.log(`Received request for: ${req.url}`);
if (req.url === '/') {
// 返回 HTML 响应
res.writeHead(200, { 'Content-Type': 'text/html' });
res.end('Welcome to the Default Page!
This is a simple HTML response.
');
} else if (req.url === '/hello') {
// 返回 JSON 响应
res.writeHead(200, { 'Content-Type': 'application/json' });
const data = { message: 'Hello World!', source: 'Node.js Server' };
res.end(JSON.stringify(data));
} else {
// 处理未匹配的路由
res.writeHead(404, { 'Content-Type': 'text/plain' });
res.end('404 Not Found');
}
};
// 正确创建服务器实例，并传递请求监听器函数
const server = http.createServer(options, requestListener);
// 启动服务器并监听指定端口
server.listen(port, () => {
console.log(`Server running at http://localhost:${port}/`);
});总结
通过本文的讲解，我们强调了在 Node.js 中使用 http.createServer 构建 Web 服务器时的两个关键点：
- 正确传递请求监听器： 确保将实际的请求处理函数引用传递给 http.createServer，而不是一个空的匿名函数。
- 规范 HTTP 响应处理： 始终确保 Content-Type 响应头与实际发送的数据类型（如 text/html 或 application/json）相匹配，并且避免在单个响应中混合发送不同类型的数据。使用 res.end() 来正确地结束响应。
遵循这些最佳实践，可以有效避免服务器不响应或客户端无法正确解析响应的问题，从而构建健壮可靠的 Node.js HTTP 服务。
