Django Admin StackedInline保存机制及报错问题咨询

好问题！我来帮你拆解这两个核心疑问：

一、StackedInline的保存行为 #

当你在Django Admin中使用StackedInline，点击「保存」或「保存并添加另一个」时，系统会一次性提交并保存当前页面上所有的Inline对象（包括已存在的商品和你刚添加的新商品），而不是只保存当前正在编辑的那一个。这是Admin Inline的核心机制——它把主模型（店铺）和所有关联的Inline模型（商品）的表单数据打包成一个HTTP请求提交给后端。

二、报错原因解析 #

1. "Entity too large" 错误（文件大小合规仍触发） #

这个错误和单个文件的大小无关，而是整个HTTP请求的总大小超过了Web服务器（比如Nginx、Apache）的最大请求体限制：

• 当你添加多个商品Inline，每个商品都包含文件上传字段时，所有文件的字节数据加上表单的文本字段数据会累加起来，总大小可能超出服务器默认的请求体上限（比如Nginx默认是1MB）。
• 哪怕单个文件完全符合Django的FILE_UPLOAD_MAX_MEMORY_SIZE或自定义的上传大小限制，总请求体超了还是会被服务器拦截，返回这个错误。

2. "DATA_UPLOAD_MAX_NUMBER_FIELDS" 错误 #

Django有个默认设置DATA_UPLOAD_MAX_NUMBER_FIELDS（默认值是1000），用来限制单个POST请求中允许的表单字段总数：

• 每个StackedInline实例都会生成一组独立的表单字段，当你添加的商品Inline数量过多时，主模型字段 + 所有Inline的字段总数会快速突破1000的阈值。比如每个商品有8个字段，添加120个商品就有960个字段，再加上店铺的10个字段，轻松超过默认值触发错误。

三、实用解决建议 #

• 针对"Entity too large":
  • 调整Web服务器的最大请求体限制：比如Nginx中修改client_max_body_size为合适的值（如10M）；Apache中设置LimitRequestBody 10485760（对应10MB）。
  • 确保Django的FILE_UPLOAD_MAX_MEMORY_SIZE设置合理，但这个是控制单个文件在内存中处理的阈值，和总请求体大小无关。
• 针对"DATA_UPLOAD_MAX_NUMBER_FIELDS":
  • 在项目的settings.py中增大这个值，比如：

    DATA_UPLOAD_MAX_NUMBER_FIELDS = 2000  # 根据你的实际需求调整
    

  • 注意：不要设置过大，避免潜在的DoS攻击风险。
• 优化使用体验:
  • 考虑用TabularInline代替StackedInline，它的表单更紧凑，相同页面下能容纳更多商品，同时减少页面渲染的冗余代码。
  • 在Inline类中设置max_num属性，从源头限制用户最多能添加的商品数量：

    class ProductInline(admin.StackedInline):
        model = Product
        max_num = 20  # 限制最多添加20个商品
    

内容的提问来源于stack exchange，提问作者Omkar Masur