Express 需调用 app.listen() 才启动服务器,因其实例仅为请求处理器;app.use() 用于中间件(路径前缀匹配),app.get() 用于路由(精确匹配 GET);须防端口占用与未捕获异常。

Express 是 Node.js 最常用的 Web 应用框架,但它本身不是“开箱即用的服务器”,而是一套精简的路由与中间件组织工具——你得自己写 app.listen() 才能真正跑起来。
为什么不能直接 node app.js 就启动服务?
Express 实例(比如 const app = express())只是个请求处理器,它不监听端口。必须显式调用 app.listen(port) 并处理错误,否则进程静默退出,没有任何提示。
常见错误现象:
• 控制台无输出、无报错,但访问 http://localhost:3000 显示 “This site can’t be reached”
• 脚本执行完立即结束,ps aux | grep node 查不到进程
- 必须写
app.listen(3000, () => { console.log('Server running on http://localhost:3000'); }); - 建议加上错误监听:
app.listen(3000, 'localhost', (err) => { if (err) throw err; console.log('Server ready'); }); - 端口号别硬编码;开发时优先用
process.env.PORT || 3000
app.use() 和 app.get() 到底该用哪个?
app.use() 注册的是中间件,匹配路径前缀(如 /api),且默认对所有 HTTP 方法生效;app.get() 是路由处理函数,只响应 GET 请求,且路径需完全匹配(除非带通配符)。
使用场景:
• 解析 JSON:用 app.use(express.json())(中间件)
• 静态文件:用 app.use('/static', express.static('public'))(中间件)
• 返回首页:用 app.get('/', (req, res) => res.send('Hello'))(路由)
- 顺序很重要:
app.use(express.json())必须在任何app.post()之前 -
app.use('/user', userRouter)中的/user是挂载路径,userRouter内部的router.get('/list')实际响应的是/user/list - 不要在
app.use()里写业务逻辑,除非是日志、鉴权等跨路由通用逻辑
如何避免 ERR_CONNECTION_REFUSED 或 EADDRINUSE?
前者通常因为服务根本没启动或监听了错误地址(如 127.0.0.1 但你访问 localhost);后者是端口被占——Node 进程没彻底退出,或另一个程序(如 VS Code Live Server、另一个 node app.js)正在用同一端口。
- 启动前加端口检查:
const server = app.listen(port, 'localhost', () => { console.log(`Running on http://localhost:${port}`); }); server.on('error', (err) => { if (err.code === 'EADDRINUSE') { console.error(`Port ${port} is already in use`); } throw err; }); - 查占用端口(macOS/Linux):
lsof -i :3000;Windows:netstat -ano | findstr :3000 - 强制杀进程(macOS/Linux):
kill -9 $(lsof -t -i :3000)
最常被忽略的一点:Express 不处理未捕获的 Promise 拒绝(unhandledRejection)或同步异常(throw new Error()),它们会导致进程崩溃。生产环境务必加全局错误监听,并用 try/catch 包裹异步路由逻辑。










