Skip to content

Fix #25: give feedback failures their own error wording - #36

Open
xiaoyao-666-coder wants to merge 2 commits into
zhengdaodeguL:mainfrom
xiaoyao-666-coder:fix/issue-25-feedback-422-message
Open

xiaoyao-666-coder wants to merge 2 commits into
zhengdaodeguL:mainfrom
xiaoyao-666-coder:fix/issue-25-feedback-422-message

Conversation

@xiaoyao-666-coder

Copy link
Copy Markdown

问题

反馈失败(例如 422,服务端返回 {"detail": ...})时,UI 把 formatHttpError 的通用文案显示出来,文案写的是“请检查问题描述并重试”——那是聊天输入框的校验文案,跟反馈半点关系没有。根因是 sendFeedback 的失败分支复用了聊天场景的错误处理,文案与场景完全错位。

修复

  • formatHttpError 没动:它在会话初始化和聊天发送两处服务于提问场景,一字未改。反馈单独走新纯模块 frontend/src/feedback-error.ts 的 formatFeedbackError(沿用项目已有的场景专属格式化器模式,如 formatAuthError),App.tsx 里 sendFeedback 的 catch 只换了这一处调用(5 行增、1 行删)。401 提前回登录页的逻辑原样保留。
  • 文案分层(formatFeedbackError({status, detail}),detail 是 ensureResponseOk 已解析好的服务端 detail,含 FastAPI 数组型 detail 拼成的 msg 串):
    • 4xx 有 detail → 直接展示,如 422 显示“反馈提交失败:反馈目标不属于当前会话”(后端 /api/feedback 的真实 detail);无 detail → 按状态给反馈专属通用文案,如 422 是“反馈内容未通过校验,请重试。”、404 是“当前会话已过期,请新建整理后重试。”;
    • 429 → “提交过于频繁,请稍后再试。”;426 → HTTPS 入口文案;409 → “反馈刚刚被其他请求更新,请稍后重试。”;401/403 → 重新登录文案(防御性兜底,调用方已先处理 401);
    • 5xx 不展示 detail——那是后端原始异常文本(如 SessionBackendError 的 str(exc),可能含内网地址/连接信息),一律用“整理服务暂时不可用,请稍后重试。”;
    • detail 会 trim,空白视为无 detail,超 200 字截断加“…” 。

验证

  • 前端:npm test 32 pass / 0 fail(基线 10 + 新增 22),npm run build 正常。覆盖:422 有/无 detail、FastAPI 校验 detail 原样展示、404 有/无 detail、5xx 不泄露后端 detail、429/426、401 兜底、空白 detail、超长截断、未知状态,以及一个横扫断言——12 种状态×detail 组合的输出里都不含“问题描述”/“2000”。
  • 后端:MEDGUIDE_MODE=test python -m pytest -q backend/tests 521 passed(基线,无后端改动)。
  • App.tsx 只改了 import 和 sendFeedback 的 catch;formatHttpError 本身及其两个聊天调用点未动,聊天发送的错误文案不受影响(diff 审查确认)。
  • 未做浏览器实点验证:云端点不了按钮,错误文案的实际显示需在浏览器上点一次确认(可用一个已被删/过期会话的消息点反馈触发 422)。

已知遗留

  • 5xx 不展示 detail 是有意为之:如果上游希望 503 时也显示“服务依赖尚未就绪”这类相对安全的 detail,可以再放宽,但本次按不泄露后端内部信息处理。

Closes #25

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[中] 反馈失败的错误文案张冠李戴

1 participant