PHP 8.1 中定义空数组 $arr = []; 或 array() 完全合法，绝不会直接报错；所谓“报错”实为 Fiber 协程中变量生命周期、作用域误用或旧版协程库缺陷导致的假象。
PHP 8.1 中写 $arr = []; 或 $data = array(); 本身完全合法，**绝不会直接报错**。所谓“定义空数组报错”，几乎全是误判——真实问题出在 Fiber 协程上下文里对变量生命周期、作用域或状态管理的误解。
别被堆栈误导：空数组只是“路过”报错现场
常见假象：
- Fiber 内部写了
$cache = [];，紧接着调用Fiber::suspend()，之后外部错误地resume()一个已结束的 Fiber → 抛出FiberError: attempted on a terminated fiber，而错误堆栈刚好停在数组赋值行； - 把主线程的空数组传进 Fiber，期望修改后主线程能立刻看到 —— 实际上 Fiber 是独立执行栈，传引用也只是快照，不是双向绑定；
- 旧版协程库（如 Amp v2 或 PHP 8.1.0–8.1.2 的某些构建）因
Fiber::suspend方法导出缺陷，误判 Fiber 不可用，降级失败时抛异常，堆栈中夹带数组初始化语句。
Fiber 中变量不共享，是隔离的
Fiber 默认不共享变量，哪怕你传的是引用：
-
✅ 正确做法：用
Amp\Sync\Channel、Swoole\Table、Redis或WeakMap（关联 Fiber ID）做显式通信； -
❌ 错误假设：在主线程定义
$shared = [];，传给 Fiber 后执行$shared[] = 'x';，就以为主线程能读到新元素 —— 这不会发生； -
⚠️ 注意：PHP 8.4 才引入
FiberLocal，8.1 没有该机制，不能依赖“自动隔离存储”。
三步快速定位真实原因
别盯着数组看，先查 Fiber 状态和调用链：
立即学习“PHP免费学习笔记（深入）”；
- 检查报错是否为
FiberError，消息含terminated fiber或not suspended→ 说明你在 resume 一个已结束、未挂起或从未启动的 Fiber； - 在关键节点加诊断：
var_dump($fiber->isStarted(), $fiber->isSuspended(), $fiber->isTerminated());； - 确认是否用了不兼容的协程库版本（如 amp v2 / swoole/ide-helper < 4.9），它们可能因硬写
"ext-fiber": "^1.0"导致 Composer 误判或运行时检测失败。
变量作用域排查要点
协程场景下，变量作用域错误更隐蔽：
- 函数内访问全局变量？必须用
global $var或$GLOBALS['var']，Fiber 不改变这一规则； - 条件分支中漏赋值？比如
if ($cond) { $result = []; }后直接用$result→ 触发Undefined variableNotice； - 大小写拼错？
$Cache和$cache是两个变量，Fiber 内外都适用这条； - 建议开发期开启
error_reporting(E_ALL)，并用get_defined_vars()快速核对当前作用域变量名与值。
