Symfony切换至生产环境（DEBUG=0）出现Knp分页器废弃错误求助

问题描述 #

将.env文件中DEBUG设置为0切换到生产环境时，出现如下错误：

环境信息：

• Symfony版本：5.3.16
• PHP版本：8.1.3
• knplabs/knp-paginator-bundle版本：v5.8.0

解决步骤 #

1. 验证KnpPaginator模板配置
   打开config/packages/knp_paginator.yaml，确认模板路径配置正确，示例配置如下：

   knp_paginator:
       template:
           pagination: '@KnpPaginator/Pagination/bootstrap_v5_pagination.html.twig'
           sortable: '@KnpPaginator/Pagination/sortable_link.html.twig'
           filtration: '@KnpPaginator/Pagination/filtration.html.twig'
   

   若使用自定义模板，确保文件存在于对应路径，且生产环境下能被Twig正确加载。

2. 清理并预热生产环境缓存
   执行以下命令彻底刷新缓存：

   php bin/console cache:clear --env=prod
   php bin/console cache:warmup --env=prod
   

   生产环境的编译缓存可能留存旧的模板路径，清理后重新生成可解决此类加载异常。

3. 检查PHP intl扩展状态
   KnpPaginatorBundle依赖intl扩展，生产环境若未启用会触发错误。执行php -m查看扩展列表，确认intl存在；若缺失，需在PHP配置中启用该扩展并重启服务。

4. 升级KnpPaginatorBundle版本
   v5.8.0与Symfony5.3.16、PHP8.1.3可能存在兼容性问题，尝试升级至兼容版本：

   composer require knplabs/knp-paginator-bundle:^5.11
   

   升级完成后重新清理生产环境缓存。

5. 排查Twig严格变量设置
   生产环境下Twig默认启用strict_variables: true，若模板存在未定义变量会直接报错。可临时修改config/packages/prod/twig.yaml：

   twig:
       strict_variables: false
   

   重新部署后查看错误是否消失，定位到具体未定义变量后再恢复严格模式。

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