Django REST Framework层级模型数据反规范化位置选择（CSV/Excel导出）

需求背景 #

我们使用Django REST Framework开发一款通讯录应用，需要实现导出所有联系人数据的接口。每个联系人可拥有一个或多个电话号码，原始数据结构如下：

[
  {
    "name": "Jon Doe",
    "phone": 
    [
      {
        "type": "home",
        "number": "+1 234 5678"
      }
    ]
  },
  {
    "name": "Jane Doe",
    "phone":
    [
      {
        "type": "home",
        "number": "+2 345 6789"
      },
      {
        "type": "work",
        "number": "+3 456 7890"
      }
    ]
  }
]

由于要导出为CSV或Excel表格，需对数据进行反规范化处理，让每个电话号码单独占一行，预期导出结果如下：

name,phone.type,phone.number
Jon Doe,home,+1 234 5678
Jane Doe,home,+2 345 6789
Jane Doe,work,+3 456 7890

核心疑问与可选方案 #

当前核心问题是确定在哪个环节执行反规范化操作，现有三个可选方案：

• 方案1：自定义Serializer实现反规范化

  • 优点：一次修改适配所有Renderer，可直接借助djangorestframework-csv和drf-renderer-xlsx完成CSV、Excel导出
  • 缺点：会干扰JSON、XML等无需反规范化的Renderer，破坏这些格式的原有数据层级结构

• 方案2：继承目标Renderer并重写处理逻辑

  • 思路：继承CSVRenderer和XLSXRenderer，重写process_data()方法，先对数据执行反规范化，再调用父类的渲染逻辑
  • 优势：仅针对表格类导出Renderer修改，不影响其他格式输出，职责划分清晰

• 方案3：自定义View根据媒体类型处理数据

  • 思路：在View层根据协商确定的媒体类型（如text/csv、application/vnd.openxmlformats-officedocument.spreadsheetml.sheet）判断是否执行反规范化，再将处理后的数据传递给Serializer和Renderer
  • 优势：Serializer保持纯净，专注原始数据序列化；可精准控制哪些格式需要处理

最佳方案选择 #

优先推荐方案2，原因如下：

1. 符合单一职责原则：Renderer的核心职责是将数据转换为特定格式，反规范化逻辑放在Renderer层，不会污染Serializer或View的核心功能
2. 无副作用：仅影响CSV/Excel导出逻辑，JSON等其他格式输出不受干扰，无需额外判断分支
3. 易于维护扩展：后续新增表格类导出格式（如TSV）时，只需继承对应Renderer并添加相同反规范化逻辑即可

若需要更灵活的控制（如同一View需根据参数切换是否扁平化），方案3也是可行选择，但实现成本稍高，需在View中处理媒体类型判断与数据转换。

方案1不推荐，它会破坏Serializer的通用性，导致非表格格式输出不符合预期，违背DRF中Serializer专注数据序列化的设计初衷。

内容的提问来源于stack exchange，提问作者Mark Asbach