Symfony 6中为非映射ChoiceType表单字段设置默认值异常

核心问题 #

浏览器缓存了页面内容，导致服务端根据Cookie生成的表单默认值无法及时生效；另外如果是GET请求提交表单，URL中的查询参数会优先覆盖你设置的data属性值，也会出现默认值不更新的情况。

解决方案1：添加响应缓存控制头（优先推荐） #

在控制器返回响应时，添加禁止浏览器缓存的HTTP头，强制浏览器每次都从服务端获取最新页面：

// 生成表单视图后准备响应
$response = $this->render('你的模板路径.html.twig', [
    'advancedSearchform' => $advancedSearchform->createView(),
]);

// 设置缓存控制头，禁止缓存
$response->headers->add([
    'Cache-Control' => 'no-cache, no-store, must-revalidate',
    'Pragma' => 'no-cache',
    'Expires' => '0'
]);

return $response;

解决方案2：调整表单请求处理逻辑 #

如果你的搜索表单使用GET请求提交，URL中会保留queryOrder参数，浏览器再次访问时可能复用该URL（或缓存页面），导致默认值被旧参数覆盖。可以调整控制器逻辑，区分首次加载和表单提交场景：

use Symfony\Component\HttpFoundation\Cookie;

// 初始化默认值
$indexOrder = 'date-last';

// 判断是否为表单提交请求（存在queryOrder参数）
if ($request->query->has('queryOrder')) {
    $indexOrder = $request->query->get('queryOrder');
    // 更新Cookie为最新选择的排序值
    $response = $this->render('你的模板路径.html.twig', [
        'advancedSearchform' => $advancedSearchform->createView(),
    ]);
    $response->headers->setCookie(Cookie::create(
        'clientfile-order', 
        $indexOrder, 
        new \DateTime('+1 month'), // Cookie有效期，可按需调整
        '/', // 作用路径
        null, 
        false, 
        true // 开启HttpOnly，提升安全性
    ));
    return $response;
} else {
    // 首次加载页面，从Cookie读取默认值
    $indexOrder = $request->cookies->get('clientfile-order') ?? 'date-last';
}

// 创建表单并绑定请求
$advancedSearchform = $this->createForm(ClientFileSearchType::class, null, ['index_order' => $indexOrder]);
$advancedSearchform->handleRequest($request);

// 非提交场景直接返回页面
return $this->render('你的模板路径.html.twig', [
    'advancedSearchform' => $advancedSearchform->createView(),
]);

额外注意点 #

• 不要依赖empty_data：empty_data仅在表单字段没有任何输入值时生效，而浏览器缓存的旧值或URL参数会被视为有效输入，所以用data设置默认值是正确的，但需要确保没有其他逻辑覆盖它。
• 检查handleRequest的时机：如果在创建表单后立即调用handleRequest，当请求中存在queryOrder参数时，会自动覆盖你设置的data值，这也是默认值不更新的常见原因，所以要先处理参数和Cookie的逻辑，再创建表单。

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