Laravel自定义belongsTo关联后动态属性返回null如何解决

问题根因 #

belongsTo关联默认假定关联的父键（此处为Building的address字段）为整数类型自增主键：

• 动态属性->building读取关联时，Eloquent会自动对Apartment的外键addresss做整数类型转换，字符串格式的地址转为整数后为0，无法匹配到对应记录，因此返回null
• 直接调用->building()->first()时，不会执行额外的强制类型转换，直接按原始字段值执行SQL查询，因此可以正常返回数据

解决方案 #

方案一（推荐）：将address设为Building模型主键 #

如果Building表实际以address作为唯一标识，直接在Building模型中添加如下配置即可：

// Building 模型
protected $primaryKey = 'address';
public $incrementing = false;
protected $keyType = 'string';

配置完成后动态属性即可正常读取关联数据。

方案二：不修改主键的手动适配 #

如果不需要将address设为主键，可直接修改关联定义，指定字符串类型匹配逻辑：

public function building() {
    return $this->belongsTo(Building::class, 'addresss', 'address')
        ->where('address', $this->addresss);
}

补充排查项 #

• 确认Apartment表的addresss字段拼写正确，不存在笔误
• 确认两个关联字段addresss、address的数据类型、字符集、排序规则完全一致，避免因格式差异导致匹配失败
• 若字段值存在前后空格或大小写差异，可在两个模型中为对应字段添加自动Trim、统一大小写的访问器，保证匹配一致性

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