GitHub Pages基于Jekyll构建持续失败求助

我维护的基于Jekyll的GitHub Pages最近出问题了：不管是上传、删除文件，还是微调文本内容，每次构建都失败。构建流程的具体状态如下：

• 页面构建与部署 / 构建（动态）：24秒后失败
• 页面构建与部署 / 报告构建状态（动态）：2秒后成功
• 页面构建与部署 / 部署（动态）：已跳过

「Build with Jekyll」的错误日志如下：

Error: Logging at level: debug
Configuration file: /github/workspace/./_config.yml
GitHub Pages: github-pages v229
GitHub Pages: jekyll v3.9.4
Theme: jekyll-theme-primer
Theme source: /usr/local/bundle/gems/jekyll-theme-primer-0.6.0
Requiring: jekyll-github-metadata
Requiring: jekyll-seo-tag
Requiring: jekyll-paginate
Requiring: jekyll-sitemap
Requiring: jekyll-gist
Requiring: jekyll-feed
Requiring: jekyll-redirect-from
Requiring: jekyll-coffeescript
Requiring: jekyll-commonmark-ghpages
Requiring: jekyll-github-metadata
Requiring: jekyll-relative-links
Requiring: jekyll-optional-front-matter
Requiring: jekyll-readme-index
Requiring: jekyll-default-layout
Requiring: jekyll-titles-from-headings
GitHub Metadata: Initializing...
Source: /github/workspace/.
Destination: /github/workspace/./_site
Incremental build: disabled. Enable with --incremental
Generating...
EntryFilter: excluded /package.json
EntryFilter: excluded /CHANGELOG.md
EntryFilter: excluded /LICENSE
EntryFilter: excluded /Gemfile
EntryFilter: excluded /README.md
Reading: _posts/2013-08-14-blog-post-2.md
Reading: _posts/2012-08-14-blog-post-1.md
Reading: _posts/2015-08-14-blog-post-4.md
Reading: _posts/2199-01-01-future-post.md
Reading: _posts/2014-08-14-blog-post-3.md
EntryFilter: excluded /assets/js/plugins
EntryFilter: excluded /assets/js/vendor
Reading: _teaching/2014-spring-teaching-1.md
Reading: _teaching/2015-spring-teaching-2.md
Reading: _publications/2015-10-01-paper-title-number-3.md
Reading: _publications/2010-10-01-paper-title-number-2.md
Reading: _publications/2009-10-01-paper-title-number-1.md
Reading: _portfolio/portfolio-2.html
Reading: _portfolio/portfolio-1.md
Reading: _talks/2023-11-07-presentation.md
Reading: _talks/2023-11-28-presentation.md
Reading: _talks/2023-01-06-talk.md
Reading: _talks/2022-03-31-presentation.md
Reading: _talks/2024-02-02-presentation.md
Reading: _talks/2024-02-09-presentation.md
Reading: _talks/2023-09-27-talk.md
Reading: _talks/2024-02-06-talk.md
Reading: _talks/2023-11-26-presentation.md
Reading: _talks/2023-10-10-presentation.md
Reading: _talks/2023-12-05-presentation.md
Generating: JekyllRedirectFrom::Generator finished in 0.025965185 seconds.
Generating: JekyllOptionalFrontMatter::Generator finished in 0.00022088 seconds.
Generating: JekyllReadmeIndex::Generator finished in 0.000534733 seconds.
Generating: Jekyll::Paginate::Pagination finished in 4.859e-06 seconds.
Generating: Jekyll::JekyllSitemap finished in 0.00036056 seconds.
Jekyll Feed: Generating feed for posts
Generating: JekyllFeed::Generator finished in 0.00065649 seconds.
github-pages 229 | Error: undefined method `excerpt_separator' for #<Jekyll::Page @name="404.md">

问题原因 #

日志最后一行的关键错误显示：Jekyll在处理404.md页面时，找不到excerpt_separator方法，说明这个页面缺少必要的Front Matter配置，导致构建流程中断。

解决步骤 #

1. 打开你的GitHub Pages仓库，找到404.md文件（如果没有，直接新建一个）
2. 编辑该文件，在最顶部添加以下内容（注意前后的三个短横线）：

---
layout: default
excerpt_separator: "<!--more-->"
---

3. 保存修改并提交到GitHub，等待重新触发构建即可

内容的提问来源于stack exchange，提问作者SummerAtlas