
در این مقاله
خطای 413 یعنی یکی از لایههای مسیر، بدنه درخواست را بزرگتر از حد مجاز تشخیص داده است. این لایه ممکن است CDN، پراکسی، وبسرور، مسیر API یا سازوکار دریافت فایل در برنامه باشد. افزایش یک عدد در تنظیمات Next.js وقتی درخواست اصلاً به برنامه نمیرسد، مشکلی را حل نمیکند. برای فایل بزرگ، معمولاً باید علاوه بر پیدا کردن محدودیت، معماری آپلود را هم بررسی کرد.
این آموزش برای برنامهای است که کاربر در آن تصویر، PDF یا فایل داده ارسال میکند. ابتدا لایه خطا را پیدا میکنیم، سپس مسیر آپلود مستقیم به ذخیرهسازی را طراحی میکنیم. هیچ سقف ثابتی برای همه سرویسهای پاستا فرض نمیکنیم؛ محدودیت واقعی باید برای دامنه، CDN، طرح و مسیر برنامه خودتان تأیید شود.
خطای 413 از کدام لایه میآید؟
در ابزار Network مرورگر، درخواست شکستخورده، کد پاسخ، زمان و پاسخ قابل مشاهده را بررسی کنید. همزمان، لاگ برنامه را با شناسهای بینام و زمان همان درخواست تطبیق دهید. اگر هیچ اثری از رسیدن درخواست نیست، لایههای پیش از برنامه را بررسی کنید؛ نبود لاگ بهتنهایی دلیل قطعی نیست، چون ثبت لاگ ممکن است ناقص باشد.
فایل ساختگی با چند اندازه متفاوت بسازید و در محیط آزمایشی بفرستید. هدف، پیدا کردن مرز شکست است، نه ارسال مکرر فایل شخصی یا مصرف نامحدود پهنای باند. دامنه آزمایش باید مجاز باشد و هر آزمایش، نتیجه قابل پیگیری داشته باشد.
| نشانه | احتمال قابل بررسی | بررسی بعدی |
|---|---|---|
| برنامه هیچ درخواست متناظری ندارد | رد درخواست پیش از برنامه | لاگ CDN و پراکسی با زمان مشترک |
| فایل کوچک موفق و بزرگ ناموفق است | سقف اندازه در یک لایه | مرز اندازه و سربار multipart |
| پاسخ ۴۰۰ از برنامه میآید | اعتبارسنجی یا parsing | قرارداد مسیر و شکل ورودی |
| زمان زیادی میگذرد و ارتباط قطع میشود | مهلت یا قطع شبکه | تفکیک timeout از محدودیت اندازه |
Body، فایل و multipart یک اندازه نیستند
اندازه بدنه درخواست شامل همه دادههای ارسالشده است. یک فرم دارای فایل، نام فیلدها و مرزهای multipart هم دارد. اگر چند فایل در یک درخواست بفرستید، مجموع آنها مهم است. تبدیل باینری به Base64 نیز اندازه را افزایش میدهد؛ فرستادن فایل داخل JSON ممکن است قبل از هر پردازش، مصرف شبکه و حافظه را بالا ببرد.
تعداد فایل، حداکثر اندازه هر فایل و حداکثر کل درخواست را جداگانه تعریف کنید. اعتبارسنجی مرورگر برای تجربه کاربر مفید است، اما قابل دورزدن است. سرور یا سرویس مقصد باید محدودیت واقعی را اعمال کند و پیام خطا نباید مقدارها و مسیرهای داخلی را افشا کند.
تفاوت Route Handler، Server Action و پراکسی
این سه مسیر قرارداد یکسانی ندارند. تنظیم محدودیت یک Server Action را نباید به همه Route Handlerها تعمیم داد. همچنین گزینهای که در نسخه قدیمی Next.js معتبر بوده، ممکن است در نسخه فعلی محل یا رفتار دیگری داشته باشد. پیش از تغییر، نسخه نصبشده و مستندات همان نسخه را بررسی کنید.
برای دریافت فرم، روش parsing را با نوع مسیر تطبیق دهید. فراخوانی یک روش راحت برای خواندن تمام فایل در حافظه میتواند برای فایل کوچک مناسب و برای بار همزمان خطرناک باشد. افزایش سقف درخواست بدون محاسبه حافظه هر پردازش، فقط نوع شکست را از 413 به اتمام حافظه تغییر میدهد.
چه زمانی افزایش محدودیت منطقی است؟
اگر فایل کوچک و محدود است، سقف فعلی اشتباه تنظیم شده و منابع کافی دارید، اصلاح محدودیت میتواند راهحل مناسب باشد. همه لایهها باید با هدف یکسان تنظیم شوند. تغییر را ابتدا در محیط تست انجام دهید و اندازههای نزدیک مرز را دوباره بسنجید.
سقف را بیدلیل نامحدود نکنید. تعداد درخواست همزمان، مهلت دریافت، فضای موقت و محدودیت کاربر باید مشخص باشد. یک فایل مجاز در یک درخواست، به معنی مجازبودن صد درخواست همزمان از همان حساب نیست. خطای درست و زودهنگام معمولاً بهتر از پذیرش درخواست و شکست دیرهنگام است.







نظرات کاربران (۰)
هنوز نظری ثبت نشده است. اولین نفر باشید.