跳到主要内容

改写结果处理与兜底机制

上一篇讲完了问题改写服务的完整实现，这一篇我们来看改写完成后，系统如何处理改写结果，以及如何应对改写失败的情况。

改写结果的处理​

问题改写完成后，prepare 方法会拿到一个 RagRewriteResult 对象（可能为 null）。接下来要做的第一件事就是从这个结果里提取出两个关键信息：

  1. 改写后的问题 - 用于后续的检索和路由
  2. 子问题列表 - 如果问题被拆分了，需要分别检索每个子问题
// 如果改写结果为空，则退回原问题；子问题同理，至少保证有一个检索问题可用。
String rewriteQuestion = rewriteResult == null ? safeText(question) : firstNonBlank(rewriteResult.getRewrittenQuestion(), safeText(question));
List<String> rewriteSubQuestions = rewriteResult == null || rewriteResult.getSubQuestions() == null || rewriteResult.getSubQuestions().isEmpty()
    ? List.of(rewriteQuestion)
    : rewriteResult.getSubQuestions();

这段代码看起来有点长，但逻辑很清晰，我们分开来看。

rewriteQuestion 的提取逻辑​

String rewriteQuestion = rewriteResult == null 
    ? safeText(question) 
    : firstNonBlank(rewriteResult.getRewrittenQuestion(), safeText(question));

这行代码用了一个三元表达式，分两种情况：

情况一：改写结果为 null

如果 rewriteResult == null，说明改写服务调用失败或返回了空结果，这时候直接用 safeText(question) 作为改写问题。

情况二：改写结果不为 null

如果改写结果存在，就调用 firstNonBlank(rewriteResult.getRewrittenQuestion(), safeText(question))，这个方法会：

  1. 先尝试取 rewriteResult.getRewrittenQuestion()
  2. 如果这个值为空，就退回到 safeText(question)

safeText 和 firstNonBlank 工具方法​

这两个工具方法在代码里经常出现，它们的作用是保证字符串不为 null：

/**
 * 安全地获取文本，null 转空字符串。
 */
private String safeText(String text) {
    return StrUtil.blankToDefault(text, "");
}

/**
 * 返回第一个非空文本。
 */
private String firstNonBlank(String... values) {
    for (String value : values) {
        if (StrUtil.isNotBlank(value)) {
            return value.trim();
        }
    }
    return "";
}

safeText 就是把 null 转成空字符串，firstNonBlank 则是从多个候选值里找第一个非空的。

为什么要这么多层兜底？

改写服务可能会失败（模型调用失败、解析失败等），即使成功了，模型返回的 rewrittenQuestion 字段也可能为空。系统通过多层兜底，保证无论发生什么情况，都至少有一个可用的问题文本，不会让后续流程因为空值而中断。

rewriteSubQuestions 的提取逻辑​

List<String> rewriteSubQuestions = rewriteResult == null || rewriteResult.getSubQuestions() == null || rewriteResult.getSubQuestions().isEmpty()
    ? List.of(rewriteQuestion)
    : rewriteResult.getSubQuestions();

这行代码也是一个三元表达式，判断条件更复杂一些：

触发兜底的三种情况

只要满足以下任意一个条件，就会触发兜底逻辑：

  1. rewriteResult == null - 改写结果为空
  2. rewriteResult.getSubQuestions() == null - 子问题列表为 null
  3. rewriteResult.getSubQuestions().isEmpty() - 子问题列表为空

付费内容提示

该文档的全部内容仅对「码力全开」项目实战&技术讲解 知识星球用户开放

加入星球，一次获得完整项目资料、全栈技术知识库和长期答疑服务。

100万+字全栈技术知识库深入讲解技术核心、数据库、中间件和分布式等内容
8套热门的实战项目持续更新的企业级项目覆盖高并发、微服务、数据中台 和 AI Agent 等方向
AI 技术知识大模型面试详解覆盖 AI 模型原理、Agent、RAG、MCP、Skills、Harness 等核心知识点
文档 + 视频两种讲解形式既能系统阅读，也能跟随视频理解核心业务

完整项目实战资料

每套项目均包含从 0 到 1 讲解文档核心业务讲解视频

从基础项目到复杂业务场景，项目资料会持续更新。

8 套项目
  • 01Nexus Agent AI 智能体
  • 02Nexus Agent Pro 完全版
  • 03黑马点评Plus
  • 04大麦
  • 05大麦Pro
  • 06大麦AI
  • 07流量切换
  • 08数据中台

加入后还能获得

进入星球后，即可享受上述所有服务，保证不会再有其他隐藏费用。

从学习、面试到项目启动，都可以继续获得支持。

  • 1 对 1 解答项目和技术问题都可以提问
  • 针对性补充没有讲清楚的内容会继续补充
  • 面试与简历指导梳理回答技巧和项目亮点
  • 中间件云环境项目依赖可以直接接入使用
  • 面试后复盘被问住的问题可以继续交流
  • 远程问题解决项目启动问题可协助排查
知识星球二维码

扫码进入知识星球

  1. 打开微信，扫描左侧二维码，加入「码力全开」项目实战&技术讲解 知识星球
  2. 查看星球使用指导，获取完整项目讲解资料索引
解锁全部付费内容
🎁优惠