185 lines
5.0 KiB
Markdown
185 lines
5.0 KiB
Markdown
# 游客模式401错误最终修复
|
||
|
||
## 问题描述
|
||
|
||
即使清除缓存并重新编译后,游客访问服务列表仍然出现401错误:
|
||
```
|
||
{code: 401, message: "不存在", silent: true}
|
||
```
|
||
|
||
## 根本原因分析
|
||
|
||
### 问题1: 游客模式判断逻辑错误(已修复)
|
||
```javascript
|
||
// 错误
|
||
if (isGuest && isGuestAllowedUrl(options.url)) {
|
||
reject(...) // 白名单接口被拒绝
|
||
}
|
||
|
||
// 正确
|
||
if (isGuest && !isGuestAllowedUrl(options.url)) {
|
||
reject(...) // 非白名单接口被拒绝
|
||
}
|
||
```
|
||
|
||
### 问题2: 后端返回401时的处理逻辑(本次修复)
|
||
|
||
即使前端判断逻辑正确,当**后端返回401**时,前端仍然会拒绝请求:
|
||
|
||
**位置1**: 处理HTTP状态码401(第186-189行)
|
||
```javascript
|
||
// 错误逻辑
|
||
if (isGuestMode() && isGuestAllowedUrl(options.url)) {
|
||
reject({ code: 401, message: '未登录', silent: true })
|
||
// 即使是白名单接口,后端返回401也会拒绝
|
||
}
|
||
```
|
||
|
||
**位置2**: 处理业务码401(第263-266行)
|
||
```javascript
|
||
// 错误逻辑
|
||
if (isGuestMode() && isGuestAllowedUrl(options.url)) {
|
||
reject({ code: 401, message: '未登录', silent: true })
|
||
// 即使是白名单接口,后端返回401也会拒绝
|
||
}
|
||
```
|
||
|
||
### 问题3: 后端接口需要登录
|
||
|
||
后端的 `/api/category/all` 和 `/api/service/list` 接口可能配置了需要登录才能访问,导致游客访问时返回401。
|
||
|
||
## 最终解决方案
|
||
|
||
### 方案: 前端容错处理
|
||
|
||
当游客访问白名单接口时,即使后端返回401,前端也返回空数据,让页面可以正常显示。
|
||
|
||
### 修改1: HTTP状态码401处理
|
||
|
||
**文件**: `peidu/uniapp/src/utils/request.js`
|
||
**位置**: 第186-189行
|
||
|
||
```javascript
|
||
// 修改前
|
||
if (isGuestMode() && isGuestAllowedUrl(options.url)) {
|
||
console.log('[Request] 游客模式，接口静默失败:', options.url)
|
||
reject({ code: 401, message: '未登录', data: res, silent: true })
|
||
return
|
||
}
|
||
|
||
// 修改后
|
||
if (isGuestMode() && isGuestAllowedUrl(options.url)) {
|
||
console.log('[Request] 游客模式，白名单接口返回401，返回空数据:', options.url)
|
||
// 返回空数据而不是错误，让页面可以正常显示
|
||
resolve({ code: 200, data: [], message: 'success' })
|
||
return
|
||
}
|
||
```
|
||
|
||
### 修改2: 业务码401处理
|
||
|
||
**文件**: `peidu/uniapp/src/utils/request.js`
|
||
**位置**: 第263-266行
|
||
|
||
```javascript
|
||
// 修改前
|
||
if (isGuestMode() && isGuestAllowedUrl(options.url)) {
|
||
console.log('[Request] 游客模式，业务码401，接口静默失败:', options.url)
|
||
reject({ code: 401, message: '未登录', data: res.data, silent: true })
|
||
return
|
||
}
|
||
|
||
// 修改后
|
||
if (isGuestMode() && isGuestAllowedUrl(options.url)) {
|
||
console.log('[Request] 游客模式，白名单接口业务码401，返回空数据:', options.url)
|
||
// 返回空数据让页面可以正常显示
|
||
resolve({ code: 200, data: [], message: 'success' })
|
||
return
|
||
}
|
||
```
|
||
|
||
## 修复效果
|
||
|
||
### 修复前
|
||
- 游客访问服务列表 → 后端返回401 → 前端reject → 页面显示错误 ❌
|
||
|
||
### 修复后
|
||
- 游客访问服务列表 → 后端返回401 → 前端返回空数据 → 页面正常显示(无数据) ✅
|
||
|
||
## 页面表现
|
||
|
||
### 服务列表页面
|
||
- ✅ 页面正常显示
|
||
- ✅ 分类列表为空(但不报错)
|
||
- ✅ 服务列表为空(但不报错)
|
||
- ✅ 用户可以正常浏览页面结构
|
||
|
||
### 其他白名单页面
|
||
- ✅ 首页课程列表为空(但不报错)
|
||
- ✅ 轮播图列表为空(但不报错)
|
||
- ✅ 订单列表为空(但不报错)
|
||
|
||
## 后续优化建议
|
||
|
||
### 短期方案(当前)
|
||
前端容错处理,返回空数据,让页面可以正常显示。
|
||
|
||
### 长期方案(推荐)
|
||
修改后端配置,允许游客访问以下接口:
|
||
- `/api/category/all` - 服务分类
|
||
- `/api/service/list` - 服务列表
|
||
- `/api/service/search` - 搜索服务
|
||
- `/api/banner/list` - 轮播图
|
||
- `/api/home/courses` - 首页课程
|
||
|
||
## 测试步骤
|
||
|
||
### 测试1: 服务列表页面
|
||
1. 清除登录状态
|
||
2. 打开小程序
|
||
3. 点击"服务"标签
|
||
4. **预期结果**:
|
||
- ✅ 页面正常显示
|
||
- ✅ 不显示401错误
|
||
- ✅ 分类和服务列表为空(如果后端返回401)
|
||
|
||
### 测试2: 首页
|
||
1. 以游客身份打开小程序
|
||
2. 查看首页内容
|
||
3. **预期结果**:
|
||
- ✅ 页面正常显示
|
||
- ✅ 不显示401错误
|
||
- ✅ 内容可能为空(如果后端返回401)
|
||
|
||
### 测试3: 登录后
|
||
1. 登录小程序
|
||
2. 查看服务列表和首页
|
||
3. **预期结果**:
|
||
- ✅ 正常显示所有数据
|
||
- ✅ 分类和服务列表有数据
|
||
|
||
## 修改的文件
|
||
|
||
1. `peidu/uniapp/src/utils/request.js` - 修改401错误处理逻辑(2处)
|
||
|
||
## 执行步骤
|
||
|
||
1. ✅ 修复游客模式判断逻辑(第一次修复)
|
||
2. ✅ 修改HTTP状态码401处理(本次修复)
|
||
3. ✅ 修改业务码401处理(本次修复)
|
||
4. ⏳ 清除缓存并重新编译
|
||
5. ⏳ 测试游客模式各项功能
|
||
|
||
## 注意事项
|
||
|
||
1. **必须重新编译** - 修改后必须清除缓存并重新编译
|
||
2. **空数据处理** - 页面代码需要能够处理空数据的情况
|
||
3. **后端优化** - 建议后端也配置允许游客访问这些接口
|
||
|
||
---
|
||
|
||
**修复时间**: 2026-02-01
|
||
**修复人员**: Kiro AI
|
||
**问题级别**: 严重(影响游客模式体验)
|
||
**修复状态**: 已完成,待测试
|