17370845950

Node.js写服务需掌握HTTP、模块加载、异步处理三要素：用原生http模块解析URL/方法/请求体并正确响应；require路径规则与__dirname/path.join规范；Promise必须await或catch，加unhandledRejection兜底。

Node.js 不是“学完就能写服务端”的工具，它只是让 JavaScript 能跑在服务端的运行时；真正要写可用的服务，得先理清 HTTP、模块加载、异步处理这三件事，缺一不可。

从 http.createServer 开始，别碰框架

新手常一上来就装 Express，结果连请求体怎么读都不清楚。先用原生 http 模块跑通一个能接收 GET 参数、返回 JSON 的最小服务：

• req.url 是原始路径，含查询参数，需手动解析（url.parse(req.url, true) 或 new URL()）
• req.method 判断是 GET 还是 POST，POST 需监听 data 和 end 事件拼接 body
• 响应前必须调用 res.writeHead(200, {'Content-Type': 'application/json'})，漏掉会卡住客户端
• 每次响应后必须调用 res.end()，不写这句，连接不会关闭

模块加载不是“import 就完事”，require 有路径规则

Node.js 的 require 不走 ESM 规范，路径没扩展名时默认找 .js → .json → index.js，容易栽在这些地方：

• require('./utils') 会尝试加载 ./utils.js，如果实际是 ./utils/inde

  

  x.ts，直接报错
• require('lodash') 查找顺序：当前目录 node_modules → 父级 node_modules → 一直向上，直到根目录或找不到
• __dirname 是当前模块所在目录绝对路径，__filename 是文件绝对路径，拼接路径务必用 path.join(__dirname, 'config.json')，别用字符串拼接

异步操作不加 await 或 catch，进程大概率静默退出

Node.js 里一个未捕获的 Promise rejection 就会让进程崩掉（v15+ 默认行为），尤其在文件读写、数据库连接、HTTP 请求时：

• fs.readFile 返回 Promise 时，必须用 try/catch 包 await，或链式写 .catch(err => {...})
• process.on('unhandledRejection', (err) => { console.error(err); process.exit(1); }) 是上线前必加的兜底
• 数据库连接池初始化失败、Redis 连不上，这些错误不会立刻抛出，而是在第一次使用时才触发 rejection，得在启动阶段主动 await client.ping() 类似探活

真正卡住人的从来不是语法，而是请求没进日志、环境变量读错、异步错误被吞、端口被占却不报错——这些都得靠 console.log、DEBUG=* 环境变量、lsof -i :3000 和 node --trace-warnings 一点点抠出来。