先确认vendor目录是否存在且完整，frankenphp build不生成vendor而仅嵌入当前存在的文件；若缺失vendor/autoload.php则类加载失败，构建前须在项目根执行composer install --no-dev --optimize-autoloader并清理框架缓存。
frankenphp build 时 vendor 目录没被嵌入？先确认它是否真在项目里
打包后运行报 Class not found 或 failed to open stream: No such file or directory 指向 vendor/autoload.php，大概率不是 FrankenPHP 漏打包，而是构建前 vendor/ 根本不存在或位置不对。
- 执行
ls -la vendor/确认目录存在且非空——如果连vendor/autoload.php都没有，frankenphp build不会报错，但会静默跳过自动加载逻辑 - 检查是否在子目录（如
public/或src/）下误执行了composer install，导致vendor/出现在错误层级 -
composer.json和composer.lock必须和vendor/在同一级目录（即项目根），FrankenPHP 构建时只读当前目录下的这些文件
vendor 目录存在但 still 找不到？检查构建时的执行路径和环境变量
FrankenPHP 构建过程不会重新运行 composer install，它只把当前已有的 vendor/ 整个打包进二进制。所以即使你改了 composer.json，不手动重装依赖，新包也不会出现。
- 构建前必须显式运行
composer install --no-dev --optimize-autoloader：加--no-dev避免 dev-only 包混入，--optimize-autoloader生成高效映射，否则vendor/composer/autoload_*.php可能缺失或过期 - 确保构建命令在项目根目录执行：
frankenphp build --output myapp—— 如果你在public/下执行，它会找public/vendor/，而那里通常没有 - 别依赖
.env里的COMPOSER_VENDOR_DIR：FrankenPHP 不读这个变量，vendor/必须是默认名、默认位置
打包后 vendor/ 看不见？它确实不以文件形式存在，但内容已嵌入
FrankenPHP 的单文件二进制不保留原始目录结构，vendor/ 不是“挂载”进去的，而是字节码级嵌入。你无法在运行时 ls vendor/，但类加载照常工作——前提是构建前的 vendor/ 正确且完整。
- 验证方式：启动二进制后访问
/，看是否返回 Laravel/Symfony 欢迎页；或用curl -I http://localhost/index.php看是否 200 而非 500 - 如果失败，查日志：
./myapp 2>&1 | grep -i "autoload\|class"，常见错误是require(): Failed opening required 'vendor/autoload.php'，说明构建时该文件根本没被读到 - 不要试图在二进制运行时执行
composer dump-autoload：它没有 Composer、没有写权限、也没有vendor/目录可操作
Laravel/Symfony 项目特别容易踩的坑：缓存污染了嵌入内容
框架的运行时缓存（如 bootstrap/cache/config.php 或 var/cache/prod/Container*）如果没清空，会被直接打包进二进制，导致新配置不生效、旧类路径残留——看起来像 vendor/ 没更新，其实是缓存覆盖了新逻辑。
- 构建前务必清理：
rm -rf bootstrap/cache/*（Laravel）或rm -rf var/cache/prod/（Symfony） - 同时运行
php artisan config:clear和php artisan view:clear（Laravel），确保下次启动不从旧缓存读取 - 别忽略
storage/framework/cache/：某些中间件或扩展会把类映射写到这里，FrankenPHP 会一并打包
vendor/，只搬运。它打包的是你构建那一刻磁盘上真实存在的那个 vendor/ 目录——少一个文件，就少一个类；多一个缓存，就多一个 bug。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
