ماذا يعني
جسم الطلب أكبر مما يرغب الخادم في معالجته أو يقدر عليه. كان يُسمى سابقًا Payload Too Large.
الأسباب الشائعة
- الرفع يتجاوز client_max_body_size في nginx (الافتراضي 1 MB)
- قيمة upload_max_filesize أو post_max_size في PHP صغيرة جدًا
- حدود الجسم في بوابة API أو بيئة serverless
طريقة الإصلاح
إن كنت العميل أو الزائر
اضغط الملف المرفوع أو قسّمه، أو استخدم واجهة الرفع القابل للاستئناف أو متعدد الأجزاء لدى الخدمة.
إن كنت مسؤولًا عن الموقع أو الواجهة البرمجية
ارفع الحدود في كل طبقة: الوكيل (client_max_body_size)، وإطار التطبيق، والبوابة. واذكر الحد في رسالة الخطأ.
مثال على الاستجابة
HTTP/1.1
HTTP/1.1 413 Content Too Large
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Connection: close
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Content Too Large",
"status": 413,
"detail": "Uploads are limited to 10 MB."
} المواصفة
الأسئلة الشائعة
› كيف أصلح 413 في nginx؟
زد client_max_body_size في كتلة http أو server أو location، مثل client_max_body_size 50m; ثم أعد تحميل nginx.
› لماذا ما زلت أحصل على 413 بعد رفع حد التطبيق؟
طبقة أخرى، مثل الوكيل العكسي أو CDN أو موازن التحميل، لها حد خاص أدنى.