核心问题是FrankenPHP未将请求识别为静态文件，而是交由PHP处理；需确保Caddyfile中root与php_server均严格指向public/、项目结构合规、fileinfo扩展启用，并用curl -I验证响应头确认Caddy直供。
FrankenPHP 安装后静态资源访问失败（比如 /js/app.js 返回 404），核心问题不是 Laravel 或 Symfony 的路由没生效，而是 FrankenPHP 没把请求当作静态文件处理——它直接交给了 PHP 入口（index.php），而 PHP 又不负责返回 JS/CSS/图片，结果就是 404。关键在于让 Caddy 正确识别、定位并直供 public/ 下的文件。
确保 Caddyfile 中 root 和 php_server 路径严格一致
Caddy 需明确知道 Web 根在哪、PHP 文件从哪加载，两者必须都指向项目根目录下的 public/ 子目录，且写法要和实际挂载结构完全匹配：
-
正确写法：
root public/（相对路径，表示当前目录下的public/） -
错误写法：
root ./public、root /app/public或root public（缺斜杠易被误解析） -
php_server { try_files {path} index.php }中的{path}是相对于root的路径，所以它会先查public/js/app.js是否存在 - 如果用 Docker 挂载
-v $PWD:/app，但root写成root /app/public，Caddy 实际会去查/app/public/public/js/app.js—— 多了一层嵌套，必然 404
检查项目结构与挂载方式是否合规
FrankenPHP 默认以 public/ 为 Web 入口，这个约定不能绕过：
- 在项目根目录运行
ls -l public/，确认里面有index.php、css/、js/、images/等标准子目录和文件 - Docker 挂载必须是
-v $PWD:/app，不是-v $PWD/public:/app—— 后者会让root public/实际变成/app/public/，造成路径错位 - 独立二进制运行时，
Caddyfile必须放在项目根目录（即composer.json所在处），不能放在public/里
验证 fileinfo 扩展是否启用
fileinfo 缺失会导致 Caddy 无法正确识别文件 MIME 类型，进而跳过静态服务逻辑，直接 fallback 到 index.php：
立即学习“PHP免费学习笔记（深入）”；
- 二进制方式执行：
frankenphp php-cli -m | grep fileinfo - Docker 方式执行：
docker exec -it your-container frankenphp php-cli -m | grep fileinfo - 若无输出，说明未启用；Docker 用户可在构建镜像时加
RUN install-php-extensions fileinfo - 二进制用户需下载带该扩展的版本，或手动编译；否则
hello.txt可能被当成text/html返回，甚至触发 PHP 解析
用 curl -I 直接验证静态路径响应头
别只看页面能否打开，要确认请求是否真由 Caddy 直接响应：
- 在
public/下放一个测试文件：echo "static ok" > public/hello.txt - 执行：
curl -I http://localhost:8000/hello.txt - 检查响应头：
- 状态码应为
200 OK（不是 404 或 500） -
Content-Type应为text/plain; charset=utf-8（不是text/html） - 响应头中不应出现
X-Powered-By: PHP或X-FrankenPHP（这些是 PHP 处理的标志）
- 状态码应为
