EasyAdmin 生成 CRUD 后需立即修复路由、字段、权限三类问题：路由须经 DashboardController 入口并正确配置；字段须显式声明类型并处理关联与 getter；权限需在菜单、查询、操作中手动集成 Symfony Security。
EasyAdmin 能快速生成 CRUD 界面，但默认行为常导致路由冲突、字段显示异常或权限失控——关键不在“能不能生成”，而在“生成后怎么立刻修好”。
生成 CRUD 后 404 或路由不生效
常见于未正确注册控制器或忽略 DashboardController 的入口作用。EasyAdmin 6+ 强制要求所有后台页面必须通过继承 DashboardController 进入，不再支持直接绑定实体到路由。
- 确认已运行
php bin/console make:admin:dashboard，且生成的类（如src/Controller/Admin/DashboardController.php）被正确加载 - 检查
config/packages/easy_admin.yaml中的dashboard_controller配置是否指向该类完整命名空间（例如App\Controller\Admin\DashboardController） - 确保
DashboardController::configureRoutes()方法中调用了$routes->addDashboardRoute('dashboard', '/admin')，路径不能与现有 Symfony 路由重复 - 清除缓存：
php bin/console cache:clear，否则旧路由定义仍可能生效
CrudController 字段不显示或报 “Field not found” 错误
EasyAdmin 不自动推断 Doctrine 字段类型和访问方式，configureFields() 中若直接写字段名而未指定类型或未处理关联关系，就会失败。
- 用
TextField::new('title')显式声明字段，避免只传字符串'title'（尤其在 PHP 8.1+ 类型严格模式下易出错） - 对 ManyToOne 关联字段，必须用
AssociationField::new('author')，不能写TextField::new('author')；否则会尝试调用$entity->getAuthor()返回对象，再试图 toString 导致崩溃 - 日期字段优先用
DateTimeField::new('createdAt')，而非TextField，否则排序、筛选、时区处理全失效 - 若字段是 private 属性且无 getter，EasyAdmin 无法读取 —— 必须提供 public getter（如
getSlug()）或改用Field::new('slug')->setCustomOption('getter', 'getSlug')
列表页点击编辑跳转空白或 500
本质是 EasyAdmin 尝试渲染表单时找不到对应字段配置，或实体构造器/Setter 存在不可序列化依赖（如注入了 EntityManagerInterface）。
- 检查
configureFields()在edit()和new()场景下是否一致：有些字段（如IdField）在edit()中需设为setDisabled(true)，否则提交时会尝试更新主键 - 禁用非必要字段的表单渲染：对
DateTimeField使用->setFormTypeOption('widget', 'single_text')，避免原生datetime_local在 Safari/旧 Chrome 下格式错误触发验证失败 - 实体构造函数中不要依赖服务容器 —— EasyAdmin 实例化实体时仅调用无参构造器；若需初始化逻辑，改用
prePersist/preUpdate生命周期回调 - 启用调试：
APP_ENV=dev php bin/console server:start并查看 profiler 中的 “EasyAdmin” tab，它会明确标出哪个字段构建失败
权限控制形同虚设
EasyAdmin 默认不集成 Symfony Security 权限检查，canAccess() 或 isGranted() 需手动嵌入每个操作点。
- 在
DashboardController::configureMenuItems()中，对每个MenuItem::linkToCrud()加->setPermission('ROLE_ADMIN')，否则菜单项始终可见 - 重写
CrudController::createIndexQueryBuilder()时，若未调用parent::createIndexQueryBuilder($queryBuilder, $entityClass, $page, $maxPerPage, $sortField, $sortDirection)，会导致分页丢失且权限钩子不触发 - 最简权限拦截：在
CrudController::configureActions()中对edit、delete动作加->addCssClass('disabled')并配合前端隐藏，但这只是障眼法；真实校验必须在persistEntity()/deleteEntity()方法开头手动调用$this->isGranted('ROLE_EDITOR')
真正卡住人的从来不是生成命令本身，而是生成后第一次点击“编辑”按钮时控制台里那个没捕获的 ReflectionException，或者列表页字段突然全变成 __toString() error —— 这些细节不提前处理，后面每加一个字段都要回退排查。
