统一身份认证与下载功能的实现详解

2025-11-30 06:14

大家好，今天咱们来聊聊一个在开发中经常遇到的问题——“统一身份认证”和“下载”这两个功能。这两个功能虽然看起来简单，但在实际开发中却常常让人头疼。特别是当你要让不同的模块或者服务都使用同一个用户体系时，统一身份认证就显得尤为重要了。而下载功能呢，可能你只是想让用户从你的系统里获取一些文件，但背后的技术细节其实也不少。

那咱们先来想想，为什么需要统一身份认证？举个例子，假设你现在有一个网站，里面有多个子系统，比如用户管理、内容管理、数据分析等等。每个子系统都需要用户登录才能访问。如果每个系统都单独维护用户信息，那就会导致数据不一致、重复登录、用户体验差等一系列问题。这时候，统一身份认证（简称SSO）就派上用场了。它可以让用户在一个地方登录后，就能访问所有关联的服务，不用反复输入账号密码。

那么，怎么实现统一身份认证呢？这里我给大家提供一个简单的例子，用的是Node.js和JWT（JSON Web Token）。当然，这个例子是简化版，实际项目中可能还需要考虑更多安全性和性能的问题。

1. 用户登录：生成Token

首先，用户在登录页面输入用户名和密码，然后系统会验证这些信息是否正确。如果正确，就生成一个JWT，并返回给前端。


// login.js
const jwt = require('jsonwebtoken');

function generateToken(user) {
  return jwt.sign({
    id: user.id,
    username: user.username
  }, 'your-secret-key', { expiresIn: '1h' });
}

// 假设用户已经通过数据库验证
const user = { id: 1, username: 'testuser' };
const token = generateToken(user);
console.log(token);

这段代码很简单，就是用jsonwebtoken库生成一个带有用户信息的token，有效期是1小时。生成的token可以发送给前端，保存到localStorage或者cookie里。

2. 后端验证Token

接下来，当用户尝试访问某个受保护的资源时，比如下载文件，后端需要验证这个token是否有效。


// verifyToken.js
const jwt = require('jsonwebtoken');

function verifyToken(req, res, next) {
  const token = req.header('Authorization');
  if (!token) {
    return res.status(401).send('未授权，请登录');
  }

  try {
    const decoded = jwt.verify(token, 'your-secret-key');
    req.user = decoded;
    next();
  } catch (err) {
    res.status(401).send('无效的token');
  }
}

module.exports = verifyToken;

这个中间件的作用就是检查请求头中的Authorization字段是否有有效的token。如果有，就把用户信息存到req对象中，方便后续使用；如果没有，就返回401错误。

3. 下载功能的实现

现在我们有了认证机制，接下来就是下载功能了。假设我们要让用户下载一个文件，比如一个PDF文档。这个时候，我们需要确保用户已经登录，并且有权限下载该文件。


// download.js
const express = require('express');
const router = express.Router();
const fs = require('fs');
const path = require('path');

router.get('/download', verifyToken, (req, res) => {
  const filePath = path.join(__dirname, 'files', 'example.pdf');
  if (!fs.existsSync(filePath)) {
    return res.status(404).send('文件不存在');
  }

  res.download(filePath, 'example.pdf', (err) => {
    if (err) {
      res.status(500).send('下载失败');
    }
  });
});

module.exports = router;

这段代码使用Express框架创建了一个下载路由。当用户访问/download时，会先调用verifyToken中间件进行身份验证。如果通过，就尝试下载example.pdf文件。如果文件不存在，就返回404；如果下载过程中出错，就返回500错误。

4. 前端如何处理下载

前端部分也很简单，只需要在点击下载按钮时，发送一个GET请求到/download接口，并带上之前获得的token。


// download.js
async function downloadFile() {
  const response = await fetch('/download', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer ' + localStorage.getItem('token')
    }
  });

  if (response.ok) {
    const blob = await response.blob();
    const url = window.URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = 'example.pdf';
    a.click();
    window.URL.revokeObjectURL(url);
  } else {
    alert('下载失败');
  }
}