Laravel模型Casts转换失效，调用toArray及属性取值报错求助

我之前开发Laravel应用时碰到过完全一样的问题，咱们一步步拆解排查，找到解决办法：

问题根源分析 #

你遇到的“json_decode期望字符串但传入数组”错误，本质是重复转换导致的：Laravel的array类型Cast会自动把数据库里的JSON字符串解码成数组，但如果某个环节已经把属性值转成数组了，Cast再次尝试对数组做json_decode就会抛出这个错误。

从你的描述来看，getAttributes()显示字段是JSON字符串，说明数据库存储是正常的，问题出在模型属性的处理流程里。

具体排查与修复步骤 #

1. 检查是否存在自定义访问器冲突 #

这是最常见的原因：如果你在StoreDataProduct模型里定义了类似下面的访问器，就会和array Cast功能重复：

// 错误示例：和array Cast重复转换
public function getDefaultImageAttribute($value)
{
    return json_decode($value, true);
}

解决办法：直接删除这类自定义访问器，让Laravel的自动Cast机制来处理JSON字符串和数组的转换。

2. 排查是否有代码提前修改了属性值 #

比如在模型的boot方法、观察者、全局作用域，或者业务逻辑里，有没有提前把default_image/images转成数组？比如：

// 错误示例：提前转换导致Cast重复处理
$currentStoreDataProduct->default_image = json_decode($currentStoreDataProduct->default_image, true);

解决办法：

• 尝试重新从数据库获取干净的模型实例，避免使用被修改过的实例：

  $freshInstance = StoreDataProduct::find($currentStoreDataProduct->id);
  dd($freshInstance->default_image); // 这里应该能正常返回数组
  

• 检查业务代码中有没有手动修改这些属性的逻辑，移除不必要的手动转换。

3. 自定义Cast类兼容重复转换场景 #

如果上面的方法都没解决问题，可以自定义一个Cast类，手动处理类型判断，避免重复解码：

首先创建自定义Cast文件app/Casts/ArrayCast.php：

<?php

namespace App\Casts;

use Illuminate\Contracts\Database\Eloquent\CastsAttributes;

class ArrayCast implements CastsAttributes
{
    /**
     * 从数据库获取值时的转换逻辑
     */
    public function get($model, $key, $value, $attributes)
    {
        // 如果已经是数组，直接返回；否则解码JSON字符串
        if (is_array($value)) {
            return $value;
        }

        // 解码失败时返回空数组，避免报错
        return json_decode($value, true) ?? [];
    }

    /**
     * 存入数据库时的转换逻辑
     */
    public function set($model, $key, $value, $attributes)
    {
        // 如果是数组，转成JSON字符串；否则直接返回（比如已经是JSON字符串）
        if (is_array($value)) {
            return json_encode($value);
        }

        return $value;
    }
}

然后在模型里替换默认的array Cast为自定义类：

protected $casts = [
    'default_image' => \App\Casts\ArrayCast::class,
    'images' => \App\Casts\ArrayCast::class,
];

这个自定义Cast会先判断值的类型，避免对数组重复执行json_decode，同时增加了解码失败的容错处理。

验证方法 #

修改后可以通过以下方式验证：

• 调用$model->toArray()，检查是否正常返回数组格式的属性
• 直接访问$model->default_image，确认返回的是数组而非JSON字符串

内容的提问来源于stack exchange，提问作者Ferdi van der Woerd