Symfony Entity Param Converter无法获取正确路由参数问题排查

问题根源 #

你当前的路由注解是分别独立查询分类和子分类，没有建立两者的关联逻辑，同时存在两个核心问题：

1. 子分类的slug可能不唯一（不同分类下可能有相同slug的子分类），仅靠subSlug查询会找不到对应数据；
2. Symfony的ParamConverter在参数绑定上出现混淆，导致两次查询误用了同一个参数值。

具体修复方案 #

方案1：关联父分类查询子分类（推荐） #

修改路由的Entity注解，让子分类的查询依赖已找到的分类对象，同时在子分类仓库中添加关联查询方法：

先更新控制器代码：

#[Route('/{slug}/{subSlug}', name: 'subcategory')]
#[Entity('category', expr: 'repository.findOneBySlug(slug)')]
// 通过分类+子分类slug联合查询，确保准确性
#[Entity('subcategory', expr: 'repository.findOneBySlugAndCategory(subSlug, category)')]
public function subcat(Category $category, Subcategory $subcategory): Response

然后在SubcategoryRepository中添加对应的查询方法：

// src/Repository/SubcategoryRepository.php
public function findOneBySlugAndCategory(string $slug, Category $category): ?Subcategory
{
    return $this->createQueryBuilder('s')
        ->where('s.slug = :slug')
        ->andWhere('s.category = :category')
        ->setParameters([
            'slug' => $slug,
            'category' => $category
        ])
        ->getQuery()
        ->getOneOrNullResult();
}

方案2：明确参数映射关系 #

如果不想自定义仓库方法，也可以通过options参数明确指定ParamConverter的映射规则，避免参数混淆：

#[Route('/{slug}/{subSlug}', name: 'subcategory')]
#[Entity('category', expr: 'repository.findOneBySlug(slug)')]
#[Entity('subcategory', class: Subcategory::class, options: [
    'mapping' => ['subSlug' => 'slug'],
    'exclude' => ['slug'] // 排除父分类的slug参数，防止误用
])]
public function subcat(Category $category, Subcategory $subcategory): Response

注意：这种方法要求子分类的slug字段全局唯一，否则仍可能出现查询错误。

方案3：检查基础数据与参数匹配 #

最后确认两点基础问题：

• 数据库中存在slug为mtg的分类，且该分类下有slug为dmr的子分类；
• 子分类实体的slug字段名称与查询方法中的参数一致，无拼写错误。

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