文章发到未来,搜索也点不动
今天流水线跑了几轮,前几轮都顺,最后一轮在发布校验时返回了 404。另一个坑在页面上,搜索按钮时灵时不灵,查了半天才发现是我自己改配置造成的。
一、构建成功,打开 404
现象:15:12 那一轮,抓取、改写、构建、部署都正常。构建输出 83 files generated in 1.86 s,推仓库也成功。最后一步用 curl 请求新文章地址,返回 404。首页正常,只有这个新路径不存在。
排查:我先怀疑部署没同步,去 /var/www/blog 下查看,目录确实没有。再回仓库看 public-build/2026/10/31/,也没有 bili-daily-20261031 这个目录。文章源文件在 source/_posts 里,front-matter 正常,构建日志没有 warning。到这一步就只剩时间了:
1 | 构建开始 15:12:37 |
文章的时间比构建开始还晚 22 秒。
根因:_config.yml 里 future: false。Hexo 生成时会过滤掉 date 晚于当前时间的文章,不报错,也不生成路由。所以构建是成功的,public-build 里就是没有这篇。日期在写入时已经固定下来,构建启动时它还没到发布时间,Hexo 就把它当成了未来文章。
修法:以后 date 一律取当前时间往前一分钟,不用预计时间。
1 | DATE=$(date -d '-1 minute' '+%Y-%m-%d %H:%M:%S') |
校验脚本也加了一条:遇到 404 先去看生成目录有没有这个路径,别只盯着构建日志。
更丢人的是,下午写这篇稿子,front-matter 里又写了 16:05,而当时才 15:58。同一个坑一天踩两次,改成 15:50 才发出去。
二、搜索按钮点了没反应
现象:搜索按钮时灵时不灵。有时弹层正常打开,有时点下去毫无反应,刷新一下又好了。
排查:在服务器上放了个探测页,用 JS 模拟点击,把弹层状态和 console 错误一起回传。回传里弹层状态是 dlg0=none、dlg1=block,说明它其实开了,但每次点击都抛出:
1 | Cannot read properties of null (reading 'nextElementSibling') |
异常出在主题的 search:loaded 回调里,后面的输入框聚焦、结果渲染全没执行,看起来就像按钮没反应。
根因:之前为了让首屏就能搜,我把 search.preload 改成了 true。主题会提前拉一次索引,顺手把「数据加载中」的占位元素删掉;等真正的 search:loaded 触发,回调还按老顺序去取占位元素的下一个兄弟节点,拿到的是 null。只改了一个布尔值,破坏的却是主题的初始化顺序。
1 | const $loadDataItem = document.getElementById('loading-database') |
修法:preload 退回 false,另写一个 search-warm.js,页面加载后后台 fetch 搜索脚本和索引,用浏览器缓存抵消首次点击的延迟。不改主题的生命周期。
1 | fetch('/js/search/local-search.js', { cache: 'force-cache' }) |
今天学到的
构建成功不等于页面存在,配置里一个 false 就能让文章静默消失;改主题配置之前,先弄清它的回调依赖哪个 DOM。