202 lines
4.7 KiB
Markdown
202 lines
4.7 KiB
Markdown
# APP 部署问题排查指南
|
||
|
||
## 问题一：图标不显示
|
||
|
||
### 原因分析
|
||
APP 图标是打包在应用内的本地资源，不依赖服务器。
|
||
|
||
### 排查步骤
|
||
1. 检查图标文件是否存在：
|
||
```
|
||
fronted_uniapp/unpackage/res/icons/
|
||
├── 72x72.png
|
||
├── 96x96.png
|
||
├── 144x144.png
|
||
├── 192x192.png
|
||
└── 1024x1024.png (iOS)
|
||
```
|
||
|
||
2. 在 HBuilderX 中重新配置图标：
|
||
- 打开 `manifest.json`
|
||
- 点击 "App图标配置"
|
||
- 重新选择图标文件
|
||
- 点击 "自动生成所有图标并替换"
|
||
|
||
3. 重新打包 APP
|
||
|
||
### 如果是应用内的图标不显示
|
||
检查图标引用路径是否正确：
|
||
```vue
|
||
<!-- 正确写法 -->
|
||
<image src="/static/icons/xxx.png" />
|
||
|
||
<!-- 错误写法（不要用相对路径） -->
|
||
<image src="../../static/icons/xxx.png" />
|
||
```
|
||
|
||
---
|
||
|
||
## 问题二：应用闪退
|
||
|
||
### 可能原因
|
||
|
||
1. **网络请求异常未处理**
|
||
2. **内存不足**（Vosk 模型约 50MB）
|
||
3. **权限问题**
|
||
|
||
### 排查步骤
|
||
|
||
#### 1. 查看崩溃日志
|
||
- Android：使用 `adb logcat` 查看日志
|
||
- 或在 HBuilderX 中连接手机，查看控制台输出
|
||
|
||
#### 2. 检查网络请求超时配置
|
||
当前配置：`fronted_uniapp/utils/config.js`
|
||
```javascript
|
||
REQUEST_TIMEOUT: 30000 // 30秒
|
||
```
|
||
|
||
如果服务器响应慢，可以增加超时时间：
|
||
```javascript
|
||
REQUEST_TIMEOUT: 60000 // 60秒
|
||
```
|
||
|
||
#### 3. 检查异常处理
|
||
确保所有网络请求都有 try-catch：
|
||
```javascript
|
||
try {
|
||
const result = await request.get('/api/xxx')
|
||
// 处理结果
|
||
} catch (error) {
|
||
console.error('请求失败:', error)
|
||
// 显示友好提示，不要让应用崩溃
|
||
uni.showToast({ title: '网络异常', icon: 'none' })
|
||
}
|
||
```
|
||
|
||
#### 4. 检查内存使用
|
||
Vosk 模型较大，如果手机内存不足可能导致崩溃：
|
||
- 在低端设备上测试
|
||
- 考虑使用更小的模型
|
||
|
||
---
|
||
|
||
## 问题三：语音识别准确率低
|
||
|
||
### 重要说明
|
||
**语音识别完全在本地进行，不依赖服务器！**
|
||
|
||
使用的技术栈：
|
||
- 语音识别：本地 Vosk 模型 (`vosk-model-small-cn-0.22`)
|
||
- 评分算法：本地 JavaScript 计算
|
||
|
||
### 影响准确率的因素
|
||
|
||
1. **环境噪音**
|
||
- 安静环境识别率更高
|
||
- 避免背景音乐、人声干扰
|
||
|
||
2. **麦克风质量**
|
||
- 不同手机麦克风质量不同
|
||
- 距离麦克风 20-30cm 最佳
|
||
|
||
3. **说话方式**
|
||
- 语速适中，不要太快
|
||
- 发音清晰
|
||
- 每句话后稍作停顿
|
||
|
||
4. **模型限制**
|
||
- `vosk-model-small-cn-0.22` 是小型模型，准确率有限
|
||
- 对方言、口音支持较差
|
||
|
||
### 提高准确率的方法
|
||
|
||
#### 方法1：使用更大的模型
|
||
下载更大的 Vosk 中文模型（约 1GB），准确率更高：
|
||
- `vosk-model-cn-0.22`（大模型）
|
||
|
||
但会增加 APP 体积和内存占用。
|
||
|
||
#### 方法2：使用云端语音识别
|
||
改用百度、讯飞等云端语音识别服务，准确率更高：
|
||
|
||
```javascript
|
||
// 已有的后端接口
|
||
export function uploadAndRecognize(audioFilePath, originalContent) {
|
||
// 上传音频到后端，使用百度语音识别
|
||
}
|
||
```
|
||
|
||
后端已经集成了百度语音识别服务，可以考虑使用。
|
||
|
||
#### 方法3：优化评分算法
|
||
当前评分算法在 `fronted_uniapp/api/study/voiceEvaluation.js` 中：
|
||
- 使用编辑距离计算相似度
|
||
- 已经做了宽松处理
|
||
|
||
如果觉得评分太严格，可以进一步调整算法参数。
|
||
|
||
---
|
||
|
||
## 问题四：视频无法播放（服务器部署后）
|
||
|
||
### 原因
|
||
APP 直接访问后端服务器的 `/profile` 路径获取视频文件。
|
||
|
||
### 排查步骤
|
||
|
||
1. **检查服务器地址配置**
|
||
|
||
`fronted_uniapp/utils/config.js`:
|
||
```javascript
|
||
const DEFAULT_SERVER_HOST = '服务器IP' // 不能是 localhost
|
||
const DEFAULT_SERVER_PORT = 30091
|
||
```
|
||
|
||
2. **检查 Windows 防火墙**
|
||
|
||
开放 30091 端口：
|
||
```powershell
|
||
netsh advfirewall firewall add rule name="Study Backend" dir=in action=allow protocol=tcp localport=30091
|
||
```
|
||
|
||
3. **测试视频 URL**
|
||
|
||
在手机浏览器中访问：
|
||
```
|
||
http://服务器IP:30091/profile/upload/2025/xx/video.mp4
|
||
```
|
||
|
||
---
|
||
|
||
## 调试技巧
|
||
|
||
### 1. 查看 APP 日志
|
||
在 HBuilderX 中：
|
||
1. 连接手机（USB 调试模式）
|
||
2. 运行 -> 运行到手机
|
||
3. 查看控制台输出
|
||
|
||
### 2. 使用 Android Studio Logcat
|
||
```bash
|
||
adb logcat | grep -i "uni"
|
||
```
|
||
|
||
### 3. 添加调试日志
|
||
在关键位置添加日志：
|
||
```javascript
|
||
console.log('[DEBUG] 当前服务器地址:', config.API_BASE_URL)
|
||
console.log('[DEBUG] 请求URL:', url)
|
||
console.log('[DEBUG] 响应数据:', response)
|
||
```
|
||
|
||
### 4. 检查网络连接
|
||
```javascript
|
||
// 在 APP 中测试网络
|
||
uni.request({
|
||
url: 'http://服务器IP:30091/api/health',
|
||
success: (res) => console.log('服务器连接正常'),
|
||
fail: (err) => console.error('服务器连接失败:', err)
|
||
})
|
||
```
|