后端开发是构建网站或应用程序的“幕后引擎”，负责处理数据存储、业务逻辑和用户请求。对于初学者而言，掌握用户认证系统是一个绝佳的起点。本文将带你一步步搭建一个基于JWT（JSON Web Token）的用户注册与登录功能，涵盖技术选型、代码实现和常见陷阱。

后端开发的核心是服务器端语言和数据库。本教程使用以下组合：

确保已安装Node.js（v16+）、MongoDB（本地或云服务如MongoDB Atlas）和Postman。

在终端执行以下命令： ```bash mkdir auth-system && cd auth-system npm init -y npm install express mongoose bcrypt jsonwebtoken dotenv ``` 创建一个`index.js`文件作为入口，并建立以下目录： ``` ├── models/ # 数据库模型 ├── routes/ # 路由处理 ├── middleware/ # 中间件 ├── .env # 环境变量 └── index.js ```

在`models/User.js`中定义用户数据结构： ```javascript const mongoose = require('mongoose'); const bcrypt = require('bcrypt');

const userSchema = new mongoose.Schema({ email: { type: String, required: true, unique: true, lowercase: true }, password: { type: String, required: true, minlength: 6 }, createdAt: { type: Date, default: Date.now } });

// 保存前自动加密密码 userSchema.pre('save', async function(next) { if (!this.isModified('password')) return next(); this.password = await bcrypt.hash(this.password, 10); next(); });

// 校验密码的实例方法 userSchema.methods.comparePassword = async function(candidatePassword) { return bcrypt.compare(candidatePassword, this.password); };

module.exports = mongoose.model('User', userSchema); ``` 注意事项：

在`routes/auth.js`中编写核心逻辑： ```javascript const express = require('express'); const jwt = require('jsonwebtoken'); const User = require('../models/User'); const router = express.Router();

// 注册 router.post('/register', async (req, res) => { try { const { email, password } = req.body; // 验证输入 if (!email || !password) { return res.status(400).json({ error: '邮箱和密码不能为空' }); } // 检查用户是否已存在 const existingUser = await User.findOne({ email }); if (existingUser) { return res.status(409).json({ error: '邮箱已被注册' }); } // 创建用户 const user = new User({ email, password }); await user.save(); // 生成JWT const token = jwt.sign({ userId: user._id }, process.env.JWT_SECRET, { expiresIn: '24h' }); res.status(201).json({ message: '注册成功', token }); } catch (error) { res.status(500).json({ error: '服务器内部错误' }); } });

// 登录 router.post('/login', async (req, res) => { try { const { email, password } = req.body; const user = await User.findOne({ email }); if (!user) { return res.status(401).json({ error: '邮箱或密码错误' }); } const isMatch = await user.comparePassword(password); if (!isMatch) { return res.status(401).json({ error: '邮箱或密码错误' }); } const token = jwt.sign({ userId: user._id }, process.env.JWT_SECRET, { expiresIn: '24h' }); res.json({ message: '登录成功', token }); } catch (error) { res.status(500).json({ error: '服务器内部错误' }); } });

module.exports = router; ```

创建`middleware/auth.js`用于验证JWT： ```javascript const jwt = require('jsonwebtoken');

module.exports = (req, res, next) => { const authHeader = req.headers.authorization; if (!authHeader || !authHeader.startsWith('Bearer ')) { return res.status(401).json({ error: '未提供认证令牌' }); } const token = authHeader.split(' ')[1]; try { const decoded = jwt.verify(token, process.env.JWT_SECRET); req.userId = decoded.userId; next(); } catch (error) { return res.status(401).json({ error: '令牌无效或已过期' }); } }; ```

在`index.js`中整合所有模块： ```javascript require('dotenv').config(); const express = require('express'); const mongoose = require('mongoose'); const authRoutes = require('./routes/auth'); const authMiddleware = require('./middleware/auth');

const app = express(); app.use(express.json());

// 连接数据库 mongoose.connect(process.env.MONGO_URI) .then(() => console.log('数据库已连接')) .catch(err => console.error('数据库连接失败:', err));

// 公开路由 app.use('/api/auth', authRoutes);

// 受保护路由示例 app.get('/api/profile', authMiddleware, (req, res) => { res.json({ message: '这是受保护的数据', userId: req.userId }); });

const PORT = process.env.PORT || 3000; app.listen(PORT, () => console.log(`服务器运行在端口 ${PORT}`)); ```

在`.env`文件中配置： ``` MONGO_URI=mongodb://localhost:27017/auth-demo JWT_SECRET=your_strong_random_secret_key_here ```

1. 使用Postman测试：

2. 常见错误排查：

1. 安全加固：

2. 性能优化：

3. 日志与监控：

通过以上步骤，你已经搭建了一个基础但完整的用户认证系统。后端开发的核心在于理解数据流、安全性和可扩展性，这个项目可作为更复杂系统（如角色权限、OAuth2集成）的起点。持续实践，逐步掌握更多高级模式。