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>

关键变量说明

http.error.status_code - 获取HTTP错误状态码
http.error.status_text - 获取对应的状态文本描述
.OriginalReq.URL - 获取原始请求的URL路径

最佳实践建议

为错误页面设计统一的布局，保持与网站整体风格一致
考虑为常见错误状态码（如404、500）创建专用模板
在错误页面提供有用的导航链接，帮助用户返回正常内容
对于生产环境，避免展示过于详细的错误信息以防安全风险

通过这种方式，开发者可以充分利用Caddy的模板功能，创建动态且用户友好的错误页面，提升网站的整体用户体验。

登录后查看全文

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

问题背景

解决方案

关键变量说明

最佳实践建议

项目优选