Laravel中tax_class关联无法加载返回null的问题求助

Client模型的多个关联关系中，其余关联均正常工作，但tax_class()关联始终返回null。该关联与其他正常关联的定义方式完全一致，尝试多种调试方法仍未解决。

提供的模型代码 #

Client模型 #

class Client extends Model
{
    use HasFactory;

    protected $fillable = [
        'manager_id',
        'email',
        'name',
        'type',
        'tax_class_id',
        'state_id',
        'city',
        'contract_type',
    ];

    protected $casts = [
        'tax_class' => TaxClasses::class,
    ];

    public function manager()
    {
        return $this->belongsTo(User::class, 'manager_id')->withDefault(); // Returns a default manager if none is assigned
    }

    public function tax_class()
    {
        return $this->belongsTo(TaxClass::class, 'tax_class_id');
    }

    public function documents()
    {
        return $this->hasMany(Document::class);
    }

    public function state()
    {
        return $this->belongsTo(State::class);
    }

    public function schedules()
    {
        return $this->belongsToMany(Schedule::class, 'schedule_client');
    }

    public function taxes()
    {
        return $this->belongsToMany(Tax::class, 'client_tax');
    }
}

TaxClass模型 #

class TaxClass extends Model
{
    protected $table = 'tax_classes';
    use HasFactory;

    protected $fillable = ['name'];

    protected $casts = [
        'name' => TaxClasses::class
    ];

    public function clients()
    {
        return $this->hasMany(Client::class);
    }
}

• 移除错误的类型转换：Client模型的$casts数组里，你给关联关系名称tax_class设置了TaxClasses::class类型转换，这完全错误——tax_class不是数据库字段，对应的字段是tax_class_id。这个错误转换会干扰Eloquent的关联加载逻辑，直接导致关联返回null。删掉这行代码：

  'tax_class' => TaxClasses::class,
  

• 修正TaxClass模型的类型转换：TaxClass模型中给name字段设置TaxClasses::class转换也不合理，name是普通字符串字段，不需要这种转换，同样删除此行：

  'name' => TaxClasses::class
  

• 验证数据匹配：确认clients表中的tax_class_id值，在tax_classes表中存在对应的记录，且两个字段的类型完全一致（比如都是unsigned整数）。
• 检查关联加载方式：访问关联时用$client->tax_class而不是直接取字段；如果需要批量加载数据，用Client::with('tax_class')->find($id)预加载关联，确保加载逻辑正确。

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