Dapper查询时遇到“序列不包含任何元素”怎么办 Dapper异常处理

应优先使用QueryFirstOrDefault()或QuerySingleOrDefault()等Dapper原生安全方法替代Query().First()等内存操作，避免空集合异常；同时需明确处理null结果，确保SQL层控制返回数量并验证查询条件与数据存在性。

遇到“序列不包含任何元素”（System.InvalidOperationException: Sequence contains no elements），通常是因为你用了 .Single() 或 .SingleOrDefault()、.First()、.FirstOrDefault() 等方法，但数据库没查到匹配数据，而方法语义又不允许空结果。

确认你用的是哪个方法

Dapper 本身不抛这个异常 —— 它是 LINQ 或 .NET 集合操作在内存中执行时抛的。常见场景是你查完数据后立刻链式调用：

• connection.Query(sql).Single(x => x.Id == 123) → 数据库返回空列表，.Single() 就炸了
• connection.QueryFirstOrDefault(sql, new { id = 123 }) 是安全的，但如果你后面又接了 .Value.Name（比如误当 Nullable 处理），也可能崩

优先改用更安全的查询方式

别在结果集上做内存级的 Single/First，让 SQL 层控制“最多一条”：

• 用 QueryFirstOrDefault() 替代 Query().FirstOrDefault()
• 用 QuerySingleOrDefault() 替代 Query().SingleOrDefault()
• SQL 里加 LIMIT 1（PostgreSQL/MySQL）或 TOP 1（SQL Server），配合 Query() 拿单条

明确处理空结果的业务逻辑

别假设数据一定存在。例如查用户：

• 如果“查不到就报错”，用 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 是否过滤过严

基本上就这些。核心是：别把数据库查询和内存枚举混在一起做，让职责更清晰，异常就少一半。