مفهوم Cache Busting و ضرورت آن

پیش از پرداختن به جزئیات فنی، باید با مفهوم "شکستن کش" (Cache Busting) آشنا شویم. مرورگرهای وب برای بهبود تجربه کاربری و کاهش بار سرور، فایل‌های استاتیک را در حافظه کش خود ذخیره می‌کنند. این بدان معناست که وقتی کاربری برای بار دوم از یک وبسایت بازدید می‌کند، فایل‌های CSS و JavaScript از روی هارد دیسک محلی او بارگذاری می‌شوند و نیازی به دریافت مجدد آن‌ها از سرور نیست. مشکل زمانی رخ می‌دهد که این فایل‌ها روی سرور تغییر می‌کنند. مرورگر از این تغییر بی‌خبر است و به استفاده از نسخه قدیمی کش‌شده ادامه می‌دهد.

راهکار متداول برای غلبه بر این مشکل، تغییر دادن URL فایل استاتیک به محض تغییر محتوای آن است. اگر آدرس فایل عوض شود، مرورگر آن را به عنوان یک منبع جدید در نظر گرفته و نسخه به‌روز را از سرور درخواست می‌کند. این فرآیند، شکستن کش نامیده می‌شود. روش‌های مختلفی برای تغییر URL وجود دارد، مانند اضافه کردن یک پارامتر کوئری بر اساس زمان آخرین تغییر یا یک عدد نسخه‌گذاری شده. ویژگی `asp-append-version` در ASP.NET Core این کار را به صورت خودکار و هوشمندانه انجام می‌دهد.

ویژگی asp-append-version: رویکردی هوشمندانه برای شکستن کش

در ASP.NET Core، Tag Helpers امکان غنی‌سازی تگ‌های HTML با ویژگی‌های سمت سرور را فراهم می‌کنند. ویژگی `asp-append-version` که در Tag Helperهای Image، Link و Script قابل استفاده است، یک مکانیزم داخلی برای مدیریت Cache Busting ارائه می‌دهد .

# نحوه عملکرد

زمانی که این ویژگی را به یک تگ HTML اضافه می‌کنید، ASP.NET Core در زمان رندر کردن صفحه، عملیات زیر را انجام می‌دهد:

• 1.  محاسبه هش (Hash) فایل: موتور رندرینگ مسیر فایل استاتیک (مثلاً یک فایل CSS یا JavaScript) را بررسی کرده و فایل را از روی دیسک می‌خواند. سپس یک مقدار هش منحصر‌به‌فرد از محتوای فایل با الگوریتم SHA512 محاسبه می‌کند .
• 2.  تزریق به URL: این مقدار هش به عنوان یک پارامتر کوئری با کلید `v` به انتهای URL فایل اضافه می‌شود.
• 3.  رندر نهایی: تگ HTML نهایی که به مرورگر ارسال می‌شود، حاوی آدرسی با این پارامتر هش خواهد بود.

برای مثال، در نمای Razor اگر داشته باشیم:

<link rel="stylesheet" href="~/css/site.css" asp-append-version="true" />

خروجی HTML تولید شده به شکل زیر خواهد بود (مقدار هش نمونه است):

<link rel="stylesheet" href="/css/site.css?v=Kl_dqr9NVtnMdsM2MUg4qthUnWZm5T1fCEimBPWDNgM" />

اگر محتوای فایل `site.css` تغییر کند، هش محاسبه شده نیز تغییر خواهد کرد و در نتیجه URL جدیدی با پارامتر `v` متفاوت تولید می‌شود. مرورگر با دیدن این URL جدید، تصور می‌کند که با یک فایل کاملاً جدید روبرو است و نسخه کش‌شده قبلی را نادیده گرفته، فایل به‌روز را از سرور دریافت می‌کند .

بهینه‌سازی عملکرد با کش کردن هش

محاسبه هش SHA512 برای هر بار درخواست یک صفحه، می‌تواند پرهزینه باشد. ASP.NET Core برای جلوگیری از این مشکل، از یک کش در سمت سرور استفاده می‌کند. پس از اولین محاسبه هش یک فایل، نتیجه در حافظه کش ذخیره می‌شود. در درخواست‌های بعدی برای همان فایل، هش از روی کش خوانده می‌شود تا زمانی که فایل تغییر کند. یک "نظاره‌گر فایل" (File Watcher) به فایل متصل می‌شود و به محض تغییر فایل روی دیسک، کش مربوط به آن را باطل کرده و هش جدیدی محاسبه و جایگزین می‌کند . این مکانیزم، تعادلی هوشمندانه بین اطمینان از به‌روزرسانی به‌موقع و حفظ کارایی سرور برقرار می‌کند.

محدودیت‌ها و نکات مهم

اگرچه `asp-append-version` ابزاری قدرتمند است، اما درک محدودیت‌های آن برای استفاده صحیح ضروری است:

- وابستگی به زیرساخت Razor: این ویژگی یک Tag Helper است و بنابراین تنها در فایل‌های `.cshtml` که توسط موتور Razor پردازش می‌شوند، کار می‌کند. اگر در حال توسعه یک اپلیکیشن تک‌صفحه‌ای (SPA) هستید که فایل `index.html` آن کاملاً ایستا (Static) است و توسط Razor پردازش نمی‌شود، نمی‌توانید مستقیماً از این ویژگی استفاده کنید .
- منابع خارجی (External Resources): این ویژگی تنها برای فایل‌های استاتیکی که به صورت فیزیکی بر روی همان سرور وب قرار دارند، کار می‌کند. اگر `src` یک تگ به یک آدرس اینترنتی خارجی (مانند CDN) اشاره کند، پارامتر `v` به آن اضافه نخواهد شد .
- دسترسی به فایل: وب سرور باید به فایل مورد نظر دسترسی خواندن داشته باشد. اگر به هر دلیلی سرور نتواند فایل را بخواند، ویژگی `asp-append-version` نادیده گرفته شده و پارامتر `v` به URL اضافه نمی‌شود .

راهکارهای جایگزین و تکمیلی

بسته به سناریوی پروژه، روش‌های دیگری نیز برای مدیریت کش فایل‌های استاتیک وجود دارد.

۱. تنظیم دستی هدرهای HTTP

می‌توان با استفاده از Middleware فایل‌های استاتیک، هدرهای HTTP مانند `Cache-Control` و `ETag` را به صورت دستی تنظیم کرد. هدر `ETag` عملکردی مشابه `asp-append-version` دارد و مرورگر با استفاده از آن می‌تواند اعتبار سنجی سمت سرور را انجام دهد. اگر `ETag` با نسخه جدید فایل مطابقت نداشته باشد، فایل مجدداً دانلود می‌شود . با این روش می‌توان کنترل دقیق‌تری روی سیاست‌های کش داشت. به عنوان مثال، می‌توان فایل‌ها را برای یک سال در کش مرورگر نگه داشت (max-age=31536000) و هم‌زمان از `ETag` برای به‌روزرسانی آن‌ها استفاده کرد .

app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        // نگهداری فایل در کش مرورگر به مدت یک سال
        ctx.Context.Response.Headers.Append("Cache-Control", "public,max-age=31536000");
        // تنظیم ETag بر اساس زمان راه‌اندازی برنامه (مثال ساده)
        // در عمل بهتر است ETag بر اساس هش محتوای فایل ساخته شود
    }
});

۲. رویکرد مدرن با MapStaticAssets (از دات‌نت ۹ به بعد)

از دات‌نت ۹، روش پیشنهادی مایکروسافت برای سرو کردن فایل‌های استاتیک، استفاده از `MapStaticAssets` به جای `UseStaticFiles` است . این روش یک گام فراتر از `asp-append-version` عمل کرده و به صورت خودکار مجموعه‌ای از بهینه‌سازی‌ها را اعمال می‌کند:
- Fingerprint در زمان ساخت (Build-time Fingerprinting): یک هش SHA256 از محتوای فایل‌ها گرفته و به نام فایل یا مسیر آن اضافه می‌کند (مانند `site.g3w4h5h4.css`). این قوی‌ترین نوع کش‌شکنی است.

• - ایجاد ETagهای مبتنی بر محتوا: حتی اگر از fingerprint استفاده نشود، `ETag`های هوشمندانه‌ای برای اعتبارسنجی ساخته می‌شود.
• - فشرده‌سازی در زمان ساخت: فایل‌ها از پیش با فرمت‌هایی مانند Gzip و Brotli فشرده می‌شوند تا حجم آن‌ها به شدت کاهش یابد (گاهی تا بیش از ۹۰ درصد) .
• - دستور `immutable`: برای فایل‌های fingerprint شده، هدر `Cache-Control` با دستور `immutable` ارسال می‌شود که به مرورگر می‌گوید این فایل هرگز تغییر نمی‌کند و نیازی به درخواست مجدد آن نیست .

استفاده از `MapStaticAssets` بسیار ساده است و تنها کافیست در فایل `Program.cs`، متد `app.UseStaticFiles()` را با `app.MapStaticAssets()` جایگزین کنید .

۳. راهکار دستی برای SPAها

در اپلیکیشن‌های SPA که از یک فایل `index.html` ایستا استفاده می‌کنند، می‌توان از یک متغیر سراسری برای نسخه‌بندی استفاده کرد. برای مثال، در فایل جاوااسکریپت اصلی، یک ثابت به نام `appVersion` تعریف کرده و آن را به انتهای آدرس فایل‌های استاتیک دیگر اضافه کنید. با هر بار تغییر فایل‌ها، مقدار این ثابت را افزایش دهید تا همه URLها تغییر کرده و مرورگر مجبور به دریافت نسخه جدید شود . هرچند این روش ساده‌تر است، اما کنترل دقیقی بر روی تک‌تک فایل‌ها ندارد و تغییر یک فایل، باعث بی‌اعتبار شدن کش همه آن‌ها می‌شود.

نتیجه‌گیری

مدیریت کش فایل‌های استاتیک یکی از جنبه‌های حیاتی توسعه وب مدرن است که تأثیر مستقیمی بر تجربه کاربری و عملکرد وب‌سایت دارد. ویژگی `asp-append-version` در ASP.NET Core راهکاری ساده، کارآمد و یکپارچه برای پیاده‌سازی Cache Busting در اپلیکیشن‌های مبتنی بر Razor ارائه می‌دهد. این ویژگی با محاسبه هش محتوای فایل و اضافه کردن آن به URL، تضمین می‌کند که مرورگر همواره آخرین نسخه فایل‌های استاتیک را نمایش دهد، بدون آنکه پیچیدگی خاصی به پروژه تحمیل کند. با ظهور `.NET 9` و متد `MapStaticAssets`، سطح بهینه‌سازی و مدیریت دارایی‌های استاتیک به مرحله جدیدی وارد شده و توسعه‌دهندگان را قادر می‌سازد تا با کمترین زحمت، بالاترین سطح کارایی را برای برنامه‌های خود به ارمغان آورند. انتخاب بین استفاده از `asp-append-version`، تنظیم دستی هدرها یا بهره‌گیری از `MapStaticAssets` به نیازها و معماری پروژه بستگی دارد، اما درک صحیح این ابزارها و مکانیزم‌ها، گامی مهم در مسیر خلق برنامه‌های وب سریع و مقیاس‌پذیر است.