如何修复Symfony中对象小写引入导致的类名大小写不匹配错误

问题根源 #

出现Case mismatch between loaded and declared class names: "App\Entity\program" vs "App\Entity\Program"错误，核心原因是路由占位符与控制器方法参数名不匹配，导致Symfony参数转换器错误地尝试加载小写的program实体类，而实际实体类是大写开头的Program。

具体修复步骤 #

1. 修正控制器参数与路由占位符的对应关系 #

修改ProgramController.php中的方法参数和路由占位符，确保名称一致（遵循PHP小写开头的变量命名规范），同时修正类定义的语法错误：

namespace App\Controller;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use App\Repository\ProgramRepository;
use Symfony\Component\Routing\Annotation\Route;
use App\Entity\Program;
use App\Entity\Season;
use App\Entity\Episode;

#[Route('/program', name: 'program_')]
class ProgramController extends AbstractController // 修正：Class改为小写class，符合PHP语法规范
{
    // 修正showSeason：路由占位符改为{program}，参数名统一为$program
    #[Route('{program}/seasons/{season}', name: 'season_show')]
    public function showSeason(Program $program, Season $season): Response
    {
        $episodes = $season->getEpisodes();
                
        return $this->render('program/season_show.html.twig', [
            'program' => $program, // 变量名统一小写开头
            'season' => $season,
            'episodes' => $episodes
        ]);
    }

    // 修正showEpisode：参数名改为$program，与路由占位符{program}对应
    #[Route('{program}/seasons/{season}/episode/{episode}', name: 'episode_show')]
    public function showEpisode(Program $program, Season $season, Episode $episode): Response
    {
        return $this->render('program/episode_show.html.twig',[
            'program' => $program, // 变量名统一小写开头
            'season' => $season,
            'episode' => $episode
        ]);
    }
}

2. 修正Twig模板中的变量与属性引用 #

确保模板变量名与控制器传入的一致，同时修正实体属性的大小写：

{% extends 'base.html.twig' %}

{% block title %}Série {{ program.title }}, saison {{ season.number }}{% endblock %}

{% block body %}
    <div class="media">
        <img class="align-self-start mr-3" src="{{ program.poster }}" alt="{{ program.title }} poster">
        <div class="media-body">
            <h1 class="mt-0">{{ program.title }} saison {{ season.number }}</h1>
            <p>{{ program.synopsis }}</p>
            <p>Catégorie : {{ program.category.name }}</p> <!-- 修正：Category改为category，匹配实体属性的getCategory()方法 -->
            <p>Saison : {{ season.number }}</p>
        </div>
    </div>  

    <!-- 可选：添加跳转到单集的链接 -->
    {% for episode in episodes %}
        <a href="{{ path('program_episode_show', {program: program, season: season, episode: episode}) }}">
            {{ episode.title }}
        </a>
    {% endfor %}

    <a href="{{ path('program_index') }}">
        Retour à la liste des programmes
    </a>
{% endblock %}

3. 清理Symfony缓存 #

执行命令清理缓存，确保所有配置变更生效：

php bin/console cache:clear

额外注意事项 #

• PHP类名严格遵循大驼峰命名（如Program），变量名遵循小驼峰命名（如$program）
• 实体类的属性名和对应的getter/setter保持一致（比如category对应getCategory()，Twig中访问用program.category）
• 路由占位符名称必须与控制器方法参数名完全匹配，Symfony参数转换器会根据参数名自动匹配对应实体类

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