PHP执行含大量IN值的SQL Server更新语句触发表达式服务限制错误

问题背景 #

PHP应用中执行以下UPDATE语句时触发错误：

UPDATE
users
SET
is_selected =
CASE WHEN
mrn_id IN (111028,117876,117877,117878,117879)
THEN
1
ELSE
0
END
WHERE
status_id = 396

实际查询中mrn_id IN包含约9000个数值，报错信息如下：

[DatabaseException] [Microsoft][ODBC Driver 17 for SQL Server][SQL Server]Internal error: An expression services limit has been reached. Please look for potentially complex expressions in your query, and try to simplify them.

根据SQL Server官方文档，该错误本应在IN子句值数量超过65000+时触发，但当前仅9000个值就报错，且在SQL Server Management Studio（SSMS）中执行完全正常。

触发原因 #

核心差异在于ODBC驱动与SSMS对IN子句的处理逻辑不同：

• SSMS执行时，SQL Server会直接将IN列表作为集合处理，表达式复杂度较低
• PHP使用ODBC驱动执行时，驱动可能会把IN列表转换为大量嵌套的OR条件（比如mrn_id=111028 OR mrn_id=117876 OR ...），9000个OR会导致表达式树的节点数超出SQL Server的表达式服务限制，从而触发错误。

调试步骤 #

• 捕获实际执行的SQL：通过SQL Server Profiler或Extended Events，记录PHP脚本执行时发送给数据库的真实SQL语句，对比SSMS执行的语句，确认驱动是否改写了IN子句
• 验证批次阈值：尝试减少IN子句中的值数量（比如先试1000个），如果不再报错，即可确认是表达式复杂度触发的限制
• 检查驱动配置：查看ODBC Driver 17 for SQL Server的版本和配置项，确认是否有查询优化相关的开关（比如是否强制参数化）

解决方法 #

1. 拆分批量更新 #

将9000个ID分成多个小批次（比如每1000个一组），执行多次UPDATE语句：

-- 第一批次
UPDATE users 
SET is_selected = 1 
WHERE status_id = 396 AND mrn_id IN (111028,117876,...); -- 1000个ID
-- 第二批次
UPDATE users 
SET is_selected = 1 
WHERE status_id = 396 AND mrn_id IN (...); -- 下一组1000个ID
-- 最后统一设置未选中的为0
UPDATE users 
SET is_selected = 0 
WHERE status_id = 396 AND is_selected IS NULL;

2. 使用临时表关联更新 #

先将所有ID插入临时表，再通过JOIN执行更新，避免大量IN值的问题：

-- 创建临时表
CREATE TABLE #TempMRN (mrn_id INT PRIMARY KEY);
-- 批量插入所有需要选中的ID（PHP中可通过批量插入语句实现）
INSERT INTO #TempMRN VALUES (111028), (117876), (...);
-- 更新选中状态
UPDATE u
SET is_selected = 1
FROM users u
JOIN #TempMRN t ON u.mrn_id = t.mrn_id
WHERE u.status_id = 396;
-- 更新未选中的状态
UPDATE u
SET is_selected = 0
FROM users u
WHERE u.status_id = 396 
AND NOT EXISTS (SELECT 1 FROM #TempMRN t WHERE t.mrn_id = u.mrn_id);
-- 删除临时表
DROP TABLE #TempMRN;

3. 使用表值参数（TVP） #

如果PHP支持，可通过SQL Server的表值参数传递ID列表，驱动会直接将集合传递给数据库，不会生成大量OR条件：

• 先在SQL Server中创建自定义表类型：

CREATE TYPE dbo.MRNList AS TABLE (mrn_id INT);

• 在PHP中构造表值参数并执行更新：

// 示例代码（需适配PHP的SQL Server扩展）
$tvp = array();
foreach ($mrnIds as $id) {
    $tvp[] = array('mrn_id' => $id);
}
$stmt = $conn->prepare("
    UPDATE u
    SET is_selected = CASE WHEN EXISTS(SELECT 1 FROM ? t WHERE t.mrn_id = u.mrn_id) THEN 1 ELSE 0 END
    FROM users u
    WHERE u.status_id = 396
");
$stmt->bindParam(1, $tvp, SQLSRV_PARAM_TABLE, null, array('SQLSRV_SQLTYPE_INT'));
$stmt->execute();

是否需要修改SQL Server设置？ #

不需要。该错误是查询结构复杂度导致的，并非服务器配置不足。SQL Server的表达式服务限制是为了防止查询过度消耗资源，修改相关配置可能引发性能问题或稳定性风险，官方也不建议调整该限制，优先通过优化查询逻辑解决。

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