creative_studio/审核系统修复报告_补充.md

审核系统422错误修复报告（补充）

问题描述

创建审核规则时出现 422 错误：

POST http://localhost:8000/api/v1/custom-rules?project_id=8f969272-4ece-49e7-8ca1-4877cc62c57c 422 (Unprocessable Entity)

问题原因分析

根本原因：字段名称不匹配

前端发送的字段名： category（如 "character", "plot" 等） 后端期望的字段名： dimension（如 DimensionType.character, DimensionType.plot 等）

后端的 CustomRuleCreate 模型只接受 dimension 字段，不接受 category 字段，导致 FastAPI 验证失败。

修复方案

1. 修改后端数据模型（backend/app/models/review.py）

修改 CustomRuleCreate 模型

class CustomRuleCreate(BaseModel):
    """创建自定义规则请求"""
    name: str = Field(..., description="规则名称")
    description: str = Field("", description="规则描述")
    trigger_condition: str = Field(..., description="触发条件")
    dimension: Optional[DimensionType] = Field(None, description="所属维度")
    severity: SeverityLevel = Field(SeverityLevel.medium, description="严重程度")
    category: Optional[str] = Field(None, description="分类（前端使用）")  # 新增

修改 CustomRuleUpdate 模型

class CustomRuleUpdate(BaseModel):
    """更新自定义规则请求"""
    name: Optional[str] = None
    description: Optional[str] = None
    trigger_condition: Optional[str] = None
    dimension: Optional[DimensionType] = None
    severity: Optional[SeverityLevel] = None
    enabled: Optional[bool] = None
    category: Optional[str] = None  # 新增

2. 修改后端 API 路由（backend/app/api/v1/review.py）

创建规则函数中的映射逻辑

# 处理 category 到 dimension 的映射
if rule_data.category:
    # 映射 category 到 dimension
    category_to_dimension = {
        "character": DimensionType.character,
        "plot": DimensionType.plot,
        "dialogue": DimensionType.dialogue,
        "pacing": DimensionType.pacing,
        "emotion": DimensionType.emotional_depth,
        "theme": DimensionType.thematic_strength,
        "other": DimensionType.custom
    }
    dimension = category_to_dimension.get(rule_data.category, DimensionType.custom)
else:
    dimension = rule_data.dimension or DimensionType.custom

更新规则函数中的映射逻辑

# 处理 category 到 dimension 的映射
if 'category' in update_data:
    category_to_dimension = {
        "character": DimensionType.character,
        "plot": DimensionType.plot,
        "dialogue": DimensionType.dialogue,
        "pacing": DimensionType.pacing,
        "emotion": DimensionType.emotional_depth,
        "theme": DimensionType.thematic_strength,
        "other": DimensionType.custom
    }
    update_data['dimension'] = category_to_dimension.get(
        update_data['category'],
        rule.dimension or DimensionType.custom
    )
    # 移除 category 字段
    del update_data['category']

3. 修改前端错误处理（frontend/src/pages/ReviewConfig.tsx）

创建规则错误处理

} catch (error) {
  console.error('Create rule error:', error)
  const errorMsg = (error as any)?.response?.data?.detail ||
                   (error as any)?.message ||
                   '规则创建失败'
  message.error(`规则创建失败: ${errorMsg}`)
}

更新规则错误处理

} catch (error) {
  console.error('Update rule error:', error)
  const errorMsg = (error as any)?.response?.data?.detail ||
                   (error as any)?.message ||
                   '规则更新失败'
  message.error(`规则更新失败: ${errorMsg}`)
}

测试建议

1. 测试创建规则功能

1. 进入审核配置页面
2. 点击"添加规则"
3. 填写规则信息，选择分类（如"角色"）
4. 点击"创建规则"
5. 确认成功创建且无 422 错误

2. 测试更新规则功能

1. 编辑已创建的规则
2. 修改分类或其他信息
3. 点击"更新规则"
4. 确认成功更新且无 422 错误

3. 验证数据映射

• 创建规则后，检查后端数据库中的 dimension 字段是否正确映射
• 更新规则时，确保分类修改能正确反映到 dimension 字段

前后端数据映射关系

前端分类	后端维度	说明
character	DimensionType.character	角色相关
plot	DimensionType.plot	剧情相关
dialogue	DimensionType.dialogue	对话相关
pacing	DimensionType.pacing	节奏相关
emotion	DimensionType.emotional_depth	情感相关
theme	DimensionType.thematic_strength	主题相关
other	DimensionType.custom	其他

修复完成状态

✅ 已修复：

• 后端数据模型支持 category 字段
• 创建规则时的 category 到 dimension 映射
• 更新规则时的 category 到 dimension 映射
• 前端错误处理改进，显示具体错误信息

总结

通过在后端添加对前端 category 字段的支持，并在创建/更新规则时进行到 dimension 的映射，解决了前后端字段名称不匹配导致的 422 错误。这种方案既保持了后端数据模型的规范性，又兼容了前端的实现方式。

建议全面测试审核规则的所有操作，确保没有引入新的问题。