EasyAdmin 4安装后必须立即执行三步：运行make:admin:dashboard生成DashboardController；确认routes/easy_admin.yaml存在且配置正确；检查@Route("/admin")注解并清缓存。
直接用 symfony composer req "admin:^4" 安装 EasyAdmin 4，比手动配 bundle 和路由快得多，且默认兼容 Symfony 6.4+ 和 PHP 8.2+。别碰旧版 ^3 或 ^2，它们不支持现代表单类型和响应式布局。
安装后必须立即执行的三件事
很多开发者卡在“页面空白”或“/admin 404”，其实只是漏了这三步：
- 运行
php bin/console make:admin:dashboard—— 这会生成src/Controller/Admin/DashboardController.php，没它就没有入口 - 确认
config/routes/easy_admin.yaml存在且内容为easy_admin: resource: '@EasyAdminBundle/Controller/AdminController.php' type: annotation；若不存在，手动创建 - 检查
DashboardController::index()上的@Route("/admin", name="admin")注解是否生效 —— 如果你改过默认路由前缀（比如用了framework.router.strict_requirements: false），得手动清缓存：php bin/console cache:clear
实体管理页生成失败：常见报错与绕过方案
执行 php bin/console make:admin:crud 后提示 “Class 'App\Entity\XXX' not found” 或 “No entities found”，通常不是代码问题，而是：
- 实体类没加
#[ORM\Entity]（PHP 8.0+）或@ORM\Entity（PHP - 实体命名空间不是
App\Entity\*—— 若你用了Domain\Entity\*，需在config/packages/easy_admin.yaml中显式声明：entities: ['Domain\Entity\Post', 'Domain\Entity\User'] - 字段类型不被识别（如自定义 ValueObject）—— 在 CRUD 配置中跳过该字段：
yield TextField::new('customField')->hideOnForm()->hideOnIndex();
表单字段乱序、必填项不生效？检查 type_options 传递方式
EasyAdmin 4 的表单字段配置对参数传递非常敏感。写成这样会失效：
- { property: 'email', type: 'email', type_options: { required: true } }正确写法是：
- { property: 'email', type: 'email', type_options: { 'required': true } }注意 'required' 必须加引号 —— YAML 解析器会把无引号的 required: true 当作布尔键，而 EasyAdmin 内部用字符串键匹配表单选项。同理，attr、help、label 等嵌套配置都需严格按字符串键书写。
最易被忽略的是 DashboardController 中 configureMenuItems() 的 yield 顺序：菜单项不会自动按字母或创建时间排序，必须手动调整 yield 行顺序，否则后台左侧导航栏顺序和你预期不符。
