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 # 查看日志
進階建議
-
API文檔：使用Swagger UI
npm install swagger-ui-express swagger-jsdoc -
驗證：使用JWT
npm install jsonwebtoken bcryptjs -
測試：使用Jest
npm install jest supertest --save-dev -
TypeScript支持：
npm install typescript @types/node @types/express --save-dev -
Docker化：
FROM node:16 WORKDIR /app COPY package*.json ./ RUN npm install COPY . . EXPOSE 3000 CMD ["node", "app.js"]
選擇適合你項目需求的框架和方法，Express適合大多數Web應用，Koa提供更現代的中間件機制，Fastify則專注于高性能。
)
