升级PHP 8后API Platform 2.6自定义HTTP缓存头失效问题

我在Symfony应用中使用Varnish缓存API Platform端点，当前API Platform版本为2.6。升级至PHP 8后，API Platform端点配置中的cache_headers选项不再生效。

端点配置详情 #

collectionOperations:
    voucher_list:
        method: GET
        cache_headers:
            max_age: 3600
            shared_max_age: 3600
        path: /account/{account_id}/vouchers
        requirements:
            account_id: '\d+'
        normalization_context:
            groups: ['voucher_list:read']

该配置在PHP 7.4环境下可正常生成对应Cache-Control响应头，但现在此端点返回的Cache-Control值为no-cache。只有在api_platform.yaml中设置全局HTTP缓存配置时，Cache-Control才会生效：

http_cache:
    max_age: 3600
    shared_max_age: 3600
    vary: ['Accept']
    public: true

问题排查与解决办法 #

• PHP 8类型兼容性问题：API Platform 2.6发布时PHP 8尚未正式推出，框架对cache_headers的解析逻辑可能因PHP 8的严格类型检查出现异常，导致端点级配置被忽略， fallback 到默认的no-cache策略。
• 检查HTTP缓存监听器：确认ApiPlatform\Core\EventListener\HttpCacheListener已正确加载并执行。可通过Symfony调试工具栏查看事件监听器顺序，确保该监听器在响应序列化前运行，保证缓存头能被正确设置。
• 临时手动设置缓存头：如果端点级配置暂时无法生效，可通过自定义事件订阅器或控制器手动注入缓存头：

// 自定义事件订阅器示例
use Symfony\Component\HttpKernel\Event\ResponseEvent;
use Your\Namespace\Voucher;

class VoucherCacheHeaderSubscriber
{
    public function onKernelResponse(ResponseEvent $event): void
    {
        $request = $event->getRequest();
        $resourceClass = $request->attributes->get('_api_resource_class');
        $operationName = $request->attributes->get('_api_collection_operation_name');
        
        if ($resourceClass === Voucher::class && $operationName === 'voucher_list') {
            $response = $event->getResponse();
            $response->headers->set('Cache-Control', 'public, max-age=3600, s-maxage=3600');
        }
    }
}

• 升级API Platform小版本：API Platform 2.6分支的后续更新可能修复了PHP 8兼容性问题，尝试升级到2.6.x的最新版本（如2.6.18及以上），查看官方更新日志确认是否包含缓存配置相关的修复。

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