Yii2中json_encode报错主因是循环引用或残留资源句柄；需检查关联闭环、限定toArray字段、排查资源类型，并推荐用Json::encode及显式字段控制。
Yii2 中对象转数组后 json_encode 报错，常见原因确实是循环引用（如模型关联关系形成闭环）或残留资源句柄（如未关闭的 PDOStatement、文件句柄、cURL 句柄等）。这类问题不会在 toArray() 阶段暴露，而是在 json_encode 时触发 Recursion detected 或 Type is not supported 错误。
检查模型关联是否构成循环引用
Yii2 的 ActiveRecord::toArray() 默认会递归展开 hasMany / hasOne 关联。如果 A → B → A（比如 User ↔ Profile ↔ User），就极易触发循环引用。
- 用
var_dump($model->toArray(['id', 'name']))限定字段，排除关联属性，看是否还报错 —— 若不报错，说明问题出在关联里 - 逐个注释掉
getXXX()关系方法，再试toArray()+json_encode，定位哪个关系引入了闭环 - 检查是否在关联定义中错误地设置了双向 eager loading（如
with(['profile', 'profile.user'])），即使没调用，某些序列化逻辑也可能提前触发
排查残留资源句柄（Resource）
资源类型（resource）无法被 json_encode，常见于：自定义行为（Behavior）中未释放的 cURL 句柄、日志组件里挂载的 stream、AR 模型中手动赋值的 fopen() 返回值、或扩展中缓存的 PDOStatement。
- 在
toArray()后加一行：array_walk_recursive($arr, function($v) { if (is_resource($v)) { echo get_resource_type($v); } });，快速发现资源类型 - 检查模型或其行为中是否在
init()、afterFind()等生命周期里打开了资源但未清理 - 避免在 AR 属性中直接赋值资源（例如
$model->fileHandle = fopen(...)），这类字段应设为private或使用extraFields()显式控制，不在toArray()中暴露
安全导出 JSON 的推荐做法
不要依赖裸调 json_encode($model->toArray())，尤其在不确定模型结构时。
- 用
Json::encode()（yii\helpers\Json）替代原生json_encode，它内置了对资源和循环的防御处理（抛出更明确异常，支持$options控制） - 显式声明要导出的字段：
$model->toArray(['id', 'name', 'status'], ['profile' => ['name', 'avatar']])，跳过可疑关联 - 重写模型的
fields()和extraFields()，把可能出问题的字段（如含资源或深层关联的）移出默认字段集 - 如需深度控制，用
ArrayHelper::toArray()并设置'recursive' => false，再手动拼装关键数据
调试小技巧：快速定位源头
在控制器或调试位置插入以下代码：
$model->toArray(); // 先确保能跑通
$arr = $model->toArray();
$it = new \RecursiveIteratorIterator(new \RecursiveArrayIterator($arr));
foreach ($it as $key => $val) {
if (is_object($val) && get_class($val) === get_class($model)) {
echo "⚠️ 发现同类型对象嵌套：{$key}\n";
}
if (is_resource($val)) {
echo "⚠️ 发现资源：{$key} (" . get_resource_type($val) . ")\n";
}
}
这段代码能直观暴露循环对象引用点和资源位置，比看堆栈更快定位。
