Laravel Eloquent HasMany关联查询varchar字段类型不匹配报错

数据老陈

2026-9-3

问题根因

这个报错是两个问题叠加导致的：

Eloquent 模型默认将主键识别为自增整型字段，你没有显式指定主键类型，当idecli字段存储的内容为纯数字时，Eloquent 会自动将读取到的主键值转为整型，预加载关联loans时，会把整型的主键值放到IN查询子句中。
PostgreSQL 是强类型数据库，不会像 MySQL 那样自动做跨类型的隐式转换，当查询拿整型值去匹配 varchar 类型的idecli字段时，就会抛出类型不匹配、找不到对应操作符的错误。

额外注意：你当前Loan模型中的customer关联定义存在笔误，关联模型类写的是Person::class，且关联键配置错误，需要同步修正，否则后续反向关联查询会直接拿到错误的模型结果。

修复步骤

第一步：在Customer模型中显式声明主键类型为字符串，关闭默认的自增主键配置，从根源上阻止 Eloquent 自动将主键转为整型：

class Customer extends Model
{
    use HasFactory;

    protected $table = 'tblcli';
    protected $primaryKey = 'idecli';
    // 新增以下两行配置
    protected $keyType = 'string';
    public $incrementing = false;

    public function loans() {
        return $this->hasMany(Loan::class,'idecli','idecli');
    }
}

第二步：修正Loan模型的反向关联定义，同时给idecli字段加显式类型转换，保证字段读写始终为字符串类型：

class Loan extends Model
{
    use HasFactory;

    protected $table = 'tblmca';
    protected $primaryKey = 'ide';
    // 新增casts配置强制字段类型
    protected $casts = [
        'idecli' => 'string',
    ];

    public function customer(): \Illuminate\Database\Eloquent\Relations\BelongsTo
    {
        // 修正关联类为Customer，对齐关联键
        return $this->belongsTo(Customer::class,'idecli', 'idecli');
    }
}

第三步：验证修复结果，重新执行分页查询代码，此时 Eloquent 生成的关联查询 SQL 中，IN子句内的参数会是带引号的字符串格式，和数据库中 varchar 类型的字段匹配，不会再抛出类型错误。

如果部分特殊场景下仍出现类型强转问题，可以在查询时手动通过whereRaw加类型转换逻辑，但按照上述配置模型属性后，绝大多数场景都可以正常运行，不需要额外写原生SQL。

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