Ai_GirlFriend/测试音乐库唱歌功能.md

测试音乐库唱歌功能

✅ 修复完成

前端代码已修复，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

成功的响应

{
  "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
状态: ✅ 可以开始测试