122 lines
2.8 KiB
Markdown
122 lines
2.8 KiB
Markdown
# 测试音乐库唱歌功能
|
||
|
||
## ✅ 修复完成
|
||
|
||
前端代码已修复，API 参数传递问题已解决。
|
||
|
||
---
|
||
|
||
## 🧪 测试步骤
|
||
|
||
### 1. 启动后端服务
|
||
|
||
双击运行：`启动后端服务.bat`
|
||
|
||
等待看到：
|
||
```
|
||
INFO: Uvicorn running on http://0.0.0.0:30101
|
||
INFO: Application startup complete.
|
||
```
|
||
|
||
### 2. 验证 API
|
||
|
||
打开浏览器访问：http://localhost:30101/docs
|
||
|
||
找到 `POST /music/convert-to-song`，应该能看到：
|
||
- 参数：`music_id` (query, required, integer)
|
||
|
||
### 3. 重新编译前端
|
||
|
||
保存 `xuniYou/pages/index/index.vue` 后，重新编译前端项目。
|
||
|
||
### 4. 测试功能
|
||
|
||
#### 测试场景 1：直链音乐（应该成功）
|
||
1. 打开应用，进入音乐库
|
||
2. 点击任意 Bensound 音乐（直链音乐）
|
||
3. 应该弹出确认框："确定让她唱《xxx》吗？"
|
||
4. 点击"确定"
|
||
5. 应该显示"准备中..." → "生成中..."
|
||
6. 生成完成后自动切换到"历史记录" tab
|
||
7. 视频自动播放
|
||
|
||
#### 测试场景 2：外部链接音乐（应该提示）
|
||
1. 点击外部平台音乐（网易云、QQ音乐）
|
||
2. 应该弹出提示："外部平台音乐无法生成视频，请使用直链或上传的音乐"
|
||
|
||
#### 测试场景 3：重复生成（应该使用缓存）
|
||
1. 再次点击相同的音乐
|
||
2. 应该立即成功（不需要等待生成）
|
||
3. 直接显示"生成成功"并播放视频
|
||
|
||
---
|
||
|
||
## 🐛 已修复的问题
|
||
|
||
### 问题：API 参数传递错误
|
||
|
||
**错误日志**：
|
||
```
|
||
fastapi.exceptions.RequestValidationError: 1 validation error:
|
||
{'type': 'missing', 'loc': ('query', 'music_id'), 'msg': 'Field required', 'input': None}
|
||
```
|
||
|
||
**原因**：
|
||
- 后端定义：`music_id: int`（query 参数）
|
||
- 前端发送：`data: { music_id: music.id }`（body 参数）
|
||
|
||
**解决**：
|
||
修改前端为：`url: baseURLPy + '/music/convert-to-song?music_id=' + music.id`
|
||
|
||
---
|
||
|
||
## 📊 预期结果
|
||
|
||
### 成功的请求日志
|
||
```
|
||
INFO: POST /music/convert-to-song?music_id=1 HTTP/1.1" 200 OK
|
||
INFO: POST /sing/generate HTTP/1.1" 200 OK
|
||
```
|
||
|
||
### 成功的响应
|
||
```json
|
||
{
|
||
"code": 1,
|
||
"message": "success",
|
||
"data": {
|
||
"song_id": 123,
|
||
"status": "succeeded",
|
||
"video_url": "https://..."
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 🔍 调试技巧
|
||
|
||
### 查看后端日志
|
||
后端服务会输出详细日志，包括：
|
||
- 请求 URL 和参数
|
||
- 数据库查询
|
||
- 错误信息
|
||
|
||
### 查看前端日志
|
||
按 F12 打开浏览器开发者工具：
|
||
- **Console** 标签：查看 JavaScript 错误
|
||
- **Network** 标签：查看 API 请求和响应
|
||
|
||
### 常见问题
|
||
|
||
1. **422 错误**：参数传递错误（已修复）
|
||
2. **401 错误**：TOKEN 过期，需要重新登录
|
||
3. **404 错误**：API 路径错误或后端服务未启动
|
||
4. **500 错误**：后端服务异常，查看后端日志
|
||
|
||
---
|
||
|
||
**测试说明版本**: 1.0
|
||
**创建时间**: 2026-02-04 18:15
|
||
**状态**: ✅ 可以开始测试
|
||
|