执行 composer require easycorp/easyadmin-bundle 后 make:admin:dashboard 命令不存在，是因为缺少 symfony/maker-bundle；需运行 composer require --dev symfony/maker-bundle 并确保 app_env=dev。
composer require 安装后为什么 make:admin:dashboard 命令不存在？
常见现象是执行 composer require easycorp/easyadmin-bundle 后，运行 php bin/console make:admin:dashboard 报错 “Command ‘make:admin:dashboard’ not found”。这不是 EasyAdmin 本身的问题，而是缺少 Symfony MakerBundle。
EasyAdminBundle 不自带代码生成命令，它依赖 symfony/maker-bundle 提供的 make: 系列命令。必须显式安装：
- 运行
composer require --dev symfony/maker-bundle - 确保开发环境已启用（
APP_ENV=dev），否则--dev包不会被加载 - 检查
config/bundles.php中是否自动注册了Symfony\Bundle\MakerBundle\MakerBundle::class => ['dev' => true]
配置 easy_admin.yaml 时字段不显示或报错
生成 Dashboard 后，添加 CRUD 配置常遇到字段不渲染、Property "xxx" does not exist 或空白页面。核心原因是实体类未正确映射或配置路径错误。
关键检查点：
-
config/packages/easy_admin.yaml中的class必须是完整命名空间路径，例如App\Entity\User，不能写成User或相对路径 - 确保该实体类存在且已用 Doctrine 注解（如
@ORM\Entity）或 PHP 属性（PHP 8.1+）声明为实体 - 字段名必须与实体属性名完全一致（区分大小写），不能是数据库列名；比如属性是
$userName，就写userName，而非user_name - 若使用 PHP 8.1+ 的属性映射，需确认
doctrine/orm版本 ≥ 2.12，否则不识别#[ORM\Column]
php bin/console make:admin:crud 生成的控制器访问 404
执行 php bin/console make:admin:crud 后，访问类似 /admin/user 路径返回 404，通常不是路由没注册，而是菜单项未启用。
EasyAdmin 不自动注册 CRUD 菜单项，必须手动在 DashboardController::configureMenuItems() 中添加：
- 确认生成的 CRUD 控制器类名（如
UserCrudController）已正确导入 - 在
yield MenuItem::linkToCrud('Users', 'fa fa-users', User::class);中，第二个参数是图标类名（Layui 或 Font Awesome），第三个参数必须是实体类（User::class），不是控制器类 - 如果用了自定义路由前缀（如
@Route("/admin")改成了@Route("/manage")），整个后台路径会变，需同步更新浏览器访问地址
权限控制失效：所有用户都能访问管理页
EasyAdminBundle 默认不带权限校验，即使你配置了 Symfony 的 security.yaml，也需显式启用访问控制。
最简生效方式是在 DashboardController 的 configureDashboard() 中加一行：
return Dashboard::new()
->setTitle('Admin')
->setFaviconPath('favicon.svg')
->setUrlGenerator(function (string $routeName, array $routeParameters = []): string {
return $this->generateUrl($routeName, $routeParameters);
})
->setAccessControl('is_granted("ROLE_ADMIN")'); // ← 这行必须加
注意：is_granted("ROLE_ADMIN") 是表达式，不是字符串字面量；角色名需与 security.yaml 中定义一致；若用自定义 voter 或权限属性（如 can_edit），这里要写对应表达式。
容易忽略的是：EasyAdmin 的 CRUD 页面（如 /admin/user/edit/1）同样受此控制影响——它不单独校验，而是继承 Dashboard 的访问策略。
