Dapper的结果缓冲指将查询结果一次性加载到内存，避免多次枚举时重复访问数据库或因连接关闭报错。默认buffered: true时结果被缓存，可安全多次遍历；设为false则延迟加载，仅支持一次枚举，否则可能抛出异常。处理大数据且单次遍历时可用buffered: false节省内存，否则应保持默认以确保安全性和易用性。
在C#中使用Dapper时，查询结果默认是延迟加载的，这意味着枚举结果（如遍历foreach）会触发数据库游标逐行读取。如果你多次枚举同一个查询结果，就会导致重复执行数据库操作或抛出异常（尤其是在连接已关闭的情况下）。为了避免这个问题，Dapper提供了结果缓冲（buffering）机制。
什么是结果缓冲？
结果缓冲是指将查询结果一次性加载到内存中，而不是按需逐行读取。这样你可以安全地多次枚举结果集，也不会因为数据库连接关闭而报错。
如何启用结果缓冲？
Dapper大多数查询方法（如Query、QueryAsync）都有一个名为 buffered 的参数，默认值为 true。当设置为 true 时，Dapper 会将所有结果缓存到内存中；若设为 false，则返回的是一个延迟执行的可枚举对象。
重点：确保你理解不同设置的影响。
示例：
using (var connection = new SqlConnection(connectionString)) { // 默认 buffered = true，结果被缓存 var users = connection.Query<User>("SELECT * FROM Users"); <pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">// 可以安全地多次遍历 foreach (var user in users) { /* 第一次遍历 */ } foreach (var user in users) { /* 第二次遍历 —— 安全 */ }
}
如果关闭缓冲：
using (var connection = new SqlConnection(connectionString)) { // buffered = false，延迟执行 var users = connection.Query<User>("SELECT * FROM Users", buffered: false); <pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">foreach (var user in users) { } // 正常 foreach (var user in users) { } // ❌ 错误！无法重新枚举，可能引发异常
}
为什么需要关注缓冲？
- 未缓冲的结果依赖于数据库连接保持打开状态。一旦连接关闭，再次枚举会失败。
- 未缓冲适合处理大量数据，节省内存，但只能枚举一次。
- 已缓冲允许重复访问，更符合常规集合行为，但会占用更多内存。
最佳实践建议
- 绝大多数场景下，使用默认的 buffered: true 即可。这是最安全、最直观的方式。
- 当你处理非常大的结果集且只遍历一次时，可考虑 buffered: false 来降低内存压力。
- 如果需要多次遍历结果，请务必确保启用了缓冲（即保持默认或显式设为 true）。
- 异步方法如 QueryAsync 同样支持 buffered 参数，逻辑一致。
基本上就这些。Dapper 的缓冲机制简单但关键，理解它能避免“序列已结束”这类常见异常。只要记得：想多次遍历？必须开启缓冲。默认就是开启的，除非你手动关了它。不复杂但容易忽略。