默认会写访问日志是因为caddy的reverse_proxy和php_fastcgi指令对非5xx响应自动记录日志；最干净方案是用handle /health { respond "ok" 200 }短路处理，使其不进入php流程且不记日志。
健康检查请求为什么默认会写访问日志
FrankenPHP 默认使用 Caddy 作为底层 HTTP 服务器，而 Caddy 的 reverse_proxy 和 php_fastcgi 指令在转发请求时，只要响应状态码不是 5xx（且未被显式拦截），就会触发默认的访问日志记录逻辑。像 /health 或 /ping 这类路径，只要没被提前匹配并跳过日志，就会和普通请求一样出现在 access.log 里。
用 Caddy 的 handle + respond 短路健康检查
最干净的做法是让健康检查路径不进入 PHP 处理流程，也不经过日志中间件。Caddy 允许你用 handle 显式匹配路径，并用 respond 直接返回，这样整个请求生命周期在日志模块之前就结束了。
示例配置（放在 Caddyfile 中对应站点块内）：
handle /health {
respond "OK" 200
}
关键点：
-
handle必须放在reverse_proxy或php_fastcgi规则之前，否则请求已被下游处理，再匹配无效 - 返回内容和状态码可按需调整，比如用
respond "{"status":"ok"}" 200配合 JSON 健康检查 - 该路径不会触发任何 PHP 脚本、不会读取磁盘、也不会记入 access log
用 log 指令排除特定路径（备选方案）
如果健康检查必须走 PHP（比如要验证数据库连接），但又不想进日志，可以用 Caddy 的日志过滤功能。它支持基于请求路径或响应状态码的条件排除。
在 Caddyfile 的 log 块中加 exclude：
log {
output file /var/log/caddy/access.log
exclude /health
exclude /ping
}
注意：
-
exclude是路径前缀匹配，/healthz也会被排除，如需精确匹配，得配合format+ 自定义日志模板和条件字段（较复杂） - 这个方式仍会执行 PHP 脚本、产生响应，只是不落日志；相比
handle方案，多了不必要的 PHP 启动开销 - 确保
log块作用域覆盖到你的站点块，避免因嵌套层级导致失效
验证是否生效的小技巧
别只看日志文件有没有新行——FrankenPHP 启动后，Caddy 日志可能有缓冲。实际验证建议：
- 用
curl -I http://localhost/health确认返回 200 且无重定向 - 执行一次请求后，立刻用
tail -f /var/log/caddy/access.log观察实时输出 - 对比请求
/health和/的日志行为差异，确认只有后者出现 - 如果用了
exclude但依然记日志，大概率是log块没生效，检查 Caddyfile 结构是否把log写在了错误位置（比如写在了全局块外）
路径匹配和日志开关的优先级容易混淆，真正起效的永远是第一条匹配成功的 handle 或第一个生效的 log 配置块。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
