API Platform对接SQL Server 2014的分页功能异常问题咨询

我之前也踩过这个坑！SQL Server 2014本身是支持OFFSET/FETCH分页语法的，但Doctrine默认可能没识别对数据库平台，导致生成了不兼容的SQL，才会抛出那个错误。不用急着写自定义CTE，我们可以通过配置让API Platform的核心分页功能正常工作，还能保住ApiFilter这些便利特性：

1. 配置Doctrine识别正确的SQL Server平台 #

问题根源往往是Doctrine把SQL Server 2014识别成了旧版的MSSQL平台（不支持OFFSET），我们需要明确指定数据库版本或者平台类：

在你的Symfony项目的config/packages/doctrine.yaml里，修改DBAL配置：

doctrine:
    dbal:
        driver: pdo_sqlsrv  # 确保用的是pdo_sqlsrv驱动，不是旧的mssql驱动
        host: '%env(DATABASE_HOST)%'
        port: '%env(DATABASE_PORT)%'
        dbname: '%env(DATABASE_NAME)%'
        user: '%env(DATABASE_USER)%'
        password: '%env(DATABASE_PASSWORD)%'
        charset: UTF8
        server_version: '2014'  # 明确指定SQL Server版本
        # 如果server_version识别有问题，直接指定平台类
        # platform_class: Doctrine\DBAL\Platforms\SQLServer2012Platform

配置后，Doctrine会生成SQL Server 2014支持的OFFSET ... FETCH NEXT ... ROWS ONLY语法，和API Platform的默认分页逻辑完美兼容，你之前配置的ApiFilter、排序这些功能都能正常使用。

2. 升级Doctrine DBAL到稳定版 #

如果上面的配置没生效，可能是你用的Doctrine DBAL版本太老，对SQL Server 2014的支持不完善。建议升级到最新的稳定版本（比如3.x系列），新版本对SQL Server的平台识别和语法生成更准确。

运行Composer命令升级：

composer require doctrine/dbal:^3.6

（版本号可以根据实际情况调整，以Composer推荐的稳定版为准）

验证效果 #

配置完成后，再次请求分页接口（比如GET /your-resource?page=2），应该就能正常返回第二页数据了，而且所有API Platform的默认功能都能保留，不用写自定义SQL或者CTE。

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