105 lines
2.9 KiB
Markdown
105 lines
2.9 KiB
Markdown
# ✅ Token 存储降级方案 - 修复说明
|
||
|
||
## 📌 问题描述
|
||
|
||
**现象:** 本地调试正常，但在其他电脑上登录后 `localStorage.leasToken` 没有存储成功。
|
||
|
||
**根本原因:** 项目使用了 AES-GCM 加密存储，依赖 Web Crypto API，在 HTTP 环境或旧版浏览器中不可用。
|
||
|
||
## ✅ 修复方案
|
||
|
||
实现了**三层降级存储策略**，确保在任何环境下都能正常存储 token:
|
||
|
||
```
|
||
优先: AES-GCM 加密存储 (HTTPS + 现代浏览器)
|
||
↓ 失败自动降级
|
||
降级: 明文 JSON 存储 (HTTP 环境/旧浏览器)
|
||
↓ 失败保底
|
||
保底: 内存缓存 (至少当前会话可用)
|
||
```
|
||
|
||
## 🔧 修改的文件
|
||
|
||
**核心修复:**
|
||
- [src/utils/request.js](src/utils/request.js) - Token 管理逻辑
|
||
- `initTokenCache()` - 智能读取（加密→明文→内存）
|
||
- `updateToken()` - 智能存储（加密→明文→内存）
|
||
- `clearToken()` - 完全清除（加密+明文+内存）
|
||
|
||
## 📊 兼容性
|
||
|
||
| 环境 | 存储方式 | 状态 |
|
||
|------|----------|------|
|
||
| HTTPS + 现代浏览器 | ✅ AES-GCM 加密 | 最安全 |
|
||
| HTTP 环境 | ⚠️ 明文 JSON | 自动降级 |
|
||
| 旧版浏览器 (IE11/360兼容模式) | ⚠️ 明文 JSON | 自动降级 |
|
||
| 隐私模式 | 💾 内存缓存 | 会话内可用 |
|
||
|
||
## 🧪 验证方法
|
||
|
||
### 开发环境测试
|
||
|
||
```bash
|
||
npm run serve
|
||
```
|
||
|
||
登录后在浏览器控制台检查:
|
||
|
||
```javascript
|
||
// 检查是否存储成功
|
||
console.log('Token 已存储:', !!localStorage.getItem('leasToken'));
|
||
|
||
// 查看存储模式（开发环境会有日志）
|
||
// HTTPS: [Token缓存] ✅ 已保存到加密存储
|
||
// HTTP: [Token缓存] ✅ 已保存到明文存储（降级模式）
|
||
```
|
||
|
||
### 测试登录持久化
|
||
|
||
```javascript
|
||
// 1. 登录后刷新页面
|
||
location.reload();
|
||
|
||
// 2. 应该保持登录状态，不需要重新登录
|
||
```
|
||
|
||
### 在问题电脑上验证
|
||
|
||
1. 清除旧数据: `localStorage.clear()`
|
||
2. 重新登录
|
||
3. 检查 localStorage: `console.log('Token:', !!localStorage.getItem('leasToken'))`
|
||
4. 刷新页面验证登录状态保持
|
||
|
||
## 🔍 控制台日志说明
|
||
|
||
### HTTPS 环境（加密存储）
|
||
```
|
||
[Token缓存] ✅ 已保存到加密存储
|
||
[Token缓存] ✅ 从加密存储加载成功
|
||
```
|
||
|
||
### HTTP 环境（自动降级）
|
||
```
|
||
[Token缓存] ⚠️ 加密存储失败，降级为明文存储
|
||
[Token缓存] ✅ 已保存到明文存储（降级模式）
|
||
[Token缓存] ✅ 从明文存储加载成功（降级模式）
|
||
```
|
||
|
||
## 🔒 安全说明
|
||
|
||
- **HTTPS 环境**: 自动使用 AES-GCM 加密，安全性高 ✅
|
||
- **HTTP 环境**: 降级为明文存储，建议尽快升级到 HTTPS ⚠️
|
||
- **生产环境**: 强烈推荐使用 HTTPS 部署
|
||
|
||
## ✅ 向后兼容
|
||
|
||
- ✅ 完全向后兼容，无需数据迁移
|
||
- ✅ 自动识别旧的明文 token
|
||
- ✅ 支持自动升级到加密存储（如果环境支持）
|
||
|
||
---
|
||
|
||
**修复时间:** 2026-01-08
|
||
**影响范围:** 所有用户的登录和会话管理
|
||
**紧急程度:** 建议尽快部署测试
|