Symfony下Doctrine日期取模报错：SQL语法错误及年份显示异常排查

一、日期取模（MOD）的语法错误解决 #

你碰到的[Syntax Error] 预期 =, <, <=, <>, >, >=, !=，却得到 '%'错误，核心原因是Doctrine的DQL不支持直接用SQL的%运算符——DQL有自己独立的函数体系，得用它内置的MOD()函数来实现取模逻辑。

比如你要筛选年份为偶数的电影，正确的DQL写法应该是这样：

// 假设你的实体是Movie，releaseDate是日期字段
$query = $entityManager->createQuery('
    SELECT m
    FROM App\Entity\Movie m
    WHERE MOD(YEAR(m.releaseDate), 2) = 0
');
$movies = $query->getResult();

这里要注意两个关键细节：

• 先用YEAR()函数从日期字段中提取年份（Doctrine内置了这个日期处理函数）
• 再用MOD()函数对提取出的年份做取模运算，判断结果是否为0（即偶数）

如果你的场景是对日期的“日”或者“月”取模，只需要把YEAR()替换成DAY(m.releaseDate)或MONTH(m.releaseDate)就行。

二、第二段代码不显示年份的原因分析 #

你提到第一段代码正常、第二段不显示年份，大概率是以下几个常见问题导致的：

1. 查询中未选择年份字段
   如果第一段代码是查询整个实体对象，而第二段只查询了电影标题，没把年份相关数据包含进来，那自然拿不到年份。比如错误写法：

   // 只查标题，未包含年份数据
   $query = $entityManager->createQuery('
       SELECT m.title
       FROM App\Entity\Movie m
   ');
   

   正确的做法是把年份也加入SELECT语句：

   $query = $entityManager->createQuery('
       SELECT m.title, YEAR(m.releaseDate) AS releaseYear
       FROM App\Entity\Movie m
   ');
   // 查询结果里会包含releaseYear字段
   $movies = $query->getResult();
   

2. 模板中未正确输出年份
   就算查询里已经拿到了年份数据，如果模板里没有对应输出，也看不到结果。比如Twig模板里要匹配查询返回的字段名：

   {% for movie in movies %}
       <p>{{ movie.title }} - {{ movie.releaseYear }}</p>
   {% endfor %}
   

3. 实体属性或映射问题（概率较低）
   如果你的Movie实体里没有正确映射日期字段，或者没有对应的年份属性，也可能导致无法获取年份。不过这种情况第一段代码应该也会出问题，所以可能性相对小一些。

总结 #

• 日期取模要使用DQL内置的MOD()函数，配合YEAR/DAY/MONTH等日期提取函数实现
• 年份不显示先检查查询是否包含年份字段，再确认模板是否正确输出对应数据

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