01-hello-world-http-server

知识库
知识库文档
/tech-stacks/nodejs/examples/01-hello-world-http-server.md

文档

Node.js Hello World — HTTP 服务器

目标

用 Node.js 内置 http 模块创建一个最简单的 Web 服务器,监听 3000 端口,返回 JSON 格式的 "Hello World"。

完整代码

// server.js
const http = require('http');

const hostname = '127.0.0.1';
const port = 3000;

const server = http.createServer((req, res) => {
  // 设置响应头
  res.statusCode = 200;
  res.setHeader('Content-Type', 'application/json');

  // 路由分发
  if (req.url === '/') {
    res.end(JSON.stringify({ message: 'Hello World', timestamp: Date.now() }));
  } else if (req.url === '/health') {
    res.end(JSON.stringify({ status: 'ok' }));
  } else {
    res.statusCode = 404;
    res.end(JSON.stringify({ error: 'Not Found' }));
  }
});

server.listen(port, hostname, () => {
  console.log(`Server running at http://${hostname}:${port}/`);
});

运行步骤

# 1. 保存上述代码为 server.js

# 2. 直接运行
node server.js

# 3. 另开终端测试
curl http://127.0.0.1:3000/
# 输出: {"message":"Hello World","timestamp":1717000000000}

预期输出

$ node server.js
Server running at http://127.0.0.1:3000/

访问 http://127.0.0.1:3000/ 返回:

{"message":"Hello World","timestamp":1717000000000}

要点说明

  • http.createServer() 创建 HTTP 服务器,传入回调处理每个请求
  • req.url 获取请求路径,可用于简单路由
  • res.setHeader() 设置响应头(JSON API 通常用 application/json
  • server.listen() 绑定端口并启动,第三个参数是启动回调

信息

路径
/tech-stacks/nodejs/examples/01-hello-world-http-server.md
更新时间
2026/5/30