检索页:正文分片取失败时自动重试并保留已读部分,报错不再甩锅文件不在

手机信号差时读到一半报 Failed to fetch,整页三十多个分片全白读一遍,而且
提示是「确认 README.md 和 book/ 目录都在 index.html 旁边」——文件在不在和
这种失败没关系,照着查只会白查。

- readText 自己退避重试三次(0.5s、2s),只对网络类失败重试:fetch 的
  TypeError、超时中断,以及 5xx 和 429;4xx 不重试(文件真不在)
- 每个请求加 20s 超时,信号差时挂住不返回的请求能变成一次重试
- 取到的正文存进 CORPUS_CACHE,重试只补没取到的那几个,已读的不重下
- 彻底失败时提示改成「网络中断,正文只读了一部分(取不到 book/13-…)」并给
  一个「接着读」按钮;文件真缺(4xx)仍是原来那句查文件的提示
- 无头实测三种情形:掉两次自愈(552 张卡照常出)、一直失败时提示与按钮正确、
  点「接着读」只重新请求 1 个文件并读完全书
This commit is contained in:
albert4719
2026-09-20 21:03:53 +08:00
parent 07574d75d4
commit 8f6f9de497
+48 -7
View File
@@ -227,6 +227,8 @@ abbr.term:hover{border-bottom-color:var(--brand-1);color:var(--brand-1)}
.status code{font-family:var(--mono);font-size:13px;background:var(--bg-mute);padding:2px 6px;border-radius:4px}
.status .bar{max-width:260px;height:3px;margin:14px auto 0;border-radius:2px;background:var(--bg-mute);overflow:hidden}
.status .bar i{display:block;height:100%;width:0;border-radius:2px;background:var(--brand-1);transition:width .18s ease-out}
.status button{margin-top:14px;border:1px solid var(--divider);background:var(--bg-soft);color:var(--t1);border-radius:6px;padding:6px 16px;font:inherit;cursor:pointer}
.status button:hover{border-color:var(--brand-1);color:var(--brand-1)}
.foot{margin-top:64px;padding-top:24px;border-top:1px solid var(--divider);color:var(--t3);font-size:13px;line-height:1.7}
@media (max-width:960px){
@@ -1026,10 +1028,38 @@ function wire(){
}
/* ---------- 启动 ---------- */
async function readText(path){
const res = await fetch(path, {cache:'no-cache'});
if (!res.ok) throw new Error('http '+res.status+':'+path);
return res.text();
// 一次要取 README 加三十多个正文文件,手机信号差时中间掉一个,整页就全军覆没
// (2026-09-20 用户在手机上读到一半撞到 Failed to fetch)。所以:取到的存下来,
// 重试时不重下;网络类的失败自己先退避重试几次;再不行也只报「网络中断」并给
// 一个接着读的按钮,别再让读者去查文件在不在——文件在不在和这种失败没关系。
const CORPUS_CACHE = new Map();
async function readText(path, tries = 3){
if (CORPUS_CACHE.has(path)) return CORPUS_CACHE.get(path);
for (let i = 1; ; i++){
let retry = false;
try {
// 信号差时请求可能挂着不返回,给它一个上限,超时按可重试处理
const signal = AbortSignal.timeout ? AbortSignal.timeout(20000) : undefined;
const res = await fetch(path, {cache:'no-cache', signal});
if (!res.ok){
// 4xx 重试没意义(文件真不在),5xx 和 429 是服务端一时的事,值得再来一次
retry = res.status >= 500 || res.status === 429;
throw new Error('http '+res.status+':'+path);
}
const text = await res.text();
CORPUS_CACHE.set(path, text);
return text;
} catch (err) {
// fetch 的网络失败是 TypeError,超时和中断是 DOMException
const net = retry || err instanceof TypeError || /^(TimeoutError|AbortError)$/.test(err.name);
if (!net) throw err;
if (i >= tries){
const e = new Error(`取不到 ${path}(网络中断或超时)`);
e.net = true; throw e;
}
await new Promise(r => setTimeout(r, 500 * i * i)); // 0.5s、2s 后再试
}
}
}
(async function init(){
@@ -1084,9 +1114,20 @@ async function readText(path){
if (land) requestAnimationFrame(() => land.scrollIntoView());
}
} catch (err) {
status.innerHTML = err.message === 'file'
? '这个页面要通过 http 打开才能读取正文。在仓库目录运行 <code>python -m http.server</code>,然后访问 <code>http://localhost:8000/</code>;或直接用 GitHub Pages 地址。'
: `读取正文失败(${esc(String(err.message))})。确认 README.md 和 book/ 目录都在 index.html 旁边。`;
if (err.message === 'file'){
status.innerHTML = '这个页面要通过 http 打开才能读取正文。在仓库目录运行 <code>python -m http.server</code>,然后访问 <code>http://localhost:8000/</code>;或直接用 GitHub Pages 地址。';
return;
}
if (err.net){
status.innerHTML = `网络中断,正文只读了一部分(${esc(String(err.message))})。已经读到的不用重下,换个网络或等信号稳一点,点这里接着读。`
+ '<div><button type="button" id="retry">接着读</button></div>';
document.getElementById('retry').addEventListener('click', () => {
status.innerHTML = '<span id="status-t">正在读取正文 …</span><div class="bar"><i id="status-b"></i></div>';
init();
});
return;
}
status.innerHTML = `读取正文失败(${esc(String(err.message))})。确认 README.md 和 book/ 目录都在 index.html 旁边。`;
}
})();
</script>