Django Admin 解决 Broken Pipe 报错：外键数据量过大导致请求超时

问题描述

Django 日志中常出现类似 [2019-09-16 16:47:27,981] - Broken pipe from ('127.0.0.1', 58924) 的错误提示。

该错误通常较为宽泛，可能由运算量过大、处理耗时过长等多种因素引起，需结合具体业务场景进行分析。

场景一：Admin 后台编辑页报错

1.1 背景信息

本次问题发生在 Django Admin 界面中。模型类 A 分别关联了模型类 B 和 C，其中 B 表约有 5 万条数据，C 表约有 10 万条数据。

模型类 A 的 Admin 配置代码如下：

@admin.register(A)
class AAdmin(admin.ModelAdmin):
    list_display = (
        'b', 'c',
        'is_valid', 'create_time', 'update_time',
    )

在 Admin 列表中查看数据时页面加载正常，但当点击具体某条数据进入编辑页面时，便会触发上述错误。

1.2 错误排查过程

首先确认该错误是否确实由当前模块引起。

尝试访问其他数据表，页面均正常加载，仅在此特定表中出现错误，且复现率为 100%。

检查模型定义及 Admin 代码逻辑，未发现明显语法或配置错误。

为排除浏览器渲染或网络波动影响，改用命令行工具 paw 直接发起请求。等待约 1 分钟后获取响应，观察返回结果后明确了问题根源。

返回数据中包含大量外键选项，右侧滚动条显示内容极长，这提示外键关联表存在海量数据。

问题根源在于 Django Admin 默认的外键选择控件采用下拉滑动模式。当关联表数据量达十几万条时，系统需生成数十万个 HTML 标签，导致页面渲染和响应时间过长，最终触发 Broken Pipe 错误。

解决方案：改用放大镜样式的输入控件。

@admin.register(A)
class AAdmin(admin.ModelAdmin):
    list_display = (
        'b', 'c',
        'is_valid', 'create_time', 'update_time',
    )
    raw_id_fields = ('b', 'c')

修改配置后，页面可正常访问且加载速度显著提升。

以上为基于实际案例的经验总结，供遇到类似问题的开发者参考。