TYPO3 QueryBuilder中getRestrictions->removeByType失效问题

核心问题根源 #

所有操作失效、类找不到的报错，本质都是同一个原因：短类名没有引入对应的核心类全限定命名空间

• 你在代码里直接写的HiddenRestriction、DeletedRestriction都是没有命名空间前缀的短类名。PHP解析类名时，会自动按照当前文件的命名空间路径做拼接——你的扩展代码位于MyExt\UF命名空间下，解释器就会优先去当前命名空间路径下查找这两个类，完全找不到系统核心内置的限制类。
• 这也是为什么removeByType(HiddenRestriction::class)没有任何效果：此时代码里传入的类标识实际是MyExt\UF\HiddenRestriction（不存在的类），而查询构建器限制栈里存的是核心命名空间下的TYPO3\CMS\Core\Database\Restriction\HiddenRestriction实例，两者类名完全不匹配，removeByType自然找不到要移除的目标限制，等于执行了无效操作。
• 同样的问题出现在手动添加DeletedRestriction的代码里，因为类名解析错误，直接触发类不存在的报错。

正确修复方式 #

1. 在PHP文件顶部引入对应核心类的全限定命名空间，和其他依赖类的引入逻辑保持一致：

   // 必须引入的核心类路径
   use TYPO3\CMS\Core\Database\ConnectionPool;
   use TYPO3\CMS\Core\Database\Restriction\HiddenRestriction;
   use TYPO3\CMS\Core\Database\Restriction\DeletedRestriction;
   

2. 引入完成后，两种官方推荐的查询写法都可以正常生效：
   • 精准移除隐藏页过滤，保留其他所有默认规则（软删除过滤、前端发布时间过滤等）：

     $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)->getQueryBuilderForTable('pages');
     // 此时类名匹配正确，可以准确移除HiddenRestriction限制
     $queryBuilder->getRestrictions()->removeByType(HiddenRestriction::class);
     
     // 使用参数绑定拼接查询条件，避免SQL注入风险
     $result = $queryBuilder->select('uid')
         ->from('pages')
         ->where(
             $queryBuilder->expr()->eq('slug', $queryBuilder->createNamedParameter($slug))
         )
         ->executeQuery();
     

   • 清空所有限制后，仅手动保留软删除过滤规则，同样可以拿到包含隐藏页、但排除已删除记录的结果：

     $queryBuilder->getRestrictions()
         ->removeAll()
         ->add(GeneralUtility::makeInstance(DeletedRestriction::class));
     

额外注意事项 #

• 不要直接拼接字符串"slug='" . $slug . "'"写入查询条件，这种写法存在明确的SQL注入风险，必须使用查询构建器提供的参数绑定方法传递用户输入值。
• 两种写法没有本质优劣，前者会自动保留前端时间戳、站点语言等其他默认过滤规则，后者需要手动补充所有需要保留的过滤规则，可根据实际业务场景选择。

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