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/index.ts，直接报错 -
require('lodash')查找顺序：当前目录node_modules→ 父级node_modules→ 一直向上，直到根目录或找不到 -
__dirname是当前模块所在目录绝对路径，__filename是文件绝对路径，拼接路径务必用path.join(__dirname, 'config.json')，别用字符串拼接
异步操作不加 await 或 catch，进程大概率静默退出
Node.js 里一个未捕获的 Promise rejection 就会让进程崩掉（v15+ 默认行为），尤其在文件读写、数据库连接、HTTP 请求时：
立即学习“Java免费学习笔记（深入）”；
-
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 一点点抠出来。
