‫شناسایی تغییرات فایل‌ها و مدیریت کش در Blazor WebAssembly

Failed to find a valid digest in the 'integrity' attribute for resource
'https://myapp.example.com/_framework/MyBlazorApp.dll' with computed 
SHA-256 integrity 'IIa70iwvmEg5WiDV17OpQ5eCztNYqL186J56852RpJY='. 
The resource has been blocked.

{
  "cacheBootResources": true,
  "config": [ "appsettings.json" ],
  "entryAssembly": "MyApp",
  "resources": {
    "assembly": {
      "MyApp.dll": "sha256-abc123...",
      "System.Text.Json.dll": "sha256-xyz789..."
    },
    "runtime": {
      "dotnet.wasm": "sha256-def456..."
    },
    "js": {
      "blazor.webassembly.js": "sha256-ghi789..."
    }
  }
}

• cacheBootResources: مشخص می‌کند که آیا منابع در مرورگر کش شوند یا خیر.
• config: فایل‌های تنظیمات برنامه مانند appsettings.json را فهرست می‌کند.
• entryAssembly: نام مجموعه اصلی برنامه را مشخص می‌کند.
• resources: فهرستی از منابع موردنیاز، همراه با هش‌های SHA-256 برای اعتبارسنجی یکپارچگی فایل‌ها.

<script type="module">
  import { BrotliDecode } from './decode.min.js';
  Blazor.start({
    webAssembly: {
      loadBootResource: function (type, name, defaultUri, integrity) {
        if (type !== 'dotnetjs' && location.hostname !== 'localhost' && type !== 'configuration' && type !== 'manifest') {
          return (async function () {
            const response = await fetch(defaultUri + '.br', { cache: 'no-cache' });
            if (!response.ok) {
              throw new Error(response.statusText);
            }
            const originalResponseBuffer = await response.arrayBuffer();
            const originalResponseArray = new Int8Array(originalResponseBuffer);
            const decompressedResponseArray = BrotliDecode(originalResponseArray);
            const contentType = type === 'dotnetwasm' ? 'application/wasm' : 'application/octet-stream';
            return new Response(decompressedResponseArray, {
              headers: { 'content-type': contentType }
            });
          })();
        }
      }
    }
  });
</script>

• تغییر فایل‌ها پس از انتشار: اگر فایل‌های منتشرشده (مانند .dll یا .wasm) پس از فرآیند انتشار تغییر کنند، هش‌های آن‌ها با مقادیر موجود در blazor.boot.json مطابقت نخواهد داشت.
• مشکلات استقرار: استقرار نادرست یا تغییرات محیطی در سرور ممکن است باعث شود فایل‌های نادرست به مرورگر ارسال شوند.
• لایه‌های کش میانی: شبکه‌های تحویل محتوا (CDN) یا پراکسی‌ها ممکن است نسخه‌های قدیمی فایل‌ها را ارائه دهند.

<PropertyGroup>
  <BlazorCacheBootResources>false</BlazorCacheBootResources>
</PropertyGroup>

• استفاده از Webcil: از .NET 8 به بعد، Blazor WASM از فرمت Webcil برای بسته‌بندی فایل‌های .NET به‌صورت .wasm استفاده می‌کند. این فرمت به بهبود عملکرد و کاهش اندازه فایل‌ها کمک می‌کند. برای غیرفعال کردن Webcil، می‌توان از تنظیم زیر استفاده کرد:

<PropertyGroup>
  <WasmEnableWebcil>false</WasmEnableWebcil>
</PropertyGroup>

• تغییر پسوند فایل‌ها: در برخی موارد، تغییر پسوند فایل‌های .dll به .bin با استفاده از اسکریپت‌های PowerShell یا خطوط لوله DevOps می‌تواند مشکلات مربوط به محدودیت‌های سرور را حل کند.
• پیکربندی سرور و CDN: اطمینان از تنظیم صحیح هدرهای کش مانند Cache-Control و ETag برای جلوگیری از ارائه نسخه‌های قدیمی فایل‌ها توسط سرور یا CDN.

• بارگذاری تنبل (Lazy Loading): Blazor WASM امکان بارگذاری تنبل مجموعه‌ها (Assemblies) را فراهم می‌کند تا فقط مجموعه‌های مورد نیاز در زمان درخواست بارگذاری شوند. این روش می‌تواند زمان بارگذاری اولیه را کاهش دهد.
• استفاده از سرورهای استاتیک: در استقرار مستقل (Standalone Deployment)، فایل‌های Blazor WASM می‌توانند روی سرورهای استاتیک مانند Nginx یا Apache میزبانی شوند، که نیاز به سرور .NET را حذف می‌کند.
• بررسی ابزارهای توسعه مرورگر: برای عیب‌یابی، استفاده از تب Network در ابزارهای توسعه مرورگر برای بررسی کدهای وضعیت HTTP (مانند 200، 403 یا 500) ضروری است.