Symfony 6.2.7生产环境控制器返回空白页无报错求助

核心问题分析 #

本地环境正常、生产环境点击链接空白，大概率是代码逻辑错误或服务器配置导致的致命错误，且生产环境关闭了错误输出。结合代码来看，存在两个明显的逻辑问题，同时需要配合服务器层面的排查。

排查思路 #

• 查看服务器错误日志：生产环境空白页基本是PHP致命错误导致，直接查看Apache的error.log（通常路径/var/log/apache2/error.log）、PHP错误日志（可在php.ini中查找error_log配置），或Symfony的var/log/prod.log，里面会记录具体报错信息。
• 验证URL参数传递：在生产环境页面右键查看源代码，对比本地与生产环境的链接URL，确认route和route_params参数是否正确生成，尤其是route_params数组是否被正确序列化传递。
• 检查响应发送逻辑：代码中手动调用$response->send()再返回重定向，会导致重复发送响应头，本地环境可能因输出缓冲掩盖问题，生产环境服务器配置更严格会直接引发错误。
• 校验路由参数传递：原代码将route_params作为单个参数传入redirectToRoute，而非展开原路由参数数组，会导致目标路由参数不匹配，触发异常但生产环境不显示。

解决方案 #

1. 修复控制器核心逻辑 #

移除手动发送响应的代码，正确传递路由参数，并添加基础校验：

/**
 * @Route("{_locale}/accept_cookies", name="cookie_banner_accept_cookies", requirements={"_locale"="%locales_requirements%"})
 */
public function acceptCookies(Request $request)
{
    $route = $request->query->get('route');
    // 默认空数组避免参数缺失报错
    $routeParams = $request->query->get('route_params', []);

    // 校验路由是否存在，避免无效路由跳转
    if (!$route || !$this->get('router')->getRouteCollection()->get($route)) {
        return $this->redirectToRoute('homepage'); // 替换为你的默认路由
    }

    // 使用DateTime创建Cookie过期时间，避免时区问题
    $cookieConsent = Cookie::create(
        'vertice_cookies_consent',
        'accepted',
        new \DateTime('+365 days')
    );

    // 创建重定向响应并设置Cookie，由Symfony统一处理响应发送
    $response = $this->redirectToRoute($route, $routeParams);
    $response->headers->setCookie($cookieConsent);

    return $response;
}

2. 优化Twig链接参数传递 #

给route_params添加默认空数组，避免参数不存在时生成异常URL：

<a href="{{ path('cookie_banner_accept_cookies', {'route' : app.request.attributes.get('_route'), 'route_params' : app.request.attributes.get('_route_params', {})}) }}" class="btn btn-success ms-3">
    {{ 'cookiesConsent.accept'|trans }}
</a>

3. 临时开启生产环境错误输出（调试用） #

在public/index.php中临时添加以下代码，查看具体报错后立即移除：

ini_set('display_errors', 1);
error_reporting(E_ALL);

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