Symfony 3.4+FOSRestBundle自定义报错遇私有控制器容器获取错误

这个问题我在Symfony 3.4搭配FOSRestBundle开发API时也碰到过，核心原因是Symfony 3.4默认将服务设为私有，而fos_rest.exception.twig_controller这个服务缺少controller.service_arguments标签——Symfony需要这个标签来识别一个服务可以作为控制器调用，所以容器才会抛出那个报错。

下面是几个可行的解决办法，按需选择：

方法1：修复fos_rest.exception.twig_controller服务配置 #

直接在你的app/config/services.yml里覆盖这个服务的配置，给它加上控制器标签并设为公共：

services:
    fos_rest.exception.twig_controller:
        class: FOS\RestBundle\Controller\ExceptionController
        arguments:
            - '@twig'
            - '%fos_rest.exception.templates%'
        tags:
            - { name: controller.service_arguments }
        public: true

这样容器就能正确识别它作为控制器使用了，适合你确实需要用Twig渲染错误页面的场景。

方法2：改用API专用的默认异常控制器 #

如果你的API只需要返回JSON/XML这类结构化错误响应，不需要Twig渲染页面，那更简单——直接在app/config/config.yml的FOSRest配置里切换到默认的API异常控制器：

fos_rest:
    exception:
        controller: 'fos_rest.exception.controller'

这个控制器是FOSRestBundle专门为API设计的，返回的错误格式符合REST规范，而且它的服务配置已经默认加好了必要的标签，不会触发私有服务的问题。

方法3：自定义异常控制器（进阶） #

如果需要完全定制错误响应的格式或逻辑，可以自己写一个异常控制器：

1. 先创建控制器类，实现FOS\RestBundle\Controller\ExceptionControllerInterface：

// src/AppBundle/Controller/CustomExceptionController.php
namespace AppBundle\Controller;

use FOS\RestBundle\Controller\ExceptionControllerInterface;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\Exception\FlattenException;
use Twig\Environment;

class CustomExceptionController implements ExceptionControllerInterface
{
    private $twig;
    private $templates;

    public function __construct(Environment $twig, array $templates)
    {
        $this->twig = $twig;
        $this->templates = $templates;
    }

    public function showAction(FlattenException $exception, $format = 'html', array $context = [])
    {
        // 自定义你的错误响应逻辑，比如返回JSON
        $data = [
            'code' => $exception->getStatusCode(),
            'message' => $exception->getMessage()
        ];
        
        return new Response(json_encode($data), $exception->getStatusCode(), [
            'Content-Type' => 'application/json'
        ]);
    }
}

2. 在services.yml里注册这个控制器，加上必要的标签：

services:
    AppBundle\Controller\CustomExceptionController:
        arguments:
            - '@twig'
            - '%fos_rest.exception.templates%'
        tags:
            - { name: controller.service_arguments }

3. 最后在FOSRest配置里指定使用这个自定义控制器：

fos_rest:
    exception:
        controller: 'AppBundle\Controller\CustomExceptionController'

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