frankenphp 下 laravel 样式丢失的根源是 document root 未正确指向 public/ 目录；必须在 frankenphp.yaml 或启动参数中显式配置 root 为 public 的绝对路径，如 /var/www/myapp/public，并确保 docker volume 映射正确，否则静态资源返回 404。
是的，FrankenPHP 下 Laravel 样式全丢，大概率就是 public 目录没指对——不是 Laravel 代码问题，也不是 Vite 构建失败，而是 FrankenPHP 的 document root 配置没落到 public/ 子目录上。
FrankenPHP 的 root 必须显式设为 public 绝对路径
FrankenPHP 不像 php artisan serve 那样自动推导入口，它默认把项目根（含 app/、routes/）当 Web 根，直接拒掉所有 /css/app.css 请求。你必须在 FrankenPHP 配置中硬编码指定 public/ 路径。
- 检查
frankenphp.yaml或命令行启动参数：确认root字段值是类似/var/www/myapp/public（Linux）或D:/www/myapp/public（Windows），不能是/var/www/myapp - 如果用 Docker，确保
volumes映射的是./public:/var/www/html，而不是./:/var/www/html - FrankenPHP 的
index必须是index.php，且只允许出现在root下，不能靠重写规则“绕进去”
别信 php artisan serve 能蒙混过关
你在本地跑 php artisan serve 没问题，不代表 FrankenPHP 配置正确。那个命令自带路由转发和 public/ 入口绑定，完全绕开了 Web 服务器层的 root 设置。FrankenPHP 是真实应用服务器，它会严格按你写的 root 去找文件。
- 手动访问
http://your-domain/css/app.css：返回 404？说明 root 错了；返回 200 但内容乱码或为空？可能是 MIME 类型没配或缓存问题 - 如果
http://your-domain/index.php/css/app.css能打开，那基本坐实 root 指向了项目根而非public/ -
php artisan serve的端口（如:8000）和 FrankenPHP 的监听端口（如:8080）不要混用测试，它们是两套生命周期
Vite manifest 和 asset() 在 FrankenPHP 下照常工作
只要 root 正确指向 public/，Laravel 的 asset()、Vite 的 @vite 就不会出问题——它们生成的路径都是相对于 Web 根的，不依赖服务器类型。
- 确保
public/build/manifest.json存在且非空，里面至少有一条"resources/js/app.js": "assets/app.xxxx.js"记录 -
@vite(['resources/js/app.js'])参数必须是数组，不能是字符串；否则 PHP 直接报Array to string conversion - FrankenPHP 默认不读
.htaccess，也不需要 mod_rewrite；但如果你启用了rewrite规则，要确认它没把/css/这类请求错误地重写进 PHP 而不是直出文件
最易被忽略的一点：FrankenPHP 启动时不会校验 root 目录是否存在或可读。它静默失败，直接返回 404。所以每次改完配置，务必 手动检查该路径下是否存在 index.php 和 css/ 子目录，别只看日志有没有报错。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
