Caddy服务器中错误处理模板的变量访问技巧

2025-04-30 01:18:36作者：袁立春Spencer

在使用Caddy服务器时，handle_errors指令提供了一种优雅的方式来处理HTTP错误响应。许多开发者希望在这种错误处理场景下，能够像常规响应那样访问错误上下文变量，以便在模板中动态展示错误信息。

问题背景

开发者通常希望在错误页面模板中展示诸如状态码、状态文本等错误信息。一个常见的配置尝试如下：

handle_errors {
    root * /usr/share/caddy
    templates
    file_server

    @favicon path /favicon.ico
    file_server @favicon

    rewrite * /{err.status_code}.html
    try_files {path} /error.html
}

开发者期望在error.html模板中能够直接访问err对象，例如：

<html>
<head>
    <title>{{ err.status_code }} {{ err.status_text }}</title>
</head>
<body>
    <p>{{ err.status_code }} {{ err.status_text }}</p>
</body>
</html>

解决方案

实际上，Caddy提供了通过模板函数访问这些错误信息的方式。正确的做法是使用ph（placeholder）函数来获取错误上下文变量：

<html>
<head>
    <title>{{ ph "http.error.status_code" }} {{ ph "http.error.status_text" }}</title>
    <link rel="icon" type="image/x-icon" href="/favicon.ico">
</head>
<body>
    <p>{{ ph "http.error.status_code" }} {{ ph "http.error.status_text" }}</p>
    <p>Error accessing: "{{ .OriginalReq.URL }}"</p>
</body>
</html>