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

2025-04-30 17:29:27作者：袁立春Spencer

项目地址：https://gitcode.com/gh_mirrors/cad/caddy

在使用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的模板功能，创建动态且用户友好的错误页面，提升网站的整体用户体验。

项目地址：https://gitcode.com/gh_mirrors/cad/caddy

登录后查看全文

项目优选

收起

deepin linux kernel

OpenHarmony documentation | OpenHarmony开发者文档

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

ohos_react_native

React Native鸿蒙化仓库

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

Ascend Extension for PyTorch

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统

旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件，通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求，让密码技术应用更简单，同时探索后量子等先进算法创新实践，构建密码前沿技术底座！

本项目是CANN开源社区的核心管理仓库，包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息

openGauss-server

openGauss kernel ~ openGauss is an open source relational database management system