An application page is a chain of resources. A server can return valid HTML with status 200 while the interface never appears because a module failed to load or initialize. Start by asking what the browser needed to execute.
Capture the first boot error
Open the page with Console and Network. The first loading or execution error is often more useful than later failures caused by the missing module. Record the resource URL, status, response type and short error message.
Preserve evidence before clearing everything; otherwise you can lose the distinction between stale cache and a server response problem. Establish reproducibility, then perform a controlled comparison.
Read the exact resource URL from the HTML
Verify that the script references a published asset version. Probing a similarly named app.js does not test a differently named bundle. The HTML and release directory must form a consistent pair.
Inspect the GET response body: an application fallback can return the main HTML page with status 200 for a missing file. HEAD alone or a file size cannot establish that the intended JavaScript was delivered.
curl -sS --max-time 5 http://localhost/
curl -sS -i --max-time 5 http://localhost/assets/bundle.8a1.jsHTTP/1.1 200 OK
Content-Type: text/html
<!doctype html>...Connect MIME type with the loading mode
A JavaScript module must pass the response-type check. A file’s presence on disk does not repair HTML delivered as a module or an unsuitable MIME type. Inspect nginx location, alias/root and type mapping.
Console evidence should agree with the Network response. If the type and body are correct, investigate runtime failures and dependent application requests rather than continuing to change MIME settings.
sudo nginx -T
curl -sS -D - -o /dev/null --max-time 5 http://localhost/assets/bundle.8a1.jsCheck cache and release consistency
A cache can retain HTML that references an old bundle removed from the server. Content-hashed names distinguish versions but require coordinated publication and retention of older assets. Clearing one person’s browser does not repair everyone else’s release.
no-cache requires validation before reuse, whereas no-store prohibits storage. A valid 304 does not mean an empty resource: the browser uses its stored representation. Compare a normal load with a fresh session, then inspect the actual user interface.
From symptom to check
| Observation | Next check | How to interpret it |
|---|---|---|
| HTML 200, empty interface | Console and entry-module request | Test application boot rather than document reachability. |
| Asset 200 containing HTML | Exact URL, location and fallback | A success status does not turn the body into JavaScript. |
| Fresh session works, old session fails | HTML/asset versions and cache headers | Check the release contract for existing clients. |
Common mistakes
- Closing the incident after curling the document.
- Treating clearing your own cache as the full repair.
- Disabling type checks instead of repairing the server response.
How to prove recovery
- The HTML references a reachable asset of the intended version.
- Body and Content-Type match the module; no new boot errors appear.
- The visible interface and a normal reload were tested.
MINI INCIDENT
Why did changing the filename not complete the repair?
The module now exists, but Console reports text/plain. What should you compare before editing again?
script type=module src=/assets/bundle.8a1.js
GET /assets/bundle.8a1.js → 200, Content-Type: text/plainExplore the diagnosis
Compare the actual GET response with the effective location serving that path. A wrong version and wrong response type can coexist. After fixing the type, still verify application boot and a repeat load.
WORKSHOP
Workshop: explain the evidence and choose an action
An existing client and a new client received different HTML versions.
old HTML → bundle.a1.js → 404
new HTML → bundle.b2.js → 200
old HTML Cache-Control: max-age=3600Why does the new client’s success not prove recovery for everyone?
Compare your reasoning
Existing clients can still use cached old HTML. The release contract must account for those asset references too.
What should be compared in the release policy?
Compare your reasoning
Compare document freshness, asset names and retention of previous versions. Changing Cache-Control alone cannot restore an already removed bundle.
Which verification reflects user experience?
Compare your reasoning
Test a normal reload in an existing session and a fresh-session load. Both must boot without an entry-module failure.
CHECK YOUR UNDERSTANDING
Why is no-cache different from no-store?
Show explanation
The first permits storage but requires validation before reuse. The second prohibits storing the response. Choose the policy for the resource’s purpose rather than as a universal blank-page fix.
No comments yet. Share your first impression or ask a question about this topic.