peixue-dev/Archive/peidu-temp-files/docs/[一次性]服务反馈功能调试指南.md

323 lines
5.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 服务反馈功能调试指南
创建时间2026-01-22
---
## 一、问题现象
点击"服务反馈"菜单后:
- 页面空白
- 没有调用接口
- Network面板没有请求记录
---
## 二、可能的原因
### 2.1 文件未编译
**原因**uniapp需要重新编译才能生效
**解决方案**
1. 停止当前的编译进程
2. 重新运行编译命令
```bash
cd uniapp
npm run dev:mp-weixin
```
### 2.2 路由配置问题
**检查**确认pages.json中的配置正确
```json
{
"root": "user-package",
"pages": [
{
"path": "pages/feedback/list",
"style": {
"navigationBarTitleText": "服务反馈",
"enablePullDownRefresh": true
}
}
]
}
```
### 2.3 文件路径问题
**检查**:确认文件存在于正确的位置
```
uniapp/
├── src/
│ └── user-package/
│ └── pages/
│ └── feedback/
│ └── list.vue ✅ 必须存在
└── user-package/
└── pages/
└── feedback/
└── list.vue ✅ 编译后生成
```
---
## 三、调试步骤
### 3.1 检查文件是否存在
```bash
# 检查源文件
ls uniapp/src/user-package/pages/feedback/list.vue
# 检查编译后的文件
ls uniapp/user-package/pages/feedback/list.vue
```
### 3.2 检查控制台日志
在微信开发者工具中:
1. 打开"调试器"
2. 查看Console面板
3. 查找以下日志:
- `初始化parentId: xxx`
- `开始加载反馈列表parentId: xxx`
- `接口返回: {...}`
### 3.3 检查Network请求
在微信开发者工具中:
1. 打开"调试器"
2. 切换到"Network"面板
3. 点击"服务反馈"菜单
4. 查看是否有请求发出
**预期请求**
```
GET http://192.168.1.50:8080/api/feedback/parent/list?parentId=1&page=1&size=10
```
### 3.4 检查后端服务
```bash
# 检查后端是否启动
curl http://192.168.1.50:8080/api/feedback/parent/list?parentId=1&page=1&size=10
```
**预期响应**
```json
{
"code": 200,
"data": {
"records": [...],
"total": 2,
"pages": 1
}
}
```
---
## 四、修复方案
### 4.1 重新编译项目
```bash
# 1. 停止当前编译Ctrl+C
# 2. 清理编译缓存
cd uniapp
rm -rf dist
rm -rf node_modules/.cache
# 3. 重新编译
npm run dev:mp-weixin
```
### 4.2 强制刷新微信开发者工具
1. 在微信开发者工具中点击"编译"按钮
2. 或者按快捷键Ctrl+BWindows/ Cmd+BMac
### 4.3 检查request导入
确认list.vue中的import语句正确
```javascript
import request from '@/utils/request'
```
如果报错,尝试修改为:
```javascript
import request from '../../utils/request'
```
### 4.4 添加调试日志
在list.vue的onLoad方法中添加日志
```javascript
onLoad() {
console.log('=== 服务反馈页面加载 ===')
console.log('request对象:', request)
this.initParentId()
this.loadFeedbackList()
}
```
---
## 五、常见错误
### 5.1 错误request is not defined
**原因**request未正确导入
**解决**
```javascript
// 检查import语句
import request from '@/utils/request'
// 或者使用相对路径
import request from '../../utils/request'
```
### 5.2 错误Cannot read property 'get' of undefined
**原因**request对象为undefined
**解决**
1. 检查utils/request.js是否存在
2. 检查export default语句
3. 尝试重新编译
### 5.3 错误404 Not Found
**原因**:后端接口不存在
**解决**
1. 检查后端服务是否启动
2. 检查Controller是否创建
3. 检查接口路径是否正确
### 5.4 页面空白,无任何日志
**原因**:页面未加载或编译失败
**解决**
1. 检查pages.json配置
2. 重新编译项目
3. 检查文件路径
---
## 六、验证清单
### 6.1 文件检查
- [ ] `src/user-package/pages/feedback/list.vue` 存在
- [ ] `src/pages.json` 中有feedback路由配置
- [ ] `src/utils/request.js` 存在且正确导出
### 6.2 编译检查
- [ ] 运行 `npm run dev:mp-weixin` 无错误
- [ ] `user-package/pages/feedback/list.vue` 编译后存在
- [ ] 微信开发者工具中点击"编译"
### 6.3 功能检查
- [ ] 点击"服务反馈"菜单能打开页面
- [ ] 页面显示标题"服务反馈"
- [ ] Console中有日志输出
- [ ] Network中有接口请求
### 6.4 后端检查
- [ ] 后端服务已启动
- [ ] ServiceFeedbackController已创建
- [ ] service_feedback表已创建
- [ ] 表中有测试数据
---
## 七、快速测试命令
```bash
# 1. 检查文件
ls -la uniapp/src/user-package/pages/feedback/
# 2. 检查编译后的文件
ls -la uniapp/user-package/pages/feedback/
# 3. 重新编译
cd uniapp
npm run dev:mp-weixin
# 4. 测试后端接口
curl http://192.168.1.50:8080/api/feedback/parent/list?parentId=1&page=1&size=10
# 5. 查看后端日志
tail -f logs/peixue.log
```
---
## 八、如果还是不行
### 8.1 完全重新创建
```bash
# 1. 删除feedback目录
rm -rf uniapp/src/user-package/pages/feedback
rm -rf uniapp/user-package/pages/feedback
# 2. 重新创建目录
mkdir -p uniapp/src/user-package/pages/feedback
# 3. 重新创建list.vue文件从文档复制
# 4. 重新编译
cd uniapp
npm run dev:mp-weixin
```
### 8.2 检查其他页面是否正常
尝试打开其他user-package中的页面
- 我的钱包
- 我的时卡
- 我的积分
如果其他页面也打不开说明是user-package的配置问题。
### 8.3 查看编译错误
在终端中查看编译输出,查找错误信息:
```bash
cd uniapp
npm run dev:mp-weixin 2>&1 | grep -i error
```
---
## 九、联系支持
如果以上方法都无法解决,请提供以下信息:
1. 微信开发者工具Console的完整日志
2. Network面板的截图
3. 编译终端的输出
4. pages.json中user-package的完整配置
---
**文档版本**v1.0
**最后更新**2026-01-22