# 后端问题诊断报告

> 生成时间：2026-05-31  
> 涉及模块：考察训练系统 - 考试提交 / AI批改服务  
> 问题级别：**P1 - 高（功能不可用）**

---

## 一、问题描述

### 1.1 现象

用户在正式考试中提交试卷（含空白答案或已作答答案）时，前端收到 **HTTP 500 错误**，考试记录无法正常结束。

### 1.2 复现步骤

1. 进入「考察和训练」→ 选择试卷 → 开始考试
2. 不作答（或部分作答）任何题目
3. 点击「提交试卷」按钮
4. 前端控制台输出错误日志（见下方）
5. 页面提示「提交失败」或「系统异常」

### 1.3 前端控制台错误日志

```
[提交] ⚠️ 空白试卷提交 — recordId: fa779367-bebb-48e7-af75-68e582c8ae7b 总题数: 5
[examAPI] submit(空白提交) - recordId: fa779367-bebb-48e7-af75-68e582c8ae7b
[提交] submit(结束考试) 失败:
  message: 系统异常
  无response对象(可能是网络错误/CORS)
[examAPI] 正式考试提交批改 - recordId: fa779367-bebb-48e7-af75-68e582c8ae7b 题目数: 5
[提交] gradeExamRecord(空答案) 失败:
  message: 提交失败: Service层批改题目失败: 调用AI服务失败:
    POST请求失败: 500 INTERNAL SERVER ERROR:
    "{"error_code":"GRADE_ERROR",
      "message":"'NoneType' object has no attribute 'get'",
      "status":"failed",
      "status_code":5021,
      "success":false}"
[提交] 所有2种提交方式均失败
```

---

## 二、根因分析

### 2.1 直接原因：Python AI 批改服务崩溃

后端 Java 服务在处理考试提交时，调用 Python AI 服务进行自动批改。Python 服务在接收到**空答案数据**时发生 `TypeError`：

```
'NoneType' object has no attribute 'get'
```

**错误位置**：Python AI 批改服务的答案解析/评分逻辑中  
**触发条件**：`answers` 参数为空列表、空字典或 `None` 时，代码对 `None` 对象调用了 `.get()` 方法

### 2.2 根本原因：所有提交接口均强制调用 AI 批改

| 接口 | HTTP方法 | 路径 | 内部行为 | 受影响 |
|------|---------|------|---------|--------|
| `submitExam()` | POST | `/admin/exam/paper/{recordId}/submit` | → `gradeAnswersForRecord()` → **调用Python AI** | ✅ 全部用户 |
| `gradeAnswers()` | POST | `/admin/exam/paper/{recordId}/grade` | → **调用Python AI** | ✅ 全部用户 |
| `gradeAnswersForRecord()` | POST | `/exam/record/{recordId}/grade` | → **调用Python AI** | ✅ 全部用户 |

**关键发现**：后端**不存在**"仅更新状态、不触发AI批改"的纯提交接口。`submit` 接口虽然名称为"提交"，但内部实际执行的是完整的AI批改流程。**

### 2.3 数据流图

```
┌──────────┐    POST /record/{id}/submit     ┌─────────────────────┐
│  前端     │ ──────────────────────────────→ │ AdminExamController   │
│  提交     │    body: {} (空白)             │ .submitExam()         │
└──────────┘                                └──────────┬──────────┘
                                                      │
                                              examService.gradeAnswersForRecord()
                                                      │
                                              ┌─────────▼──────────┐
                                              │  Java Service层     │
                                              │  组装answers参数     │
                                              └─────────┬──────────┘
                                                        │
                                              HTTP POST (内部调用)
                                                        │
                                              ┌─────────▼──────────┐
                                              │  Python AI 批改服务  │
                                              │                     │
                                              │  answers = None/[]  │ ← 空值传入
                                              │       ↓              │
                                              │  data.get('xxx')    │ ← 💥 TypeError!
                                              │  'NoneType' object  │
                                              │  has no attribute    │
                                              │  'get'              │
                                              └─────────┬──────────┘
                                                        │
                                              返回 HTTP 500 + error_code=5021
                                                        │
                                              ┌─────────▼──────────┐
                                              │  AdminExamController │
                                              │  catch(Exception)   │
                                              │  return Result.error │
                                              │  (500, e.getMessage())│
                                              └─────────┬──────────┘
                                                        │
                                              HTTP 500 { code:500, message:"..." }
                                                        │
                                              axios拦截器包装 Error("系统异常")
                                                        │
                                              前端显示 "提交失败: 系统异常"
```

---

## 三、影响范围

### 3.1 功能影响

| 功能 | 影响 | 说明 |
|------|------|------|
| 正式考试提交（空白卷） | ❌ 完全不可用 | 所有题型答案为空时必现 |
| 正式考试提交（有答案） | ⚠️ 可能不可用 | 取决于Python服务是否对所有题型都做了空值保护 |
| 日常练习提交 | ⚠️ 可能受影响 | 同样走AI批改流程 |
| 试卷发布 | ⚠️ 需单独验证 | 发布接口不涉及AI批改，但当前也报错（需进一步排查） |

### 3.2 用户影响

- **全部角色用户**受影响（系统管理员、部门管理员、普通用户）
- 无法完成考试流程闭环（开始考试 → 提交 → 查看成绩）
- 已开始的考试记录卡在 `not_started` 或中间状态

---

## 四、修复方案

### 方案A：Python AI 服务空值防御（推荐 - 快速修复）

**修改文件**：Python AI 批改服务入口文件（具体路径待确认）  
**修复内容**：在接收 `answers` 参数后立即做空值检查

```python
# === 修复前 ===
def grade_answers(questions, answers):
    for q in questions:
        ans = answers.get(q['id'])        # ← answers=None时崩溃
        score = calculate_score(ans)

# === 修复后 ===
def grade_answers(questions, answers):
    # 防御性检查：空值直接返回0分
    if not answers or not isinstance(answers, (dict, list)):
        return {
            "score": 0,
            "total_score": 0,
            "details": [],
            "success": True,
            "message": "空白试卷，无需批改"
        }
    
    if isinstance(answers, dict) and len(answers) == 0:
        return {"score": 0, "total_score": 0, "details": [], "success": True}
    
    if isinstance(answers, list) and all(
        a is None or a == '' or a.get('answer', '') == '' 
        for a in answers if isinstance(a, dict)
    ):
        return {"score": 0, "total_score": 0, "details": [], "success": True}
    
    # 正常批改逻辑...
    for q in questions:
        ans = answers.get(q['id']) if isinstance(answers, dict) else None
        if ans is None or ans == '':
            continue  # 跳过无答案的题目
        score = calculate_score(ans)
```

**优点**：
- 改动最小，只修改Python侧
- 不影响现有正常答题的批改逻辑
- 空白试卷自动得0分，符合业务预期

**缺点**：
- 未解决架构问题（submit接口仍强依赖AI服务）

---

### 方案B：新增纯提交接口（推荐 - 完整修复）

**修改文件**：
- `AdminExamController.java` — 新增接口
- `ExamPaperService.java` / `ExamPaperServiceImpl.java` — 新增方法

#### B.1 后端新增接口

```java
// AdminExamController.java - 新增
@Operation(summary = "结束考试(不批改)", description = "仅更新考试状态为已完成，不做AI批改")
@PostMapping("/admin/exam/paper/{recordId}/finish")
public Result<Void> finishExam(
        @PathVariable String recordId,
        HttpServletRequest httpRequest) {
    try {
        Long userId = getCurrentUserId(httpRequest);
        ExamRecord record = examRecordMapper.selectById(recordId);
        
        if (record == null) {
            return Result.error(404, "考试记录不存在");
        }
        
        // 仅更新状态，不调用AI批改
        record.setStatus("completed");
        record.setScore(0);           // 空白卷默认0分
        record.setSubmitTime(LocalDateTime.now());
        record.setUpdatedAt(LocalDateTime.now());
        examRecordMapper.updateById(record);
        
        log.info("考试结束(未批改): recordId={}, userId={}", recordId, userId);
        return Result.success();
    } catch (Exception e) {
        log.error("结束考试失败: {}", e.getMessage(), e);
        return Result.error(500, e.getMessage());
    }
}
```

#### B.2 前端对接

```javascript
// useExam.js - 空白试卷优先使用finish接口
if (isBlankSubmission) {
  _variants.push({ 
    label: 'finishExam(结束考试)', 
    fn: () => examAPI.finishExam(recordId)  // 新增API
  })
  _variants.push({ 
    label: 'submit(结束考试)', 
    fn: () => examAPI.submit(recordId)       // 兜底
  })
} else {
  // 有答案的正常走AI批改
  _variants.push({
    label: 'gradeExamRecord(批改)',
    fn: () => examAPI.gradeExamRecord(recordId, formattedAnswers)
  })
  // ...
}
```

```javascript
// exam.js API层新增
finishExam: (recordId) => {
    if (!recordId) throw new Error('考试记录ID不能为空')
    return examClient.post(`/admin/exam/paper/${encodeURIComponent(recordId)}/finish`, {}, { timeout: 15000 })
        .then(handleExamResponse)
},
```

**优点**：
- 彻底解耦"提交"与"批改"
- 空白试卷不再触发AI服务
- 符合单一职责原则
- 可后续异步补批改

**缺点**：
- 需要前后端配合改动
- 空白卷暂无成绩明细（可后续补充手动打分功能）

---

### 方案C：Java Service 层增加空值保护（折中方案）

**修改文件**：`ExamServiceImpl.java` 的 `gradeAnswersForRecord()` 方法

```java
@Override
public ExamRecordResponse gradeAnswersForRecord(String recordId, ExamSaveRequest request, Long userId, String answerType) {
    // 新增：前置空值检查
    List<AnswerItem> answers = request.getAnswers();
    if (answers == null || answers.isEmpty() || 
        answers.stream().allMatch(a -> a.getAnswer() == null || a.getAnswer().isBlank())) {
        
        log.info("检测到空白试卷，跳过AI批改: recordId={}", recordId);
        
        // 直接更新状态为已完成，分数为0
        ExamRecord record = examRecordMapper.selectOne(
            new LambdaQueryWrapper<ExamRecord>().eq(ExamRecord::getRecordId, recordId));
        if (record != null) {
            record.setStatus("completed");
            record.setScore(0);
            record.setSubmitTime(LocalDateTime.now());
            examRecordMapper.updateById(record);
        }
        
        return ExamRecordResponse.builder()
            .recordId(recordId)
            .score(0)
            .totalScore(0)
            .status("completed")
            .build();
    }
    
    // 原有AI批改逻辑...
}
```

**优点**：
- 只改Java层，不动Python
- 对前端透明，无需前端改动
- 快速上线

**缺点**：
- submit接口语义仍混乱（名为提交实为批改）
- 未从根本上解决问题

---

## 五、推荐实施计划

| 优先级 | 方案 | 工作量 | 建议 |
|--------|------|--------|------|
| **P0 - 立即** | **方案C** | 30min | 先恢复基本功能 |
| **P1 - 本周** | **方案A** | 1h | Python侧彻底修复 |
| **P2 - 迭代** | **方案B** | 3h | 架构优化 |

**建议先实施方案C快速止血，再按方案A+方案B逐步完善。**

---

## 六、相关附件

### 6.1 涉及的后端文件清单

| 文件 | 路径 | 作用 |
|------|------|------|
| `AdminExamController.java` | `demo/src/main/java/top/tqx/demo_1/controller/` | 考试管理REST接口 |
| `ExamController.java` | `demo/src/main/java/top/tqx/demo_1/controller/` | 用户侧考试接口 |
| `ExamPaperService.java` | `demo/src/main/java/top/tqx/demo_1/service/` | 考试业务接口定义 |
| `ExamPaperServiceImpl.java` | `demo/src/main/java/top/tqx/demo_1/service/impl/` | 考试业务实现（含AI调用） |
| Python AI批改服务 | 待确认路径 | 自动评分核心逻辑 |

### 6.2 涉及的前端文件清单（已优化）

| 文件 | 路径 | 已完成的优化 |
|------|------|------------|
| `useExam.js` | `src/components/exam/composables/` | 空白试卷优先走submit；增强错误诊断日志 |
| `PaperManagementPanel.vue` | `src/components/exam/` | 发布错误增强诊断（originalError回溯） |
