Symfony EasyAdminBundle 4访问/admin出现404未找到的问题

以下是几种常见的问题原因及对应解决方法：

1. 路由未正确加载 #

• 检查config/routes.yaml，确认是否包含EasyAdmin的路由配置：

  easy_admin_bundle:
      resource: '@EasyAdminBundle/Controller/'
      type: attribute
  

• 验证项目是否启用注解路由，在config/packages/framework.yaml中确保路由配置正确：

  framework:
      router:
          enabled: true
          resource: '%kernel.project_dir%/config/routes.yaml'
          type: attribute
  

• 执行命令symfony console debug:router，查看输出中是否存在admin路由。如果没有，说明路由未被加载，需检查上述配置。

2. 控制器类未被正确识别 #

• 确认DashboardController的文件路径为src/Controller/Admin/DashboardController.php，命名空间App\Controller\Admin与文件结构匹配（Linux系统需注意文件名大小写）。
• 执行命令symfony console debug:container App\Controller\Admin\DashboardController，若无法找到该控制器，说明类未被自动加载，可重新执行symfony composer dump-autoload并检查文件路径。

3. 服务器配置问题 #

• 若使用Symfony内置服务器，执行symfony server:stop后再重新启动symfony server:start，确保路由变更被加载。
• 若使用Apache/Nginx：
  • Apache需启用mod_rewrite模块，且项目根目录的.htaccess文件（Symfony默认提供）配置正常。
  • Nginx需配置正确的URL重写规则，示例：

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }
    

4. 组件安装不完整 #

• 重新执行symfony composer req "admin:^4"，查看安装过程是否有报错（如依赖冲突）。
• 检查vendor/easycorp/easyadmin-bundle目录是否存在且文件完整，若缺失可删除vendor目录和composer.lock后重新执行composer install。

内容的提问来源于stack exchange，提问作者Klipe_LD