scottpan/msh-system

Files

msh-agent 2facd355ab feat(ai-nutritionist): Coze TTS and streaming robustness

- Add Coze TTS endpoint and service; expose binary MP3 from controller.
- Bypass ResponseFilter for /audio/speech so MP3 bodies are not UTF-8 wrapped.
- UniApp: cozeTextToSpeech, TTS UI and play flow; SSE HTTP errors and diagnostics.
- Document TTS in docs/features.md; extend test-0325-1 with curl verification.

Made-with: Cursor

2026-03-31 07:07:21 +08:00

2.3 KiB

Raw Blame History

手动测试问题

页面（pages/tool/ai-nutritionist）

1. 请求Request URL: http://127.0.0.1:20822/api/front/coze/chat/stream, 参数：{"botId":"7591133240535449654","userId":11,"additionalMessages":[{"role":"user","content":"透析患者可以喝牛奶吗？","content_type":"text"}],"stream":true,"autoSaveHistory":true}，请求后页面显示："未能获取到有效回复。"

修复记录

1. 流式对话显示"未能获取到有效回复"

根因分析（三个层次）：

HTTP 状态码未检查 — cozeChatStream() 的 success 回调不检查 res.statusCode。后端发生异常时（如 botID is marked non-null but is null），Spring GlobalExceptionHandler 返回 HTTP 500 + JSON 错误体，前端 parseSseResponseBody 找不到 data: 行后静默忽略，直接触发 _onComplete()，最终展示"未能获取到有效回复"。
SSE 解析错误全部静默吞噬 — parseSseLines() / parseSseResponseBody() 的 catch 块为空，JSON 解析失败时无任何输出，排查困难。
错误提示固定话术，掩盖真实原因 — onError 回调展示固定文字"抱歉，处理您的请求时出现错误"，而非后端实际错误信息。

修复内容：

models-api.js — cozeChatStream() 的 success 回调添加 res.statusCode !== 200 检查，提取后端 message/msg 字段作为错误信息调用 _onError；在 chunk 接收、SSE 解析、降级解析各环节添加 console.log / console.warn 诊断日志。
ai-nutritionist.vue — sendToAIStream() 的 onError 改为展示 err.message 而非固定话术。

后端独立验证命令（用于确认 SSE 是否正常）：

curl -N -X POST 'http://127.0.0.1:20822/api/front/coze/chat/stream' \
  -H "Content-Type: application/json" \
  -d '{"botId":"7591133240535449654","userId":"11","additionalMessages":[{"role":"user","content":"透析患者可以喝牛奶吗？"}]}'

若后端正常，应逐行输出 data:{"event":"conversation.message.delta","content":"..."} 流；若返回 {"code":500,"message":"..."} 则说明后端有问题需优先排查。

参考文档

1. coze官方api文档：https://docs.coze.cn/developer_guides/chat_v3#AJThpr1GJe
1. /Users/a123/msh-system/.cursor/plans/optimize_ai_nutritionist_speed_b6e9a618.plan.md