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

2025-04-30 17:29:27作者：袁立春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的模板功能，创建动态且用户友好的错误页面，提升网站的整体用户体验。

登录后查看全文

热门内容推荐

最新内容推荐

项目优选

收起

ohos_react_native

React Native鸿蒙化仓库

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

openGauss-server

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

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

HarmonyOS-Examples

本仓将收集和展示仓颉鸿蒙应用示例代码，欢迎大家投稿，在仓颉鸿蒙社区展现你的妙趣设计！

CangjieCommunity

为仓颉编程语言开发者打造活跃、开放、高质量的社区环境

ShopXO开源商城

🔥🔥🔥ShopXO企业级免费开源商城系统，可视化DIY拖拽装修、包含PC、H5、多端小程序(微信+支付宝+百度+头条&抖音+QQ+快手)、APP、多仓库、多商户、多门店、IM客服、进销存，遵循MIT开源协议发布、基于ThinkPHP8框架研发

一款跨平台的 Markdown AI 笔记软件，致力于使用 AI 建立记录和写作的桥梁。

🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端

基于可以运行在OpenHarmony的git，提供git客户端操作能力