“class not found”在symfony 4中根源在于psr-4映射、命名空间与路径未严格对应：类appcontrollerhomecontroller必须位于src/controller/homecontroller.php，namespace声明需匹配目录结构，新增类后须执行composer dump-autoload -o，并清理缓存php bin/console cache:clear。
“Class not found”在 Symfony 4 中不是类文件丢了，而是自动加载机制根本没找到它——根源几乎都出在 PSR-4 映射、命名空间与路径的严格对应关系上。
命名空间和文件路径不匹配
Symfony 4 依赖 Composer 的 PSR-4 自动加载规则：类的命名空间必须逐级对应物理路径，且大小写完全一致（Linux/生产环境尤其敏感）。
- 比如类 AppControllerHomeController 必须定义在 src/Controller/HomeController.php，不能是
src/controller/homecontroller.php或src/Controllers/HomeController.php - 检查文件开头的
namespace AppController;是否与目录结构一致；class HomeController名称是否拼写准确（无多余空格、下划线或大小写错位） - 常见陷阱：IDE 自动生成类时默认用 PascalCase，但手动创建文件时误存为小写，或 Git 提交后因 macOS 不区分大小写掩盖了问题
composer.json 配置未覆盖或未生效
Symfony 4 默认在 composer.json 中配置 "psr-4": { "App": "src/" }。若你把类放在 src/Domain/User.php，命名空间就得是 AppDomain；否则 Composer 不会扫描该文件。
- 确认
composer.json的 autoload 段中，App\后有双反斜杠，路径"src/"以斜杠结尾 - 新增类或修改命名空间后，必须运行
composer dump-autoload -o（加-o生成优化映射，开发环境也建议执行） - 如果使用多应用或多模块结构（如
src/AdminBundle），需额外声明 PSR-4 映射，不能只靠默认配置
类被忽略或未被正确识别
Doctrine 实体、命令、事件监听器等组件，还需满足框架自身的识别条件，否则即使能自动加载，也会在运行时报 “Class not found”（实际是服务容器或注册机制找不到）。
- 实体类缺少
#[ORMEntity]（PHP 8.0+）或@ORMEntity（PHP 7.x）注解，Doctrine 就不把它当实体处理 - 自定义命令类没继承
Command或没加#[AsCommand]属性，Console 组件无法发现它 - 运行
php bin/console debug:container --parameter=kernel.bundles或debug:autowiring，确认你的类是否出现在已注册列表中
缓存与开发环境干扰
Symfony 4 默认启用 OPcache 和容器缓存，改完代码不清理缓存，旧映射可能还在生效。
- 每次修改
composer.json或新增类后，先清缓存：php bin/console cache:clear（开发环境可加--env=dev） - 如果用了 Docker 或远程部署，注意宿主机与容器内文件同步是否完整，
src/目录有没有被 .dockerignore 排除 - 临时关闭 OPcache（
opcache.enable=0）可快速验证是否为缓存导致的假性“找不到”
