Header Cache-Control HTTP Dijelaskan di Situs Next.js Nyata

      // Production only. Build chunks are content-hashed there, so a year of
      // immutable caching is safe. Turbopack's dev chunks keep the same name
      // across edits, and this header in development made browsers keep
      // running stale game code for as long as their cache lived — the
      // "sometimes WASD stops working" reports were a mix of old and new
      // modules, not the controller.
      ...(process.env.NODE_ENV === "production"
        ? [
            {
              source: "/_next/static/(.*)",
              headers: [
                {
                  key: "Cache-Control",
                  value: "public, max-age=31536000, immutable",
                }, // Cache static assets for 1 year
              ],
            },
          ]
        : []),

Aturan satu tahun untuk chunk hasil build, di balik pengecekan production. Komentarnya adalah pelajarannya: header ini aman hanya karena chunk production ber-hash konten, dan header yang sama saat development pernah membuat browser menjalankan kode game yang basi. Aturan serupa untuk gambar, di baris 157-177, tidak punya syarat itu karena URL-nya disajikan apa adanya.

      {
        // The films, their posters and captions. A re-render keeps the file
        // names, so only a request carrying the render stamp
        // (lib/film-manifest.ts prints `?v=` on every URL) may be cached as
        // immutable; Cloudflare then serves the films from its edge. A bare
        // URL, from an old link, keeps revalidating against the origin.
        source: "/videos/:path*",
        has: [{ type: "query", key: "v" }],
        headers: [
          {
            key: "Cache-Control",
            value: "public, max-age=31536000, immutable",
          },
        ],
      },

Nama yang tidak berubah, ditangani dengan syarat. has hanya cocok untuk request yang membawa query parameter v, jadi film hasil render ulang bersifat immutable di bawah URL bercap, sedangkan URL polos dari tautan lama tetap divalidasi ulang. Komentarnya menyebut Cloudflare lalu melayani film ini dari edge-nya.

      {
        // The Archipelago's models, textures and decoders (prd.md §7). Files
        // are content-hashed by scripts/game/build-manifest.mjs, so they can
        // be immutable; Cloudflare then serves every repeat from the edge and
        // the 1 vCPU origin never streams a model twice. The manifest itself
        // is excluded: it is the one file whose name never changes.
        source: "/game/:path((?!manifest\\.json$).*)",
        headers: [
          {
            key: "Cache-Control",
            value: "public, max-age=31536000, immutable",
          },
        ],
      },

Gagasan yang sama lewat pengecualian. Negative lookahead pada pola path mencocokkan semua yang ada di bawah /game/ kecuali manifest.json. Semua file lain ber-hash konten, jadi boleh immutable; manifest adalah satu-satunya file yang namanya tidak pernah berubah, jadi aturan ini tidak memberinya janji setahun.