Symfony CLI 在 FrankenPHP 下报 Class not found 是因 CLI 进程未加载 vendor/autoload.php 和 config/bootstrap.php，缺少 autoloader 与环境变量（如 APP_ENV）。需确保 bin/console 顶部包含 autoload 引用。
为什么 Symfony CLI 在 FrankenPHP 下执行命令会报 Class not found
因为 FrankenPHP 启动时加载的是 Web 运行时环境（含完整框架 bootstrap），而 Symfony CLI 是独立 PHP 进程，不共享 FrankenPHP 的 autoloader 或容器初始化逻辑。常见于运行 bin/console cache:clear 或 bin/console doctrine:migrations:migrate 时，提示找不到 Symfony\Component\Console\Application 或自定义命令类。
根本原因不是路径错，而是 CLI 进程没走 FrankenPHP 的入口引导流程——它不会自动 require vendor/autoload.php，也不会加载 config/bootstrap.php 中的环境预设（比如 $_SERVER['APP_ENV'] 或 $_SERVER['APP_DEBUG']）。
- 确保
bin/console文件顶部有标准 autoload 引用：#!/usr/bin/env php <?php use App\Kernel; use Symfony\Bundle\FrameworkBundle\Console\Application; require_once dirname(__DIR__).'/vendor/autoload.php'; // ... 其余逻辑
- 不要依赖 FrankenPHP 的环境变量注入：CLI 进程不继承
FrankenPHP_SERVER_NAME或FRANKENPHP_WORKER这类变量，$_SERVER是干净的，必须显式传参或设环境变量 - 如果使用
--env=prod参数仍失败，检查config/bootstrap.php是否对 CLI 场景做了条件判断（例如跳过某些仅 Web 需要的扩展初始化）
如何让 bin/console 正确识别 FrankenPHP 的配置环境
FrankenPHP 不会自动把 Web 环境变量透传给 CLI，但你可以复用它的配置加载机制，避免两套环境逻辑分裂。
- 在
bin/console开头手动加载 FrankenPHP 的环境初始化片段（如果项目已按官方推荐方式集成）：if (file_exists(dirname(__DIR__).'/config/packages/frankenphp.php')) { (require dirname(__DIR__).'/config/packages/frankenphp.php')($container->get('kernel')); } - 更稳妥的做法是统一通过
APP_ENV和APP_DEBUG控制行为：在 CLI 调用时显式指定，例如APP_ENV=prod APP_DEBUG=0 php bin/console cache:clear - 注意
php.ini差异：FrankenPHP 内嵌的 PHP 运行时可能使用自己的php.ini（路径通常是/etc/php/frankenphp.ini或编译时指定位置），而 CLI 默认用系统级php.ini。扩展缺失（如pdo_mysql）导致命令失败时，优先对比两者php -m输出
运行 doctrine:fixtures:load 报数据库连接失败的排查点
错误现象通常是 SQLSTATE[HY000] [2002] No such file or directory 或 Connection refused，表面看是 DB 连接问题，实际多因环境隔离导致 DSN 解析失败。
立即学习“PHP免费学习笔记（深入）”；
- FrankenPHP 的
DATABASE_URL通常从.env或环境变量读取，但 CLI 进程默认不加载.env—— 必须用composer install --no-interaction后的.env.local，或确保symfony server:start未干扰当前 shell 的 env - 若用 Unix socket 连接 MySQL（如
mysql://root@/app?unix_socket=/var/run/mysqld/mysqld.sock），CLI 进程需有相同路径权限，且 socket 文件在容器/宿主机中真实存在；FrankenPHP 可能挂载了该路径，但 CLI 没有 - 检查 Doctrine 配置是否条件加载：有些项目在
config/packages/doctrine.yaml里写了when@prod，结果 CLI 默认走dev环境却没配 DB，反而报连接错
Worker 模式下 CLI 命令与常驻进程的生命周期冲突
开启 FrankenPHP 的 worker 模式后，PHP 进程长期存活，而 CLI 命令是短命进程，二者共用同一份缓存目录（如 var/cache/prod）时容易出现「缓存已损坏」或「Container not found」错误。
- worker 进程会锁住
var/cache/prod/Container*目录下的文件，CLI 执行cache:clear时可能删不干净，建议加--no-warmup参数，清完再手工rm -rf var/cache/* - 避免在 worker 运行中执行迁移或 fixture 加载：Doctrine 的 schema 更新可能修改实体映射，而 worker 进程仍持有旧类定义，后续请求会触发 fatal error
- 生产环境应禁用 CLI 自动 warmup：FrankenPHP worker 启动时已做一次完整 warmup，CLI 的
cache:warmup不仅冗余，还可能污染 worker 正在使用的缓存结构
