Hyperf中foreach遍历大数组爆内存，根本原因不是foreach语法，而是select()/get()已将全部数据一次性加载进内存；cursor()仅在单表查询、禁用缓冲、不调全量方法时才真正流式取数。
Hyperf里foreach遍历大数组为啥爆内存
不是
本身的问题，而是你遍历的“那个数组”根本不是逐行取的——它早被
或
一次性全加载进 PHP 内存了。Hyperf 的
或 Eloquent 的
默认返回完整集合对象，哪怕你后面用
，数据早已在内存里躺着。
常见错误现象：
—— 这里
已把几万条记录全塞进内存，
只是“读”，不“减”内存。
PHP 数组在 7.4+ 虽有写时复制优化，但
返回的是完整
，每个模型实例都带属性、关系、变更跟踪，开销远超原始数据
Hyperf 默认使用 PDO 缓冲查询（
），结果集一次性 fetch 全部，无法释放
即使只选两三个字段，ORM 层仍会构造完整模型对象，字段映射、类型转换、访问器等逻辑照常执行
Hyperf 的 cursor() 方法到底能不能省内存
能，但只在满足三个硬性条件时才生效：
必须是单表查询（无
、无
关联预加载）
不能调用任何触发全量加载的方法（如
、
、
、
）
必须直接
遍历，且循环体内不缓存整批结果（比如不往一个大数组里
）
正确写法：
错误写法：
注意：Hyperf 当前版本（v3.0+）的
底层依赖 PDO 的无缓冲模式（
）。若数据库连接配置没关缓冲，它会静默退化为每 1000 条一次的模拟分页，虽比全量好，但不是真正游标。
cursorPaginate() 和手动游标推进的区别
是封装好的分页响应，适合 HTTP 接口返回；而“手动游标推进”是纯服务端批处理逻辑，两者目的不同，别混用。
：返回
，含
参数（base64 编码），供前端翻页；它强制要求
，且只支持单字段排序；每次请求都重新查一次，不维持长连接
手动推进（如
）：你完全控制循环节奏、中断点、错误重试；必须确保
字段有索引且单调递增；适合 CLI 命令、队列任务等长时间运行场景
关键区别：前者是“响应式分页”，后者是“状态驱动迭代”。用错场景会导致重复处理或漏数据——比如在消息队列中用
，两次拉取之间新插入的数据可能被跳过
为什么关联查询下 cursor() 失效还很慢
Hyperf 的
在遇到
、
、
或子查询时，ORM 层会直接放弃游标逻辑，回退到
行为。这不是 bug，是设计使然：关联结果无法保证顺序稳定，也无法在服务端逐行流式返回。
典型陷阱：
→ 实际执行的是全量 JOIN 查询，内存占用可能是单表的 5–10 倍。
解决思路是“拆”：先用
拿主表 ID 流（
），再按批次（如每次 500 个 ID）查关联数据，用
避免在游标循环里做 N+1 查询（比如 foreach 中调
），这会让 DB 连接数暴涨、延迟飙升
如果必须强关联，考虑用原生 SQL + 游标变量（MySQL 8.0+ 支持
），绕过 ORM 层限制
真正决定内存是否暴增的，从来不是循环语法，而是数据何时、以何种结构进入 PHP 进程。游标有效性的边界，往往藏在 ORM 配置、查询构造方式和数据库驱动行为的交界处。
foreachselect()all()Db::table()->select()get()foreach$users = User::where('status', 1)->select('id', 'name')->get(); foreach ($users as $u) { ... }get()foreachget()CollectionPDO::MYSQL_ATTR_USE_BUFFERED_QUERY => truejoinwith()toArray()jsonSerialize()count()first()foreach[] = $rowforeach (User::where('status', 1)->cursor() as $user) { process($user); }$cursor = User::where('status', 1)->cursor(); $list = $cursor->all(); // 此刻已全量加载cursor()PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => falsecursorPaginate()cursorPaginate(100)LengthAwarePaginatornextCursororderBy('id')where('id', '>', $lastId)->limit(1000)->get()idcursorPaginate()cursor()with()join()groupBy()get()User::with('posts')->cursor()cursor()select('id')whereIn('user_id', $ids)$user->postsDECLARE cursor_name CURSOR FOR ...