萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Node.js + Express 4.x 開發微博應用實戰:從遷移舊代碼到完整功能實現

背景:Express 版本升級帶來的遷移挑戰

《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: 請求日誌

核心配置:app.js 完整遷移版


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)

模型層遷移:models/db.js


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 } // 關鍵:確保寫入確認
);

路由實現片段:routes/index.js


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;

視圖佈局:views/layout.ejs


<!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>

常見遷移坑點與解決

  • CSS/靜態資源 404:express-partials 中間件必須放在 express.static 之前,否則 layout.ejs 內引用的 CSS 路徑會被 static 中間件攔截導致找不到。
  • require('../settings') 路徑錯誤:Express 4.x 路由文件在 routes/ 目錄,引用根目錄配置需 require('../settings')(而非 ./settings)。
  • Session 無法持久化:connect-mongo 需傳入 session 實例:require('connect-mongo')(session),且 MongoDB 必須先啟動。
  • Flash 訊息不顯示:中間件順序必須是 session → flash → dynamic locals → routes。
  • MongoDB 驅動版本不兼容:舊代碼用 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 版本升級帶來的破壞性變更。

copyright © 萬盛學電腦網 all rights reserved