SQL Server中IN参数超2100个时应改用临时表、分批查询或表值参数方案；首选临时表，因其稳定、易用且无需额外建模。
当IN查询参数超过2100个（SQL Server限制），Dapper原生语法 WHERE Id IN @Ids 会直接报错——这不是Dapper的缺陷，而是SQL Server底层协议（TDS）对单条命令参数数量的硬性约束。绕过它需要改变数据传递方式，而非拼接字符串。
用临时表替代IN子句
这是最稳定、可扩展性最强的方案，尤其适合一次性传入数千甚至上万个ID。
- 先创建本地临时表（
#temp_ids），结构简单，只含一列（如id INT或id UNIQUEIDENTIFIER） - 用
connection.Execute()批量插入ID（支持IEnumerable<int></int>直接传入） - 改写原查询为
JOIN #temp_ids或WHERE EXISTS (SELECT 1 FROM #temp_ids t WHERE t.id = main.id) - 临时表生命周期自动绑定连接，无需手动清理
分批执行IN查询
适用于ID集合可预知、且总数量在数万以内，逻辑简单、改动最小。
- 将大数组按每批 ≤ 2000 个切分（留余量防边界问题）
- 循环调用
Query<t>(sql, new { Ids = batch })</t> - 合并结果可用
Concat()或List<t>.AddRange()</t>，注意内存累积 - 若需去重或排序，建议在应用层统一处理，避免多次数据库排序
用EXISTS + 表值参数（TVF）或用户定义表类型（UDT）
SQL Server专属高级方案，性能接近原生JOIN，但需提前建模。
- 在数据库中定义表类型，例如：
CREATE TYPE dbo.IntList AS TABLE (Value INT) - C#中构造
DataTable，添加列并填充ID数据 - 用
new SqlServerTypes.StructuredUserDefinedTypeParameter(...)或 Dapper+SqlMapperExtensions 封装为参数 - SQL中写成：
WHERE EXISTS (SELECT 1 FROM @IdsTable t WHERE t.Value = main.Id) - 比临时表少一次往返，但部署和维护成本略高
不推荐的做法
这些看似“快捷”的方式实际隐患明显：
- 字符串拼接SQL：触发SQL注入、执行计划无法复用、易出语法错误
- 把IN改成OR链：SQL解析慢、计划缓存爆炸、超出最大表达式深度
- 盲目增大CommandTimeout：掩盖问题而非解决，可能拖垮连接池
基本上就这些。核心思路很明确：把“参数太多”这个问题，从“传参”转移到“数据落地”，让数据库自己做匹配。临时表方案上线快、兼容好，大多数业务场景首选它。
