咨询Dapper参数长度配置：SQL Server缓存计划因参数长度重复生成

这个问题在Dapper结合SQL Server的场景里挺常见的——核心原因是Dapper默认会根据传入字符串参数的实际长度来推断SQL参数的类型，这就导致不同长度的同逻辑查询生成了不同的执行计划，浪费缓存资源。针对你的需求，完全可以把参数长度固定为和表列匹配的nvarchar(256)，下面给你几种可行的方案：

1. 显式指定参数类型（最直接） #

Dapper提供了DbString类型，允许你手动指定字符串参数的长度、是否固定长度、是否为ANSI类型。每次传参时用它替代普通string，就能强制参数为nvarchar(256)：

var query = "SELECT * FROM YourTable WHERE YourColumn = @YourParam";
var param = new {
    YourParam = new DbString {
        Value = "你的参数值",
        Length = 256, // 和表列定义一致
        IsFixedLength = true,
        IsAnsi = false // 对应nvarchar，若为varchar则设为true
    }
};
var result = connection.Query<YourEntity>(query, param);

这种方式的好处是精准控制单个参数，适合只需要调整部分查询的场景。

2. 全局注册自定义类型处理器（一劳永逸） #

如果你的项目里大量查询都需要固定长度的nvarchar(256)参数，可以注册一个全局的类型处理器，让Dapper默认把string类型映射为nvarchar(256)：

public class StringToNVarChar256Handler : SqlMapper.TypeHandler<string>
{
    public override void SetValue(IDbDataParameter parameter, string value)
    {
        parameter.DbType = DbType.String;
        parameter.Size = 256;
        parameter.Value = value ?? DBNull.Value;
    }

    public override string Parse(object value)
    {
        return value?.ToString() ?? string.Empty;
    }
}

// 在项目启动时注册（比如Program.cs或Startup.cs）
SqlMapper.AddTypeHandler(new StringToNVarChar256Handler());

注册后，所有普通string参数都会被自动处理为nvarchar(256)，不用再手动写DbString。注意：如果有部分查询需要不同长度的参数，可以单独用DbString覆盖全局配置。

3. 数据库层面的辅助优化（可选） #

如果不想改动代码，也可以考虑在SQL Server数据库开启强制参数化（FORCED PARAMETERIZATION），让数据库自动把类似的查询参数化，减少执行计划数量：

ALTER DATABASE YourDatabase SET PARAMETERIZATION FORCED;

不过这个方案是全局生效的，可能会影响其他查询的执行计划生成策略，建议先在测试环境验证后再上线。

注意事项 #

• 确保业务数据的实际长度不超过256，否则会被截断（如果IsFixedLength=true）或者触发参数长度不匹配的错误。
• 如果表列是nvarchar(max)，不建议固定长度，还是用Dapper默认的动态长度更合理。

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