HTTP/3访问失败主因是QUIC协议兼容性、UDP 443端口被中间设备屏蔽或客户端不支持，需优先排查“谁打不开”和“错在哪里”，而非直接回退协议。
FrankenPHP 启用 HTTP/3 后部分浏览器访问失败，通常不是配置本身错误，而是 HTTP/3 协议的兼容性、网络中间件限制或客户端环境不支持所致。重点排查方向是“谁打不开”和“错在哪里”，而非直接回退协议。
确认哪些浏览器/设备受影响
HTTP/3 依赖 QUIC 协议（基于 UDP），部分老旧或受限环境无法正常工作：
- Chrome 120+、Edge 120+、Firefox 125+（需手动启用
network.http.http3.enabled）基本支持；Safari 在 macOS 14.5+/iOS 17.5+ 中才稳定启用 - 企业内网、学校网络、某些运营商宽带可能屏蔽 UDP 443 端口，导致 QUIC 握手失败，降级失败时直接连接中断
- 使用代理、防火墙软件（如 Little Snitch、GlassWire）、杀毒软件（尤其带“HTTPS 扫描”功能的）会干扰 QUIC 流量，造成白屏或连接超时
检查 Caddy 是否正确降级到 HTTP/2 或 HTTP/1.1
HTTP/3 不应成为单点故障——Caddy 默认具备自动降级能力，但需确保配置未禁用回退路径：
- 确认 Caddyfile 中没有设置
protocol { enforce_http3 }这类强制指令 - 保留默认 TLS 配置，不要手动指定
tls { alpn http/1.1, h2 }排除 h3，否则会关闭协商通道 - 用
curl -I --http3 https://yoursite.com和curl -I --http2 https://yoursite.com分别测试，对比响应头中的alt-svc和实际使用的协议版本
验证服务端 UDP 端口与系统限制
HTTP/3 要求服务器开放 UDP 443（或自定义端口），且内核允许 QUIC 流量：
立即学习“PHP免费学习笔记（深入）”；
- Linux 上执行
sudo ss -tuln | grep ':443'，确认有udp监听项（如u_str 0 0 *:443 *:*） - 检查是否启用
net.ipv4.ip_forward=1（非必需），但更关键的是确认防火墙放行 UDP 443：sudo ufw allow 443/udp或sudo firewall-cmd --add-port=443/udp --permanent - 某些云主机（如 AWS EC2 安全组、腾讯云安全策略）默认只放行 TCP，需手动添加 UDP 443 规则
临时绕过问题的实用做法
若需快速恢复访问，不建议完全关闭 HTTP/3，可做最小干预：
- 在 Caddyfile 的全局块中，将
experimental_http3改为http3（Caddy v2.8+ 已转正，更稳定） - 对特定子域名或路径禁用 HTTP/3：在对应站点块中加
header X-FrankenPHP-HTTP3 "disabled"并配合应用层逻辑跳过 QUIC 尝试 - 用
caddy validate检查配置语法，并运行caddy run --config ./Caddyfile --adapter caddyfile查看启动日志中是否报failed to start HTTP/3 server
不复杂但容易忽略：多数“HTTP/3 访问失败”本质是网络链路问题，而非 FrankenPHP 或 PHP 应用本身。先从客户端环境和基础连通性入手，比反复调配置更高效。
