fix(web): self-heal SPA chunk 404 after deploys
Frontend CI / Frontend (push) Has been cancelled

Port admin-web's chunk-reload guard to ops-web (vite:preloadError +
router.onError) so a stale tab landing on a lazy-loaded route triggers
a single reload instead of a hard 404. Also force index.html through
revalidation on both apps so the reload actually fetches a fresh entry
referencing the new chunk hashes; hashed asset URLs keep their long
immutable cache.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-14 13:12:42 +08:00
parent b939cfa2fa
commit 09e3db5b34
5 changed files with 78 additions and 0 deletions
+54
View File
@@ -0,0 +1,54 @@
const RELOAD_FLAG_KEY = '__chunk_reload_at'
const RELOAD_COOLDOWN_MS = 10_000
function shouldReload(): boolean {
try {
const raw = sessionStorage.getItem(RELOAD_FLAG_KEY)
if (!raw) return true
const at = Number(raw)
if (!Number.isFinite(at)) return true
return Date.now() - at > RELOAD_COOLDOWN_MS
} catch {
return true
}
}
function markReload(): void {
try {
sessionStorage.setItem(RELOAD_FLAG_KEY, String(Date.now()))
} catch {
// ignore storage failures (private mode, quota)
}
}
export function reloadForStaleChunk(): boolean {
if (!shouldReload()) return false
markReload()
location.reload()
return true
}
const CHUNK_ERROR_PATTERNS = [
/Failed to fetch dynamically imported module/i,
/error loading dynamically imported module/i,
/Importing a module script failed/i,
/Unable to preload CSS/i,
]
export function isChunkLoadError(err: unknown): boolean {
const msg =
err instanceof Error
? err.message
: typeof err === 'string'
? err
: ''
return CHUNK_ERROR_PATTERNS.some((re) => re.test(msg))
}
export function registerChunkReloadHandlers(): void {
window.addEventListener('vite:preloadError', (event) => {
if (reloadForStaleChunk()) {
event.preventDefault()
}
})
}