今天流水线跑了几轮,前几轮都顺,最后一轮在发布校验时返回了 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
2
构建开始   15:12:37
文章 date 2026-10-31 15:12:59

文章的时间比构建开始还晚 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
2
const $loadDataItem = document.getElementById('loading-database')
$loadDataItem.nextElementSibling.style.visibility = 'visible'

修法:preload 退回 false,另写一个 search-warm.js,页面加载后后台 fetch 搜索脚本和索引,用浏览器缓存抵消首次点击的延迟。不改主题的生命周期。

1
2
fetch('/js/search/local-search.js', { cache: 'force-cache' })
fetch('/search.xml', { cache: 'force-cache' })

今天学到的

构建成功不等于页面存在,配置里一个 false 就能让文章静默消失;改主题配置之前,先弄清它的回调依赖哪个 DOM。