应优先使用QueryFirstOrDefault<T>()或QuerySingleOrDefault<T>()等Dapper原生安全方法替代Query<T>().First()等内存操作，避免空集合异常；同时需明确处理null结果，确保SQL层控制返回数量并验证查询条件与数据存在性。
遇到“序列不包含任何元素”（System.InvalidOperationException: Sequence contains no elements），通常是因为你用了 .Single() 或 .SingleOrDefault()、.First()、.FirstOrDefault() 等方法，但数据库没查到匹配数据，而方法语义又不允许空结果。
确认你用的是哪个方法
Dapper 本身不抛这个异常 —— 它是 LINQ 或 .NET 集合操作在内存中执行时抛的。常见场景是你查完数据后立刻链式调用：
-
connection.Query<User>(sql).Single(x => x.Id == 123)→ 数据库返回空列表，.Single()就炸了 -
connection.QueryFirstOrDefault<User>(sql, new { id = 123 })是安全的，但如果你后面又接了.Value.Name（比如误当Nullable<int>处理），也可能崩
优先改用更安全的查询方式
别在结果集上做内存级的 Single/First，让 SQL 层控制“最多一条”：
- 用
QueryFirstOrDefault<T>()替代Query<T>().FirstOrDefault() - 用
QuerySingleOrDefault<T>()替代Query<T>().SingleOrDefault() - SQL 里加
LIMIT 1（PostgreSQL/MySQL）或TOP 1（SQL Server），配合Query<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 是否过滤过严
基本上就这些。核心是：别把数据库查询和内存枚举混在一起做，让职责更清晰，异常就少一半。
