各位佬友，最近在折腾一个 MkDocs 的静态文档站，托管在 Cloudflare Pages 上。MkDocs Material 主题有一个非常好用的特性叫 navigation.instant，开启后网站就变成了单页应用（SPA），切网页完全无刷新，全局的背景音乐播放器也不会断。 
这个特性其实我 2026 年 2 月 27 日已经成功使用上了。当时是一切正常的。 
然而今天 2026 年 3 月 8 日凌晨 3 点打开我的网站一看，点击链接切页面立马变成传统的整页硬刷新，网站的音乐进度直接归零。 
难道是我这几天不小心把网站源码改坏了？mkdocs serve！——结果是，我在本地跑得好好的，丝滑无比。但是一推到 Cloudflare Pages 线上，又寄了 
离谱的排查过程（这些都没用，踩坑试错的方法！） 
一开始以为是我自己写的特效 JS 在 SPA 切页瞬间报错，导致路由挂了...