本文旨在解决node.js中使用http.createserver构建服务器时遇到的请求无响应问题。核心内容包括纠正服务器监听函数的错误传递方式，以及规范http响应内容的设置，特别是避免同时发送冲突的content-type类型（如html和json）。通过详细的代码示例和最佳实践，帮助开发者构建稳定、正确的node.js http服务器。
理解 http.createServer 的工作原理
在Node.js中，http模块提供了创建HTTP服务器的能力。http.createServer() 方法用于创建一个新的 Server 实例，它接受一个请求监听函数作为参数。当服务器接收到每个HTTP请求时，这个监听函数都会被调用，并接收 request (req) 和 response (res) 对象作为参数，允许开发者处理请求并发送响应。
原始代码中遇到的无响应问题，主要源于两个核心误区：监听函数传递错误 和 响应内容类型冲突。
误区一：错误的监听函数传递方式
原始代码中创建服务器的方式如下：
const server = http.createServer(options,functionListener => {
});这里的关键错误在于 functionListener => {}。虽然这个匿名箭头函数的参数被命名为 functionListener，但这仅仅是该匿名函数的局部参数名，它与外部定义的 functionListener 函数（即您真正想作为请求处理器使用的函数）没有任何关联。实际上，您传递给 http.createServer 的是一个空的匿名函数，导致服务器在接收到请求时，执行的处理器内部没有任何逻辑来发送响应。
正确做法：传递函数引用
要将您定义的 functionListener 作为服务器的请求处理器，您需要直接传递该函数的引用。
const functionListener = (req,res)=>{
// ... 您的请求处理逻辑 ...
};
const server = http.createServer(options, functionListener);这样，当服务器接收到请求时，就会正确地调用您定义的 functionListener 函数来处理请求。
误区二：响应内容类型冲突
在 functionListener 内部，原始代码在同一个请求路径下尝试发送两种不同类型的响应：
// ...
if (req.url == '/') {
res.writeHead(200, "succeeded",{ 'Content-Type': 'text/plain' }); // 设置为 text/plain
res.write('This is default Page.
'); // 发送 HTML
res.end(JSON.stringify({ // 发送 JSON
data: 'default!',
}));
}
// ...这里存在两个问题：
- Content-Type 不匹配： res.writeHead 设置的 Content-Type 是 text/plain，但 res.write 发送的是HTML字符串，res.end 发送的是JSON字符串。浏览器或客户端会根据 Content-Type 头部来解析响应体。如果 Content-Type 声明为纯文本，但内容是HTML或JSON，可能会导致解析错误或显示异常。
- 多次 res.end() 或混合 res.write() 和 res.end() 的内容： res.end() 标志着响应的结束。在一个请求处理流程中，通常只调用一次 res.end()。如果在 res.end() 之前调用 res.write()，res.write() 的内容会被追加到响应体中，然后 res.end() 的内容会紧随其后。但更重要的是，您应该选择一种统一的响应格式。
正确做法：选择单一且匹配的响应类型
根据您的需求，决定是返回HTML页面还是JSON数据，并设置相应的 Content-Type。
示例：返回 HTML 页面
const functionListener = (req, res) => {
res.statusCode = 200; // 更推荐直接设置 statusCode 属性
if (req.url === '/') {
res.setHeader('Content-Type', 'text/html'); // 设置为 HTML
res.end('This is default Page.
');
} else if (req.url === '/hello') { // 使用 else if 避免多个条件同时满足
res.setHeader('Content-Type', 'text/html');
res.end('This is hello Page.
');
} else {
res.statusCode = 404;
res.setHeader('Content-Type', 'text/plain');
res.end('404 Not Found');
}
};示例：返回 JSON 数据
const functionListener = (req, res) => {
res.statusCode = 200;
if (req.url === '/') {
res.setHeader('Content-Type', 'application/json'); // 设置为 JSON
res.end(JSON.stringify({ data: 'default!' }));
} else if (req.url === '/hello') {
res.setHeader('Content-Type', 'application/json');
res.end(JSON.stringify({ data: 'Hello World!' }));
} else {
res.statusCode = 404;
res.setHeader('Content-Type', 'application/json');
res.end(JSON.stringify({ error: 'Not Found' }));
}
};注意事项：
- res.writeHead(statusCode, statusMessage, headers) 方法可以一次性设置状态码、状态消息和头部。如果只设置状态码和头部，可以直接使用 res.writeHead(statusCode, headers)。
- res.setHeader(name, value) 用于设置单个响应头。
- res.statusCode 属性可以直接设置响应状态码。
- 始终在发送完所有响应内容后调用 res.end() 来结束响应。
- 为了避免一个请求被多个 if 条件处理，导致多次尝试发送响应，推荐使用 if...else if...else 结构进行路由匹配。
完整且修复后的服务器示例
结合上述修复和最佳实践，一个功能完整且正确的Node.js HTTP服务器代码示例如下：
const http = require('http'); // 引入 http 模块
const port = 3000;
// 服务器选项，例如 keepAlive
const options = {
keepAlive: true,
};
// 请求监听函数
const functionListener = (req, res) => {
// 打印调试信息，res.headersSent 和 res.statusCode 是属性，不是方法
console.log("headerSent:", res.headersSent);
console.log("statusCode :", res.statusCode);
// 根据请求 URL 进行路由
if (req.url === '/') {
// 设置响应头和状态码
res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
// 发送 HTML 内容
res.end('This is default Page.
');
} else if (req.url === '/hello') {
res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
// 发送 JSON 内容
res.end(JSON.stringify({ data: 'Hello World!' }));
} else {
// 处理未匹配的路径
res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
res.end('404 Not Found');
}
};
// 创建服务器，并正确传递监听函数
const server = http.createServer(options, functionListener);
// 监听指定端口
server.listen(port, () => {
console.log(`Server running at http://localhost:${port}/`);
});
// 错误处理（可选，但推荐）
server.on('error', (err) => {
console.error('Server error:', err);
});通过以上修改，当您访问 http://localhost:3000/ 时，将收到 HTML 页面；访问 http://localhost:3000/hello 时，将收到 JSON 数据；访问其他路径时，将收到 404 错误。
总结
解决Node.js http.createServer 无响应问题，关键在于：
- 正确传递监听函数： 确保将实际的请求处理函数引用传递给 http.createServer()，而不是一个空的匿名函数。
-
规范响应处理：
- 根据预期的内容类型（HTML、JSON、纯文本等）设置正确的 Content-Type 头部。
- 在一个请求处理流程中，通常只调用一次 res.end() 来完成响应，并且在 res.end() 之前，所有 res.write() 的内容都应是该响应的一部分。
- 使用 if...else if...else 结构进行路由，确保每个请求只被处理一次，避免发送冲突的响应。
遵循这些原则，将有助于您构建稳定、可预测的Node.js HTTP服务器。
