Laravel一对多反向关联belongsTo查询返回null如何解决

云上老周

2026-10-2

问题解决方案

按以下优先级排查修改即可解决反向关联返回null的问题：

1. 修正AdminClient模型的表名配置

Laravel会自动将驼峰命名的模型类转换为蛇形复数作为默认表名，AdminClient 默认对应的表为admin_clients，你实际使用的是clients表，需要在AdminClient类中显式指定表名：

use Illuminate\Database\Eloquent\Model;

class AdminClient extends Model
{
    // 新增这一行指定表名
    protected $table = 'clients';

    public function payroll()
    {
        return $this->hasMany(Payroll::class, "payroll_id", "payroll_id");
    }
}

2. 修正主键配置（如果将payroll_id作为AdminClient主键）

如果你将payroll_id设为AdminClient的主键，需要额外配置主键属性，避免Laravel默认将主键转为整型导致匹配失败：

use Illuminate\Database\Eloquent\Model;

class AdminClient extends Model
{
    protected $table = 'clients';
    // 新增以下主键配置
    protected $primaryKey = 'payroll_id';
    // 如果payroll_id不是自增整型则添加
    public $incrementing = false;
    // 如果payroll_id是字符串类型则添加
    protected $keyType = 'string';

    public function payroll()
    {
        return $this->hasMany(Payroll::class, "payroll_id", "payroll_id");
    }
}

3. 处理软删除过滤

如果AdminClient模型使用了软删除功能，被软删除的记录默认不会被关联查询到，可在关联定义中添加withTrashed()包含软删除记录：

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;

class Payroll extends Model
{
    use SoftDeletes;

    public function clients()
    {
        return $this->belongsTo(AdminClient::class, "payroll_id", "payroll_id")->withTrashed();
    }
}