Symfony 5.4 LTS更新后路由可选参数失效，提示缺少必填参数type

问题原因 #

Symfony 5.4子版本更新后，路由可选参数的处理逻辑变得更严格——仅在控制器方法中给参数设置默认值（如$type=null），不再会自动将路由参数标记为可选，必须在路由注解中明确声明参数的默认值，否则路由会将{type}视为必填参数。

解决方案1：在路由注解中添加默认值声明 #

修改控制器的路由注解，通过defaults选项明确指定type的默认值为null，让路由识别该参数为可选：

/** 
 * @Route("/new/{type}", name="app_support_case_new", defaults={"type" = null}, methods={"GET", "POST"}) 
 */
public function new(?string $type = null)
{
    // 原有业务逻辑
}

修改后，模板中{{ path('app_support_case_new') }}即可正常生成不带type参数的URL。

解决方案2：拆分路由（按需选择） #

如果需要同时支持/new和/new/{type}两种URL结构，可以定义两个路由指向同一个控制器方法：

/**
 * @Route("/new", name="app_support_case_new", methods={"GET", "POST"})
 * @Route("/new/{type}", name="app_support_case_new_with_type", methods={"GET", "POST"})
 */
public function new(?string $type = null)
{
    // 原有业务逻辑
}

• 生成不带type的URL时使用：{{ path('app_support_case_new') }}
• 生成带type的URL时使用：{{ path('app_support_case_new_with_type', {'type': 'your-type-value'}) }}

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