升级dblib为pdo_sqlsrv后，Laravel Eloquent查询性能骤降

以下是几个经过验证的可行方案，按优先级排序：

1. 针对Laravel配置强制启用服务器端游标 #

Laravel默认没有暴露服务器端游标设置，但可以通过数据库连接选项或自定义逻辑实现：

全局配置（适合所有复杂查询） #

修改config/database.php中的sqlsrv连接配置，添加PDO优化选项：

'sqlsrv' => [
    'driver' => 'sqlsrv',
    // ... 其他基础配置（host、database等）
    'options' => [
        // 启用服务器端游标，避免客户端内存加载大结果集
        PDO::SQLSRV_ATTR_CURSOR_TYPE => PDO::SQLSRV_CURSOR_SERVER_SIDE,
        // 关闭模拟预编译，使用SQL Server原生预编译逻辑
        PDO::ATTR_EMULATE_PREPARES => false,
        // 启用直接查询，减少客户端与服务器的交互次数
        PDO::SQLSRV_ATTR_DIRECT_QUERY => true,
        // 编码对齐原FreeTDS配置
        PDO::SQLSRV_ATTR_ENCODING => PDO::SQLSRV_ENCODING_UTF8,
    ],
],

针对特定查询启用（避免影响小查询） #

在AppServiceProvider的boot方法中监听查询事件，仅对复杂查询启用服务器端游标：

use Illuminate\Support\Facades\DB;
use PDO;

public function boot()
{
    DB::listen(function ($query) {
        // 根据业务场景调整判断条件，比如包含JOIN或多表关联的查询
        if (str_contains(strtolower($query->sql), 'join') || str_contains(strtolower($query->sql), 'where in')) {
            $query->connection->getPdo()->setAttribute(PDO::SQLSRV_ATTR_CURSOR_TYPE, PDO::SQLSRV_CURSOR_SERVER_SIDE);
        }
    });
}

2. 优化Laravel预加载逻辑 #

多关联预加载会触发多次数据库查询，改用手动JOIN合并为单查询，减少与SQL Server的交互次数：

// 替代原Model::with(['rel1', 'rel2'])->get()写法
$results = Model::select('models.*', 'rel1_table.*', 'rel2_table.*')
    ->join('rel1_table', 'models.id', '=', 'rel1_table.model_id')
    ->join('rel2_table', 'models.id', '=', 'rel2_table.model_id')
    ->distinct() // 处理一对多关联导致的重复数据
    ->get();

3. 对齐原FreeTDS的连接参数 #

检查原FreeTDS配置（如freetds.conf）中的参数，确保pdo_sqlsrv配置与之匹配：

• 在php.ini中设置sqlsrv.ClientBufferMaxKBSize = 102400，增大客户端缓冲区，减少数据分段读取
• 确认SQL Server数据库的排序规则与驱动编码一致，避免额外的字符转换开销

4. 自定义SQL Server连接类 #

如果全局配置无效，可重写Laravel的SQL Server连接类，强制为所有查询设置服务器端游标：

1. 创建自定义连接类app/Database/SqlServerConnection.php：

<?php

namespace App\Database;

use Illuminate\Database\SqlServerConnection as BaseConnection;
use PDO;

class SqlServerConnection extends BaseConnection
{
    protected function prepare($query)
    {
        $statement = parent::prepare($query);
        $statement->setAttribute(PDO::SQLSRV_ATTR_CURSOR_TYPE, PDO::SQLSRV_CURSOR_SERVER_SIDE);
        return $statement;
    }
}

2. 在AppServiceProvider的register方法中注册自定义连接：

use Illuminate\Database\DatabaseManager;
use App\Database\SqlServerConnection;

public function register()
{
    $this->app->extend('db.connection.sqlsrv', function ($connection, $app) {
        return new SqlServerConnection(
            $connection->getPdo(),
            $connection->getDatabaseName(),
            $connection->getTablePrefix(),
            $connection->getConfig()
        );
    });
}

5. 检查SQL Server查询计划 #

使用SQL Server的SET SHOWPLAN_XML ON对比升级前后的查询计划，确认是否存在索引失效、执行计划变更的情况：

• 若发现索引未被正确使用，可在查询中强制指定索引（WITH (INDEX(索引名))）
• 优化复杂查询的SQL结构，减少冗余子查询或关联逻辑

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