Laravel从模型对象获取属性返回空值问题求助

可能的原因 #

• balance是动态添加的字段，未定义对应访问器：你的User模型可能在转JSON/数组时手动加入了balance字段，但没有为其定义Eloquent模型的访问器。直接访问模型属性时，Eloquent会优先从$attributes数组或访问器中查找，找不到就返回null；但转JSON时会包含所有动态添加的字段，因此json_decode解析后能正常取值。
• 模型可见性配置异常：虽然少见，但如果User模型的$hidden/$visible配置存在错误，可能出现balance在JSON输出中可见，但直接访问被拦截的情况。
• 查询返回的不是Eloquent模型实例：若User::find($id)因代码或配置问题返回了stdClass对象，该对象的balance属性可能因键名格式问题（比如大小写不匹配）无法直接访问，但转JSON后能正常解析。

解决办法 #

1. 定义访问器（针对动态字段场景） #

如果balance是计算得出或来自关联数据，在User模型中添加对应的访问器：

public function getBalanceAttribute()
{
    // 替换为你的实际逻辑，比如从关联表取值、计算数值等
    return 1;
}

添加后即可直接通过$object->balance访问该值。

2. 检查模型可见性配置 #

打开User模型，确认以下配置：

// 确保balance不在$hidden数组中
protected $hidden = ['password', 'remember_token'];

// 若使用$visible白名单，需将balance加入数组
protected $visible = ['id', 'balance'];

3. 确保查询返回Eloquent模型实例 #

检查User模型的继承关系是否正确：

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // ...
}

同时确认查询逻辑未被篡改，比如没有额外的转换方法将模型转为普通对象。

快速排查技巧 #

先验证模型的原生属性中是否包含balance：

// 打印模型所有原生属性
dd($object->getAttributes());
// 检查balance是否存在于属性数组中
dd(isset($object->getAttributes()['balance']));

如果getAttributes()中没有balance，说明是动态字段，需添加访问器；如果存在，则大概率是模型的属性访问逻辑被修改。

内容的提问来源于stack exchange，提问作者ChanhHuynh