وبلاگ نت‌آرامآموزش، تجربه و راهکارهای زیرساخت

رفع خطای 416 هنگام ادامه دانلود؛ چرا سرور بقیه فایل را نمی‌فرستد؟

آموزش تشخیص خطای HTTP 416 با مقایسه اندازه فایل و Content-Range، بررسی تغییر نسخه و دریافت سالم فایل از هاست دانلود.

انتشار:
توسط تیم فنی نت‌آرام
۶ دقیقه زمان مطالعه
۰ دیدگاه
محتوای تخصصی، ساده و کاربردی
هماهنگ با هویت حرفه‌ای نت‌آرام
بازگشت به لیست مقالات
تصویر شاخص مقاله رفع خطای 416 هنگام ادامه دانلود؛ چرا سرور بقیه فایل را نمی‌فرستد؟ در وبلاگ نت‌آرام
محتوای آموزشی وبلاگ نت‌آرام
دانلود یک فایل قطع شده و می‌خواهید آن را ادامه دهید، اما برنامه دانلود پیام 416 Range Not Satisfiable نشان می‌دهد. در این وضعیت برنامه بخشی از فایل را از سرور خواسته که سرور نمی‌تواند به همان شکل تحویل دهد. مثلاً برنامه تصور می‌کند تاکنون بایت‌های بیشتری از اندازه فعلی فایل دریافت شده‌اند، یا نسخه فایل روی سرور نسبت به شروع دانلود تغییر کرده است.
خطای ۴۱۶ به‌تنهایی ثابت نمی‌کند هاست خراب یا فایل محلی سالم است. ابتدا اندازه و نسخه را مقایسه می‌کنیم، بعد تصمیم می‌گیریم ادامه دانلود امن است یا باید یک نسخه تازه بگیریم. مثال‌ها برای یک فایل کوچک و عمومی هستند؛ لینک‌های خصوصی و دارای توکن را در گزارش عمومی منتشر نکنید.

۱. فایل ناقص را نگه دارید و اندازه آن را ببینید

دانلود را متوقف کنید و فایل موجود را با نامی تازه یا در پوشه دیگری نگه دارید؛ تا پیش از بررسی، تنها نسخه موجود را حذف یا بازنویسی نکنید. در PowerShell ویندوز، مسیر نمونه را با فایل واقعی عوض کنید:
کد / دستور(Get-Item -LiteralPath 'C:\Downloads\sample.zip').Length
عدد خروجی اندازه فایل محلی بر حسب بایت است. در لینوکس می‌توانید از stat استفاده کنید:
کد / دستورstat -c '%s bytes' sample.zip
برخی برنامه‌های دانلود به‌جای یک فایل نهایی، چند فایل موقت یا قطعه جدا دارند. در آن حالت اندازه یک قطعه لزوماً مجموع داده دریافتی نیست؛ وضعیت و مسیر کامل فایل‌های همان برنامه را از خود آن ببینید. فایل ناشناخته را اجرا نکنید.

۲. پاسخ سرور برای یک فایل کوچک را ببینید

نشانی نمونه را با لینک یک فایل عمومی کوچک که می‌دانید متعلق به شماست جایگزین کنید:
کد / دستورcurl -sS -D - -o /dev/null -H 'Range: bytes=0-0' https://dl.example.com/test.zip
این درخواست بایت اول را می‌خواهد. اگر سرور Range را بپذیرد، معمولاً پاسخ 206 Partial Content و هدر Content-Range می‌بینید. برای نمونه bytes 0-0/1000 یعنی بخش ارسال‌شده بایت صفر و اندازه کل فایل در آن پاسخ ۱۰۰۰ بایت است. اگر پاسخ 200 باشد، ممکن است سرور Range را نادیده گرفته و کل فایل را بفرستد؛ به همین دلیل در این آزمایش فقط از فایل کوچک استفاده کنید. در PowerShell برای فراخوانی برنامه curl ممکن است لازم باشد curl.exe بنویسید.
برای مشاهده یک درخواست عمداً خارج از محدوده، فقط روی همان فایل آزمایشی که از عدد زیر بسیار کوچک‌تر است:
کد / دستورcurl -sS -D - -o /dev/null -H 'Range: bytes=999999999999-' https://dl.example.com/test.zip
سرور پشتیبان Range ممکن است 416 و هدر شبیه Content-Range: bytes */1000 بدهد؛ عدد پس از ستاره اندازه فعلی منبع است. بعضی واسطه‌ها Range را نادیده می‌گیرند یا هدر مورد انتظار را نشان نمی‌دهند، پس خروجی را همان‌طور که واقعاً آمده تفسیر کنید. این آزمایش کوچک را روی فایل چندگیگابایتی یا سرویس شخص دیگری تکرار نکنید.

۳. اندازه محلی و نسخه سمت سرور را کنار هم بگذارید

اگر اندازه داده محلی از اندازه اعلام‌شده فایل فعلی بیشتر است، ادامه از آن نقطه معنی ندارد؛ ممکن است فایل روی سرور کوتاه‌تر یا جایگزین شده باشد. نسخه محلی را نگه دارید و یک فایل تازه با نام متفاوت دریافت کنید. اگر اندازه‌ها برابرند، فایل محلی ممکن است کامل باشد، اما این موضوع بدون بررسی محتوا روشن نیست. در صورت داشتن هش معتبر نسخه فعلی، آن را با هش محلی مقایسه کنید:
کد / دستورGet-FileHash -Algorithm SHA256 -LiteralPath 'C:\Downloads\sample.zip'
هش باید از منبع مورد اعتماد صاحب همان نسخه فایل دریافت شود. برابری اندازه یا نام به‌تنهایی کافی نیست. اگر فایل از چند قطعه موقت تشکیل شده، ابتدا روش تأیید خود برنامه دانلود را دنبال کنید.
اگر اندازه محلی کوچک‌تر است، همچنان باید مطمئن شوید فایل سمت سرور همان نسخه‌ای است که دانلودش را شروع کرده‌اید. سرور ممکن است شناسه‌ای به نام ETag یا زمان آخرین تغییر بدهد، اما همه شناسه‌ها به یک اندازه برای تطبیق دقیق مناسب نیستند. اگر هویت نسخه را نمی‌توانید با اطمینان تأیید کنید، از ترکیب داده قدیمی و فایل تازه پرهیز کنید و دریافت کامل را با نام جدید انجام دهید.

۴. دریافت تازه را بدون رونویسی نسخه قبلی آزمایش کنید

یک نام محلی که هنوز وجود ندارد انتخاب کنید. نمونه زیر فایل عمومی آزمایشی را کامل دریافت می‌کند:
کد / دستورcurl -fL --output fresh-test.zip https://dl.example.com/test.zip
-L انتقال‌ها را دنبال می‌کند و -f بسیاری از پاسخ‌های خطای HTTP را به‌صورت خطا نشان می‌دهد. با این حال یک صفحه ورود با کد ۲۰۰ هنوز ممکن است به‌جای فایل برگردد؛ نوع و هش فایل نهایی را نیز بررسی کنید. از گزینه خروجی روی تنها نسخه قبلی استفاده نکنید، چون ممکن است بازنویسی شود. اگر فایل دریافتی در واقع صفحه HTML است، راهنمای تشخیص صفحه به‌جای ZIP مسیر رفع را توضیح می‌دهد.
اگر نسخه تازه کامل و هش آن با نسخه معتبر یکی است، فایل سالم را جایگزین دانلود ناموفق کنید. اگر سرور پاسخ کامل می‌دهد ولی اتصال در میانه قطع می‌شود، زمان، اندازه دریافتی و کد خطا را ثبت کنید و اتصال، محدودیت ترافیک و رفتار سرویس را جدا بررسی کنید.

۵. صاحب فایل چه چیزی را در هاست بررسی کند؟

اگر شما فایل را منتشر می‌کنید، مطمئن شوید در زمان دانلود یک فایل جدید با همان نام در حال بازنویسی نبوده است. بهتر است نسخه جدید را ابتدا با نام آزمایشی منتقل و پس از پایان و کنترل صحت، با نام نسخه‌دار منتشر کنید. راهنمای جلوگیری از انتشار فایل نیمه‌کاره این مراحل را با جزئیات دارد.
اگر CDN یا پراکسی دارید، ممکن است پاسخ قدیمی و جدید از نقاط متفاوت تحویل شوند. در محیط آزمایشی، اندازه و شناسه نسخه پاسخ را در همان مسیری که کاربر استفاده می‌کند با نسخه اصلی مقایسه کنید. پاک‌سازی محدود کش همان فایل یا استفاده از URL نسخه‌دار می‌تواند از اشتباه‌گرفتن نسخه‌ها جلوگیری کند. برای فایل خصوصی، پاک‌سازی و سیاست کش باید مجوز دسترسی را حفظ کنند.
برای آزمون معمول ادامه دانلود و معنی پاسخ ۲۰۶، راهنمای ادامه دانلود در هاست را ببینید. امکانات سرویس در صفحه هاست دانلود نت‌آرام آمده و معنی کد در مرجع رسمی HTTP موزیلا توضیح داده شده است.
اشتراک‌گذاری:
لینکدینتلگرامایکس
مقاله قبلی
مقاله قبلی وجود ندارد.

دیدگاه‌ها (۰)

دیدگاه‌های تاییدشده و پاسخ‌های تیم نت‌آرام