Symfony 4 + FOSRestBundle：API路由返回404但Web路由正常

嘿，我之前也碰到过一模一样的情况——路由明明在debug:router里显示正常，但就是返回404，Web路由却完全没问题，咱们一步步来揪出问题：

1. 先确认请求URL与路由的完全匹配 #

你说调试时看到/api/demo/{id}已生成，先仔细核对curl请求的URL：

• 有没有多打/少打斜杠？比如不小心写成/api//demo/1或者/apidemo/1
• 前缀大小写是否一致？比如路由是/api，你请求的是/API（虽然Symfony路由默认不区分大小写，但Web服务器配置可能有影响）
• 同时检查routes.yaml里给API路由配置的前缀，和fos_rest.yaml中的路由规则有没有冲突

2. 验证API控制器的注解与注册 #

FOSRestBundle对注解的依赖很强，别漏了关键配置：

• 确保API控制器类上有正确的路由注解，比如：

  // src/Controller/Api/DemoController.php
  namespace App\Controller\Api;
  
  use FOS\RestBundle\Controller\AbstractFOSRestController;
  use FOS\RestBundle\Controller\Annotations as Rest;
  
  class DemoController extends AbstractFOSRestController
  {
      /**
       * @Rest\Get("/demo/{id}")
       */
      public function getDemoAction(int $id)
      {
          // ...
      }
  }
  

• 检查services.yaml里的API控制器注册，有没有加上必要的标签：

  services:
      App\Controller\Api\:
          resource: '../src/Controller/Api'
          tags: ['controller.service_arguments']
  

• 还要确认routes/annotations.yaml里扫描到了API控制器目录：

  api:
      resource: '../src/Controller/Api/'
      type: annotation
      prefix: /api
  

3. 检查请求的Accept头格式 #

FOSRestBundle默认会根据Accept头判断响应格式，如果请求没带正确的头，可能导致路由匹配失败：

• 试试在curl请求里加上格式头：curl -H "Accept: application/json" http://your-domain/api/demo/1
• 或者在fos_rest.yaml里配置强制API路径使用json格式，避免格式匹配问题：

  fos_rest:
      format_listener:
          rules:
              - { path: '^/api', priorities: ['json'], fallback_format: json, prefer_extension: false }
  

4. 清理Symfony缓存（必做！） #

Symfony的路由缓存有时候会“记仇”，尤其是修改过路由配置后：

• 开发环境执行：php bin/console cache:clear
• 生产环境执行：php bin/console cache:clear --env=prod
• 清理完再用php bin/console debug:router确认路由仍然存在，然后再测试请求

5. 确认请求方法与路由匹配 #

你说的是GET路由，务必确认curl用的是GET方法：

• 比如正确的curl命令是：curl http://your-domain/api/demo/1，而不是带-X POST的请求
• 查看debug:router输出的路由信息，Method列是不是明确标记了GET，有没有被限制为其他方法

6. 检查Web服务器配置（Apache/Nginx） #

如果用了外部Web服务器，确保请求能正确转发到Symfony的入口文件：

• Apache：确认public/.htaccess文件是Symfony默认的那个，没有被修改导致/api路径无法转发
• Nginx：检查配置里的try_files规则是否正确，比如：

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

  这条规则要确保所有请求（包括/api开头的）都能走到index.php

内容的提问来源于stack exchange，提问作者Astro-Otter