EasyAdmin 4 使用前须确认三件事：项目满足 Symfony 5.4+/6.x（推荐 6.4+）、Doctrine 实体已正确定义并验证通过、DATABASE_URL 数据库连接正常；否则后台无法正常运行。
EasyAdmin 生成后台前必须确认的三件事
不是装上就能用，EasyAdmin 要求项目已满足 Symfony 5.4+ 或 6.x（推荐 6.4+），且 Doctrine 实体已定义好、数据库已可连接。如果 php bin/console doctrine:schema:validate 报错，先别碰 EasyAdmin——它不会帮你修实体映射。
- 检查
composer show symfony/framework-bundle版本，低于 5.4 的老项目建议升级或改用 EasyAdmin 3（对应 Symfony 4.4–5.3） - 确保实体类有 Doctrine 注解（如
@ORM\Entity）或 PHP 属性映射，并已运行过php bin/console make:migration和php bin/console doctrine:migrations:migrate - 确认
.env中DATABASE_URL可连通，执行php bin/console doctrine:query:sql "SELECT 1"不报错
安装与基础配置一步到位
EasyAdmin 4 是当前主流版本，安装后默认启用仪表盘，但不自动注册任何实体——这是新手最常卡住的地方。
- 运行
composer require easycorp/easyadmin-bundle，Bundle 会自动注册（Symfony 6.2+ 自动配置） - 访问
/admin出现 “No dashboard configured” 错误？说明还没创建 Dashboard 控制器，运行php bin/console make:admin:dashboard生成src/Controller/Admin/DashboardController.php - 该命令会创建一个空的
configureDashboard()方法，但不会加configureCrud()或configureAssets()——这些要手动补，否则页面空白或样式错乱
让实体出现在后台的最小必要操作
只把实体类加进 configureMenuItems() 不够，EasyAdmin 4 要求每个实体必须有对应的 CrudController，否则点击菜单直接 404。
- 运行
php bin/console make:admin:crud，选择目标实体（如User），它会生成src/Controller/Admin/UserCrudController.php - 生成的控制器里，
configureFields()默认返回空数组，字段全不可见；至少得写一行：yield TextField::new('email');（假设 User 有 email 字段） - 在 DashboardController 的
configureMenuItems()中，必须用MenuItem::linkToCrud()显式关联：MenuItem::linkToCrud('Users', 'fas fa-user', User::class) - 注意：字段名必须和实体属性名完全一致（区分大小写），
TextField::new('Email')会报 “Property not found” 错误
常见报错和绕不开的坑
EasyAdmin 对类型推断很敏感，很多错误表面是模板问题，根源在字段配置或数据类型不匹配。
-
Unable to guess field type for property "createdAt"：Doctrine 字段没设@ORM\Column(type="datetime_immutable")或用了DateTimeInterface但没指定具体类型，补上@ORM\Column(type="datetime_immutable")再清缓存 - 列表页显示 “N/A” 或空白：字段未在
configureFields()中声明，或用了AssociationField::new('category')但 Category 实体没配 CrudController - 表单提交后跳转 404：检查路由是否被其他 Bundle 覆盖，运行
php bin/console debug:router确认admin_user_index等路由存在 - 中文字段名显示乱码：不要在
setLabel()里写中文，改用翻译域（setLabel('user.email')+translations/messages.zh.yaml），否则 Twig 渲染失败
真正麻烦的不是生成，而是字段级控制——比如密码字段不能明文编辑、关联字段要限制选项范围、列表页要加搜索过滤。这些都得在 CrudController 里手写逻辑，没有一键按钮。
