For AI agents: the complete documentation index is available at https://docs.halo.run/llms.txt, the full documentation bundle is available at https://docs.halo.run/llms-full.txt, and this page is available as Markdown at https://docs.halo.run/developer-guide/theme/template-variables/error.md.
Halo 文档

    错误页面

    路由信息

    • 模板路径：/templates/error/{404,4xx,500,5xx,error}.html
    • 访问路径：无固定访问路径，由异常决定
    错误模板匹配顺序

    错误页面的可使用模板由状态码决定，例如 404 状态码对应的模板为 /templates/error/404.html 或者 /templates/error/4xx.html。也可以使用 /templates/error/error.html 作为默认模板。

    识别顺序如下：

    1. /templates/error/404.html
    2. /templates/error/4xx.html
    3. /templates/error/error.html

    变量

    error

    变量类型

    {
  "detail": "string", // 异常详细信息
  "instance": "string", // 异常实例
  "status": "number", // 异常状态码
  "title": "string", // 异常标题
  "type": "string", // 异常类型
}

    示例

    /templates/error/error.html
    <div>
  <h2 th:text="${error.status}"></h2>
  <p
    th:text="${#strings.defaultString(error.title, 'Internal server error')}"
  ></p>
  <p
    th:if="${not #strings.isEmpty(error.detail)}"
    th:text="${error.detail}"
  ></p>
</div>