Laravel中SQL Server二进制字段Eloquent关联查询问题求助

场景与表结构 #

我在SQL Server中有两张表：

表Account #

[id] [binary](13) NOT NULL, [PRIMARY KEY]
[email] [varchar](50) NOT NULL,
....

表Status #

[numG] [int] NOT NULL,
[id] [binary](13) NOT NULL, [PRIMARY KEY]
[contractname] [varchar](50) NOT NULL,
....

Laravel模型关联定义 #

AccountModel中的关联 #

public function status(): BelongsTo
{
    return $this->belongsTo(StatusModel::class, 'id', 'id');
}

StatusModel中的关联 #

public function account(): HasOne
{
    return $this->hasOne(AccountModel::class, 'id', 'id');
}

当前查询代码（CheckController） #

public function checkStatus($id) {
    $account= AccountModel::where('id', DB::raw("convert(binary(13), '$id')"))->with('status')->first();
    dd($account);
}

问题现象 #

查询返回结果中关联的status为null：

#attributes: array:21 [▼
    "id" => "testUser\x00\x00\x00\x00\x00"
    "email" => "test@test.com"
  ]
 #relations: array:1 [▼
    "status" => null
  ]

执行dd($account->status->numG)时抛出错误：

Attempt to read property "numG" on null

期望结果 #

通过Account表的id查询数据，并获取Status表中的numG字段，期望得到如下结构的数据：

$data = [
    "id" => $account->id,
    "email" => $account->email,
    "numG" => $account->status->numG
];

解决方案 #

问题核心是二进制ID的处理逻辑不一致：手动用DB::raw转换查询主表时，Laravel加载关联会用模型中存储的带空字节补全的ID值去匹配，二者的转换规则不统一导致关联匹配失败。以下是具体解决步骤：

1. 给模型添加二进制字段类型转换 #

在AccountModel和StatusModel中添加$casts属性，让Laravel自动统一处理二进制字段的序列化与反序列化：

// AccountModel.php
protected $casts = [
    'id' => 'binary',
];

// StatusModel.php
protected $casts = [
    'id' => 'binary',
];

2. 修正查询逻辑，避免手动拼接SQL #

手动拼接convert函数容易出现编码或长度偏差，改用类型转换自动处理：

public function checkStatus($id) {
    // 确保传入的id被转换为13字节的二进制字符串（自动补全空字节）
    $account = AccountModel::where('id', $id)->with('status')->first();
    dd($account);
}

如果需要手动控制二进制转换，也可以提前处理ID：

public function checkStatus($id) {
    // 手动将字符串补全为13字节的二进制格式
    $binaryId = str_pad($id, 13, "\x00");
    $account = AccountModel::where('id', $binaryId)->with('status')->first();
    dd($account);
}

3. 验证关联定义与数据一致性 #

• 确认两张表的id字段都是binary(13)类型，长度和类型完全一致；
• 可以先在SQL Server中执行原生SQL验证数据关联是否存在：

SELECT a.id, a.email, s.numG
FROM Account a
JOIN Status s ON a.id = s.id
WHERE a.id = CONVERT(binary(13), 'testUser');

如果原生SQL能返回结果，说明数据没问题，问题只出在Laravel的处理逻辑上。

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