Apache+PHP环境安装API Platform后无法访问/api路径如何排查

访问异常由两个配置不匹配问题导致：

1. 当前Apache站点根目录（DocumentRoot）指向了Symfony项目根文件夹，而非框架要求的public/目录，因此所有请求必须携带/public前缀才能命中前端控制器，但API Platform默认生成的路由前缀为/api，未自动适配该子路径场景。
2. Apache的URL重写规则未正确生效，未将不存在的静态路径转发给public/index.php入口文件解析。

• 优先调整Apache站点配置（推荐，符合Symfony官方部署规范，适配绝大多数支持自定义根目录的共享主机）
  将站点根目录直接指向项目内的public文件夹，参考配置如下（替换路径为你环境内的实际绝对路径）：

  <VirtualHost *:80>
      ServerName localhost
      DocumentRoot /var/www/html/public
      <Directory /var/www/html/public>
          AllowOverride All
          Require all granted
          FallbackResource /index.php
      </Directory>
  </VirtualHost>
  

  配置完成后重启Apache服务，此时直接访问http://localhost/即可打开Symfony欢迎页，无需再添加/public前缀。
  注意：如果使用默认Apache镜像，需要先执行a2enmod rewrite开启重写模块，否则规则不生效。

• 适配无法修改站点根目录的共享主机场景
  如果你使用的共享主机不支持自定义Web根目录，只能以项目根目录作为对外访问路径，做两处调整即可：

  1. 将public目录下安装symfony/apache-pack后自动生成的.htaccess文件复制到项目根目录，调整重写规则，将所有请求转发到public/index.php处理。
  2. 打开config/routes/api_platform.yaml配置文件，修改API路由前缀适配子路径：

     api_platform:
         resource: .
         type: api_platform
         prefix: /public/api
     

• 配置生效验证
  所有调整完成后执行php bin/console cache:clear清除项目缓存：

  • 若按第一种方式调整了站点根目录，直接访问http://localhost/api即可正常打开API Platform文档页面
  • 若按第二种方式适配了子目录部署，访问http://localhost/public/api即可正常访问

内容的提问来源于stack exchange，提问作者Nicolas K.