2025 最新版：Node.js 中如何使用 Passport 進行用戶認證？
Passport 是一個廣泛使用的 Node.js 框架，使開發者可以輕鬆實現用戶認證功能。它提供了簡單的 API，讓您能快速構建安全的用戶認證系統。本文將詳細介紹如何在 Node.js 中使用 Passport 進行用戶認證，並補充最新的語法與最佳實踐。
安裝 Passport
首先，我們需要安裝 Passport，這可以通過以下命令完成：
“`bash
npm install passport
“`
設置 Passport
接下來，我們需要在 Node.js 應用程序中設置 Passport。首先，將 Passport 引入應用程序中：
“`javascript
const passport = require(‘passport’);
“`
然後，註冊 Passport 的中介軟體：
“`javascript
app.use(passport.initialize());
app.use(passport.session());
“`
接下來，我們需要設置 Passport 的序列化和反序列化功能：
“`javascript
passport.serializeUser(function(user, done) {
done(null, user.id);
});
passport.deserializeUser(function(id, done) {
User.findById(id, function(err, user) {
done(err, user);
});
});
“`
使用 Passport 進行用戶認證
現在，我們可以開始使用 Passport 進行用戶認證。首先，定義一個用於用戶登錄的路由：
“`javascript
app.post(‘/login’,
passport.authenticate(‘local’, {
successRedirect: ‘/’,
failureRedirect: ‘/login’
}));
“`
接著，設置 Passport 策略以驗證用戶：
“`javascript
const LocalStrategy = require(‘passport-local’).Strategy;
passport.use(new LocalStrategy(
function(username, password, done) {
User.findOne({ username: username }, function(err, user) {
if (err) { return done(err); }
if (!user) {
return done(null, false, { message: ‘Incorrect username.’ });
}
if (!user.validPassword(password)) {
return done(null, false, { message: ‘Incorrect password.’ });
}
return done(null, user);
});
}
));
“`
最後，定義一個用於登出的路由：
“`javascript
app.get(‘/logout’, function(req, res){
req.logout();
res.redirect(‘/’);
});
“`
這樣，我們就完成了 Passport 的設置，可以開始使用它來實現用戶認證功能。
錯誤排除與最佳實踐
在實作過程中，您可能會遇到一些常見錯誤，例如：
– **用戶未登錄**：確保在使用 Passport 的路由中正確設置了中介軟體。
– **無法找到用戶**：檢查用戶名和密碼是否正確。
– **Session 配置問題**：確保您的 Express 應用程式已正確配置 session。
延伸應用
除了基本的用戶認證，您還可以考慮將 Passport 與第三方身份提供者集成，例如 Google、Facebook 等，使用 Passport 的 OAuth 策略。
此外，您可以參考 [這篇教學文章](https://vocus.cc/article/605e4c1ef4a6b4e4d8c5d1dc) 以獲得更多關於如何在實際專案中使用 Passport 的深入探討。
總結
在本文中，我們介紹了如何在 Node.js 中使用 Passport 進行用戶認證。我們首先安裝了 Passport，然後設置了 Passport，最後使用 Passport 進行用戶認證。Passport 是一個非常有用的 Node.js 框架，讓開發者輕鬆實現用戶認證功能。
Q&A（常見問題解答）
**Q1：如何在 Passport 中使用社交媒體登錄？**
A1：您可以使用 Passport 提供的 OAuth 策略來集成社交媒體登錄，詳細步驟請參考 Passport 官方文檔。
**Q2：如果用戶登錄失敗，如何給予用戶反饋？**
A2：您可以在失敗路由中添加錯誤消息，並將其回傳至客戶端進行顯示。
**Q3：如何保護我的 API 路由？**
A3：您可以使用 Passport 的 `isAuthenticated` 中介軟體來保護需要身份驗證的路由，只有經過身份驗證的用戶才能訪問。
—