Difficulty字段丢失问题修复报告

问题描述

用户反映在创建学习目标时选择的难度是"中等"，目标创建成功并正确保存了difficulty字段，但在调用Coze生成题目时，响应体中的difficulty字段变成了null。

问题分析过程

1. 问题定位

通过详细的代码分析和测试，确定了difficulty字段的完整传递链路：

Android客户端 -> /api/goals (目标创建) ✅ 正确保存difficulty
Android客户端 -> /api/coze/generate-questions (Coze API调用) ✅ 正确传递difficulty
CozeWorkflowService.buildCozeRequest() ✅ 正确构建请求参数
Coze API调用 ❌ 返回difficulty为null
CozeWorkflowService.parseQuestion() ❌ 直接使用null值
AIQuestionService.saveCozeQuestionsToGoalDetail() ❌ 保存null值到数据库

2. 根本原因

Coze API本身返回的difficulty字段为null，而后端代码没有fallback逻辑来处理这种情况。

3. 测试验证

创建了完整的测试脚本 test_difficulty_flow_debug.py 来验证整个流程：

=== 修复前测试结果 ===
题目1 - difficulty: None, 预期: 中等
❌ 题目1 difficulty字段为null

=== 修复后测试结果 ===
题目1 - difficulty: 中等, 预期: 中等
✅ 题目1 difficulty字段正确

解决方案

修改文件

server/src/main/java/com/example/baseserver/service/CozeWorkflowService.java

具体修改内容

1. 修改parseCozeResponse方法签名

// 修改前
private CozeWorkflowResponse parseCozeResponse(String responseBody) throws JsonProcessingException

// 修改后
private CozeWorkflowResponse parseCozeResponse(String responseBody, String originalDifficulty) throws JsonProcessingException

2. 修改parseQuestion方法，添加fallback逻辑

// 修改前
private CozeWorkflowResponse.GeneratedQuestion parseQuestion(JsonNode questionNode)

// 修改后
private CozeWorkflowResponse.GeneratedQuestion parseQuestion(JsonNode questionNode, String originalDifficulty)

3. 添加difficulty字段的fallback处理

// 解析难度字段，添加fallback逻辑
String difficulty = null;
if (questionNode.has("difficulty") && !questionNode.get("difficulty").isNull()) {
    difficulty = questionNode.get("difficulty").asText();
}

// 如果Coze返回的difficulty为null或空，使用原始请求中的difficulty
if (difficulty == null || difficulty.trim().isEmpty()) {
    difficulty = originalDifficulty;
    log.warn("Coze API返回的difficulty为null，使用原始difficulty: {}", originalDifficulty);
}

builder.difficulty(difficulty);

4. 更新方法调用

// 在generateQuestions方法中
CozeWorkflowResponse result = parseCozeResponse(response, request.getDifficulty());

// 在parseCozeResponse方法中
CozeWorkflowResponse.GeneratedQuestion question = parseQuestion(questionNode, originalDifficulty);

修复效果

修复前

Coze API返回difficulty为null
题目保存到数据库时difficulty字段为null
用户看到的题目没有难度信息

修复后

当Coze API返回difficulty为null时，自动使用原始请求中的difficulty值
题目正确保存difficulty字段到数据库
用户看到的题目显示正确的难度信息
添加了警告日志，便于监控Coze API的异常情况

技术要点

Fallback机制：当外部API返回不完整数据时，使用本地数据作为备选
参数传递：在方法调用链中正确传递原始参数
日志记录：添加适当的警告日志来监控异常情况
数据完整性：确保保存到数据库的数据完整性

预防措施

API响应验证：对外部API的响应进行完整性检查
数据备份策略：关键字段应该有fallback机制
监控告警：通过日志监控外部API的异常情况
测试覆盖：编写完整的集成测试验证数据流

测试建议

定期运行 test_difficulty_flow_debug.py 验证完整流程
监控日志中的警告信息："Coze API返回的difficulty为null"
检查数据库中题目的difficulty字段完整性
测试不同难度级别的题目生成

总结

此次修复成功解决了difficulty字段丢失的问题，通过添加fallback机制确保了数据的完整性。修复方案不仅解决了当前问题，还提高了系统的健壮性，能够应对外部API返回不完整数据的情况。

修复状态：✅ 已完成
测试状态：✅ 通过
部署状态：✅ 已部署

difficulty_field_fix_report.md 4.5 KB Permalink History Raw