Skip to content

fix(resume): 分析失败不再降级为 0 分 COMPLETED - #65

Open
amxl1202 wants to merge 1 commit into
Snailclimb:masterfrom
amxl1202:fix/resume-analysis-failed-status
Open

amxl1202 wants to merge 1 commit into
Snailclimb:masterfrom
amxl1202:fix/resume-analysis-failed-status

Conversation

@amxl1202

Copy link
Copy Markdown

问题

ResumeGradingService#analyzeResume 在 LLM 调用失败时返回一份 0 分的降级占位结果(createErrorResponse),而不是抛异常。原因是内层 catch 抛出的 BusinessException 会被外层 catch (Exception e) 捕获,异常无法传播到 AbstractStreamConsumer。

AnalyzeStreamConsumer#processBusiness 拿到这份"结果"后正常返回,基类走 markCompleted 分支:

  • resumes.analyze_status 被写成 COMPLETED 并 ACK 消息
  • Stream 的 retryMessage 永远不会触发
  • ResumeAnalysisRecoveryScheduler 也扫不到该任务(shouldSkip 见 COMPLETED 直接跳过)

结果是:用户看到一份 0 分的"分析报告",系统却认为这次分析成功了,两条补偿路径全部失效。触发场景包括 LLM 429 限流、请求超时、网络抖动、模型名配置错误。

改动

  • 移除 analyzeResume 的外层 catch (Exception) 与 createErrorResponse
  • 同时删除内层那个仅重复包裹的 catch(StructuredOutputInvoker 失败时本就会抛出 BusinessException(RESUME_ANALYSIS_FAILED))
  • createErrorResponse 删除后已无调用方,一并移除

链路回到设计本意:失败抛出 → 基类捕获 → 重试最多 3 次 → 耗尽后 markFailed 落 FAILED + 原因,恢复调度器也能重新扫到。

测试

新增 / 补充 3 个用例:

位置 用例
ResumeGradingServiceTest LLM 失败时抛 BusinessException,不返回 0 分结果
ResumeGradingServiceTest 非业务异常也不再被吞成占位结果
AnalyzeStreamTest 分析失败时向上抛出,且不落库占位报告

全量 ./gradlew :app:test:485 用例,0 失败 0 错误,49 跳过。

端到端验证

把 provider 的 baseUrl 指向不可达地址后重新分析:

  • 日志中 retryCount 依次递增 0 → 1 → 2 → 3(共 4 次尝试,间隔约 2.5 秒)
  • 重试耗尽后状态变为 FAILED,analyze_error 写入失败原因
  • 改回 baseUrl 后点重新分析,状态恢复 COMPLETED 并产出新分数

补充说明:这段端到端是在方案 B 的本地实现下完成的(保留在独立分支,未提交)。方案 A 与 B 的差异只在异常产生的位置——B 由消费者判断后抛出,A 由 service 直接抛出,两者都从 processBusiness 抛出、进入 AbstractStreamConsumer 的同一个 catch,因此下游链路完全一致。方案 A 的失败抛出行为由新增的 ResumeGradingServiceTest 覆盖。

关于方案选择

Issue #63 里提过两个方向:A(直接抛,走重试)和 B(保留降级结果 + 加 degraded 标记)。

最终选 A,因为 B 如果只保留占位结果而不落库,行为与 A 等价却多一层间接;若要在重试耗尽后真的落库降级报告,会与 getLatestAnalysis 的语义冲突——它会把降级报告当成正常分析结果返回,前端 AnalysisPanel 会渲染成一份正常报告,正好又回到这个 issue 要修的现象,因此需要连带改查询层和前端,成本高于收益。

方案 B 的实现没有丢弃,保留在本地分支上。后续如果确实需要"失败也给用户一份可读报告",可以在此基础上扩展。

Closes #63

ResumeGradingService#analyzeResume 的内层 catch 抛出的 BusinessException 会被外层
catch 捕获,异常无法传播到 AbstractStreamConsumer 的失败分支。消费者拿到 0 分占位
结果后走 markCompleted,把 analyze_status 写成 COMPLETED 并 ACK 消息,导致 Stream
重试(retryMessage)与恢复调度(ResumeAnalysisRecoveryScheduler)双双失效 ——
shouldSkip 见到 COMPLETED 直接跳过,两条补偿路径都不会再触发。触发场景包括 LLM
429 限流、请求超时、网络抖动、模型名配置错误。

移除外层 catch 与 createErrorResponse,失败时直接抛出 StructuredOutputInvoker 已
构造的 BusinessException(RESUME_ANALYSIS_FAILED);内层那个仅重复包裹的 catch 一并
删除(与 cabf278 的意图一致:让异常向上传播)。

补测试锁住契约:
- ResumeGradingServiceTest:失败必须抛出,不能被吞成 0 分结果(含非业务异常)
- AnalyzeStreamTest:分析失败时向上抛出,且不落库占位报告

Fixes Snailclimb#63
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.

简历分析失败时状态被标记为 COMPLETED,导致 Stream 重试与恢复调度无法触发

1 participant