《Node.js 開發指南》書中微博實例基於 Express 2.x/3.x,但 Express 4.x 移除了內置中間件(body-parser、cookie-parser、express-session 等),路由系統重寫,導致書本代碼大量失效。本文記錄完整遷移過程與最佳實踐。
# 1. 安裝 Express 生成器(全局)
npm install -g express-generator
# 2. 創建項目,指定 EJS 模板引擎(-e 參數)
express -e ejs microblog
cd microblog
# 3. 安裝基礎依賴
npm install
# 4. 安裝額外必需中間件(Express 4.x 必須顯式安裝)
npm install express-session connect-mongo connect-flash express-partials morgan
# express-session: Session 中間件
# connect-mongo: MongoDB Session 存儲
# connect-flash: 閃存訊息(success/error 提示)
# express-partials: EJS 佈局/partial 支持(替代 Express 3.x 內置 layout)
# morgan: 請求日誌
var express = require('express');
var path = require('path');
var logger = require('morgan');
var cookieParser = require('cookie-parser');
var bodyParser = require('body-parser');
var session = require('express-session');
var MongoStore = require('connect-mongo')(session);
var flash = require('connect-flash');
var partials = require('express-partials');
var routes = require('./routes/index');
var users = require('./routes/users');
var settings = require('./settings'); // 配置文件
var app = express();
// 視圖引擎設置
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'ejs');
// EJS partials 支持(必須在路由前)
app.use(partials());
// 中間件鏈(順序敏感!)
app.use(logger('dev'));
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: false }));
app.use(cookieParser());
app.use(express.static(path.join(__dirname, 'public')));
// Session 配置(Express 4.x 寫法)
app.use(session({
secret: settings.cookie_secret,
store: new MongoStore({ db: settings.db }), // 自動創建 sessions 集合
resave: false,
saveUninitialized: true,
cookie: { maxAge: 1000 * 60 * 60 * 24 * 30 } // 30 天
}));
// Flash 訊息中間件(必須在 session 之後、路由之前)
app.use(flash());
// 動態視圖助手(替代 Express 3.x app.dynamicHelpers)
app.use(function(req, res, next) {
res.locals.user = req.session.user;
res.locals.post = req.session.post;
res.locals.error = req.flash('error').length ? req.flash('error') : null;
res.locals.success = req.flash('success').length ? req.flash('success') : null;
next();
});
// 路由掛載
app.use('/', routes);
app.use('/users', users);
// 404 處理
app.use(function(req, res, next) {
var err = new Error('Not Found');
err.status = 404;
next(err);
});
// 錯誤處理
app.use(function(err, req, res, next) {
res.status(err.status || 500);
res.render('error', { message: err.message, error: app.get('env') === 'development' ? err : {} });
});
// 啟動服務器(Express 4.x 必須顯式 listen)
var port = process.env.PORT || 3000;
app.listen(port, function() {
console.log('Microblog listening on port ' + port);
});
module.exports = app;
| 舊代碼 | 問題 | 新代碼 |
|---|---|---|
express -t ejs |
-t 已廢棄 |
express -e ejs |
app.use(express.bodyParser()) |
內置移除 | bodyParser.json() + bodyParser.urlencoded() |
app.use(express.cookieParser()) |
內置移除 | cookieParser() (獨立包) |
app.use(express.session(...)) |
內置移除 | session({ store: new MongoStore(...) }) |
app.dynamicHelpers({...}) |
API 移除 | app.use((req,res,next)=>{ res.locals.xxx=...; next(); }) |
req.flash() 直接可用 |
需獨立安裝 | npm i connect-flash + app.use(flash()) |
| EJS layout 支持 | Express 4 移除內置 layout | npm i express-partials + app.use(partials()) |
| MongoDB 連接 | Driver API 變更 | new Db(name, new Server(host, port), {safe:true}) |
| 路由掛載 | app.router 移除 | 直接 app.use('/', routes) |
var settings = require('./settings');
var Db = require('mongodb').Db;
var Connection = require('mongodb').Connection;
var Server = require('mongodb').Server;
module.exports = new Db(
settings.db,
new Server(settings.host, Connection.DEFAULT_PORT, {}),
{ safe: true } // 關鍵:確保寫入確認
);
var express = require('express');
var router = express.Router();
var Post = require('../models/post');
var User = require('../models/user');
var crypto = require('crypto');
// 首頁:顯示所有微博
router.get('/', function(req, res) {
Post.getAll(null, function(err, posts) {
if (err) posts = [];
res.render('index', { title: '微博首頁', posts: posts });
});
});
// 發布微博
router.post('/post', function(req, res) {
var currentUser = req.session.user;
var post = new Post(currentUser.name, req.body.content);
post.save(function(err) {
if (err) {
req.flash('error', err);
return res.redirect('/');
}
req.flash('success', '發布成功');
res.redirect('/');
});
});
// 註冊頁面
router.get('/reg', function(req, res) {
res.render('reg', { title: '註冊' });
});
router.post('/reg', function(req, res) {
// 密碼加密
var md5 = crypto.createHash('md5');
var password = md5.update(req.body.password).digest('hex');
var newUser = new User({
name: req.body.username,
password: password,
email: req.body.email
});
User.get(newUser.name, function(err, user) {
if (user) {
req.flash('error', '用戶已存在');
return res.redirect('/reg');
}
newUser.save(function(err) {
if (err) {
req.flash('error', err);
return res.redirect('/reg');
}
req.session.user = newUser;
req.flash('success', '註冊成功');
res.redirect('/');
});
});
});
module.exports = router;
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title><%= title %></title>
<link rel="stylesheet" href="/stylesheets/style.css">
</head>
<body>
<header>
<h1><a href="/">Microblog</a></h1>
<nav>
<% if (user) { %>
<span>歡迎, <%= user.name %></span>
<a href="/logout">登出</a>
<% } else { %>
<a href="/login">登入</a>
<a href="/reg">註冊</a>
<% } %>
</nav>
</header>
<% if (error) { %>
<div class="alert error"><%= error %></div>
<% } %>
<% if (success) { %>
<div class="alert success"><%= success %></div>
<% } %>
<main>
<%- body %> <!-- 關鍵:partials 渲染子視圖 -->
</main>
</body>
</html>
express-partials 中間件必須放在 express.static 之前,否則 layout.ejs 內引用的 CSS 路徑會被 static 中間件攔截導致找不到。require('../settings') 路徑錯誤:Express 4.x 路由文件在 routes/ 目錄,引用根目錄配置需 require('../settings')(而非 ./settings)。connect-mongo 需傳入 session 實例:require('connect-mongo')(session),且 MongoDB 必須先啟動。session → flash → dynamic locals → routes。mongodb@1.x,新版驅動 API 差異大,建議配套升級模型層代碼或鎖定舊版驅動。
# 1. 啟動 MongoDB
mongod --dbpath ./data
# 2. 啟動應用(開發模式自動重啟)
npm install -g supervisor
supervisor app.js
# 3. 訪問 https://localhost:3000

Express 4.x 通過「中間件模組化」獲得極大靈活性,代價是遷移成本。核心遷移邏輯:拆分內置中間件為獨立包 → 顯式安裝引用 → 調整中間件順序 → 替換廢棄 API(dynamicHelpers→res.locals、layout→partials) → 修正 MongoDB 驅動調用。掌握這套遷移模式,不僅能跑通書本範例,更能應對任何 Express 版本升級帶來的破壞性變更。