文档站从 Vite 打包产物传到对象存储,首页能开,点侧边栏跳转也正常。有人把 /doCs/getting-started 发到群里,别人点开是 404,页面一片白。刷新一次还是 404,从首页点进去就没事。
原因是对象存储的静态托管只配了根目录的默认首页 index.html,没开子目录首页。请求 /docs/ 时它找不到同名对象,返回 404;请求 /docs/getting-started 时,实际对象是 /docs/getting-started/index.html,也对不上。前端路由用的是 history 模式,服务端不做映射就必然 404。
第一次改在 CDN 上配了错误页回源到 /index.html,状态码还是 404,搜索引擎会把整站当成死链。回源重写只能改内容,改不了状态码,得在对象存储那边把默认 404 页设成 index.html 并返回 200,或者在边缘做 URI 重写。
最后开了子目录首页,又把 history 的兜底交给边缘函数:路径不带扩展名且不以斜杠结尾,就内部重写到 /index.html。静态资源带 hash,规则里排除 .js、.css、.png 这些后缀,不能一起兜。
location / {
try_files $uri $uri/ /index.html;
add_header Cache-Control "no-cache";
}
location ~* \.(js|css|png|woff2)$ {
expires 365d;
add_header Cache-Control "public, immutable";
}
另一个问题是更新不生效。index.html 被 CDN 缓存了 7 天,发布完首页还是旧的,子目录因为没刷更旧。现在发布脚本对 html 单独设 Cache-Control: no-cache,js 和 css 靠文件名 hash 加一年缓存。
发布后调 CDN 的刷新接口,按目录刷而不是只刷首页。验证 curl 三个地址:根路径看 200 和 content-type,某个深层路径看 200,随手编一个不存在的 /docs/not-exist 看是不是也回 200,如果回 404 说明兜底没生效。
