遇到“序列不包含任何元素”(
System.InvalidOperationException: Sequence contains no elements),通常是因为你用了
.Single()或
.SingleOrDefault()、
.First()、
.FirstOrDefault()等方法,但数据库没查到匹配数据,而方法语义又不允许空结果。
确认你用的是哪个方法
Dapper 本身不抛这个异常 —— 它是 LINQ 或 .NET 集合操作在内存中执行时抛的。常见场景是你查完数据后立刻链式调用:
connection.Query<user>(sql).Single(x => x.Id == 123)</user>→ 数据库返回空列表,
.Single()就炸了
connection.QueryFirstOrDefault<user>(sql, new { id = 123 })</user> 是安全的,但如果你后面又接了 .Value.Name(比如误当
Nullable<int></int>处理),也可能崩
优先改用更安全的查询方式
别在结果集上做内存级的
Single/
First,让 SQL 层控制“最多一条”: 用
QueryFirstOrDefault<t>()</t>替代
Query<t>().FirstOrDefault()</t>用
QuerySingleOrDefault<t>()</t>替代
Query<t>().SingleOrDefault()</t>SQL 里加
LIMIT 1(PostgreSQL/MySQL)或
TOP 1(SQL Server),配合
Query<t>()</t>拿单条
明确处理空结果的业务逻辑
别假设数据一定存在。例如查用户:
如果“查不到就报错”,用QuerySingleOrDefault+ 判空后 throw 自定义异常 如果“查不到就新建”,拿到 null 后直接 new 对象并 Insert 如果“查不到就返回默认值”,用
??或三元表达式兜底:
user ?? new User { Name = "未知" }
调试时快速定位问题
加个日志或断点,看 Dapper 实际执行的 SQL 和参数,再手动去数据库跑一遍:
用LogProvider(如 Serilog + DapperExtensions)或简单
Console.WriteLine(sql)确认 WHERE 条件是否写错(比如
WHERE Id = @id但传了
null或 0) 检查数据库是否有这条数据,大小写、软删除字段(
IsDeleted = 0)、租户 ID 是否过滤过严
基本上就这些。核心是:别把数据库查询和内存枚举混在一起做,让职责更清晰,异常就少一半。
