快速搭建Node.js服务指南

Node.js是构建高效、可扩展网络应用的理想选择。以下是几种快速搭建Node.js服务的方法。

方法一：使用Express（最流行框架）

1. 初始化项目

mkdir my-node-service
cd my-node-service
npm init -y

2. 安装Express

npm install express

3. 基础服务代码

创建app.js或index.js文件：

const express = require('express')
const app = express()
const port = 3000// 中间件
app.use(express.json())// 路由
app.get('/', (req, res) => {res.send('Hello World!')
})// 带参数的路由
app.get('/user/:id', (req, res) => {res.send(`User ID: ${req.params.id}`)
})// POST请求示例
app.post('/data', (req, res) => {console.log(req.body)res.json({ received: true })
})// 启动服务
app.listen(port, () => {console.log(`服务运行在 http://localhost:${port}`)
})

4. 运行服务

node app.js

方法二：使用Koa（更现代的框架）

1. 安装Koa

npm install koa @koa/router

2. 基础服务代码

const Koa = require('koa')
const Router = require('@koa/router')const app = new Koa()
const router = new Router()router.get('/', (ctx) => {ctx.body = 'Hello Koa!'
})app.use(router.routes())
app.use(router.allowedMethods())app.listen(3000, () => {console.log('服务运行在 http://localhost:3000')
})

方法三：使用Fastify（高性能框架）

1. 安装Fastify

npm install fastify

2. 基础服务代码

const fastify = require('fastify')({ logger: true })fastify.get('/', async (request, reply) => {return { hello: 'world' }
})const start = async () => {try {await fastify.listen({ port: 3000 })} catch (err) {fastify.log.error(err)process.exit(1)}
}
start()

数据库集成（以MongoDB为例）

1. 安装mongoose

npm install mongoose

2. 连接数据库

const mongoose = require('mongoose')mongoose.connect('mongodb://localhost:27017/mydatabase').then(() => console.log('MongoDB连接成功')).catch(err => console.error('MongoDB连接失败', err))

3. 定义模型和路由

const User = mongoose.model('User', new mongoose.Schema({name: String,email: String
}))app.get('/users', async (req, res) => {const users = await User.find()res.json(users)
})app.post('/users', async (req, res) => {const user = new User(req.body)await user.save()res.status(201).send(user)
})

中间件使用示例

1. 常用中间件安装

npm install cors morgan helmet

2. 中间件配置

const cors = require('cors')
const morgan = require('morgan')
const helmet = require('helmet')app.use(cors()) // 跨域支持
app.use(morgan('combined')) // 请求日志
app.use(helmet()) // 安全头设置

项目结构建议

my-node-service/
├── node_modules/
├── src/
│   ├── controllers/    # 控制器
│   ├── models/         # 数据模型
│   ├── routes/         # 路由定义
│   ├── middlewares/    # 自定义中间件
│   ├── utils/          # 工具函数
│   └── app.js          # 主应用文件
├── .env                # 环境变量
├── package.json
└── README.md

环境配置

1. 安装dotenv

npm install dotenv

2. 创建.env文件

PORT=3000
MONGODB_URI=mongodb://localhost:27017/mydatabase
JWT_SECRET=mysecretkey

3. 加载配置

require('dotenv').config()const port = process.env.PORT || 3000
app.listen(port, () => {console.log(`服务运行在 ${port} 端口`)
})

错误处理

1. 添加错误处理中间件

// 最后添加
app.use((err, req, res, next) => {console.error(err.stack)res.status(500).send('出错了!')
})

2. 异步错误处理

const asyncHandler = fn => (req, res, next) => Promise.resolve(fn(req, res, next)).catch(next)app.get('/async', asyncHandler(async (req, res) => {const data = await someAsyncOperation()res.json(data)
}))

服务部署

1. 使用PM2进程管理

npm install pm2 -g
pm2 start app.js

2. 常用PM2命令

pm2 list         # 查看运行中的进程
pm2 stop app     # 停止应用
pm2 restart app  # 重启应用
pm2 logs         # 查看日志

进阶建议

1. API文档：使用Swagger UI

   npm install swagger-ui-express swagger-jsdoc
   

2. 验证：使用JWT

   npm install jsonwebtoken bcryptjs
   

3. 测试：使用Jest

   npm install jest supertest --save-dev
   

4. TypeScript支持：

   npm install typescript @types/node @types/express --save-dev
   

5. Docker化：

   FROM node:16
   WORKDIR /app
   COPY package*.json ./
   RUN npm install
   COPY . .
   EXPOSE 3000
   CMD ["node", "app.js"]
   

选择适合你项目需求的框架和方法，Express适合大多数Web应用，Koa提供更现代的中间件机制，Fastify则专注于高性能。