Laravel Eloquent关联问题：WorkOrder模型supplier关联返回Null

我有一个 WorkOrder 模型，其中 supplier_id 字段需要关联 contacts 表中的供应商数据。已在模型中定义了 supplier 关联方法，但使用预加载查询后，supplier 字段始终返回 Null。

模型代码 #

class WorkOrder extends Model
{
    public function supplier()
    {
        return $this->belongsTo(Contact::class, 'supplier_id', 'id');
    }
}

说明：contacts 表主键为 id，work_orders 表通过 supplier_id 字段关联供应商。

控制器查询代码 #

$workOrders = WorkOrder::with('supplier')->get();

返回结果示例 #

Illuminate\Database\Eloquent\Collection {#1613 ▼
  #items: array:11 [▼
    0 => App\Models\WorkOrder {#1655 ▼
      #connection: "mysql"
      #table: "work_orders"
      #primaryKey: "id"
      #keyType: "int"
      +incrementing: true
      #with: []
      #withCount: []
      #perPage: 15
      +exists: true
      +wasRecentlyCreated: false
      #attributes: array:18 [▶]
      #original: array:18 [▶]
      #changes: []
      #casts: []
      #classCastCache: []
      #dates: []
      #dateFormat: null
      #appends: []
      #dispatchesEvents: []
      #observables: []
      #relations: array:1 [▼
        "supplier" => null
      ]
      #touches: []
      +timestamps: true

排查步骤 #

• 验证数据匹配：直接执行 SQL 检查关联数据是否存在，比如：SELECT * FROM work_orders wo LEFT JOIN contacts c ON wo.supplier_id = c.id WHERE wo.id = [问题工单ID]，确认 supplier_id 对应的值在 contacts 表中有匹配记录。
• 检查字段类型一致性：确保 work_orders.supplier_id 和 contacts.id 的字段类型完全一致（比如都是 int，无 unsigned 差异），类型不匹配会导致关联失效。
• 确认模型配置：检查 Contact 模型是否正确设置了主键和表名——默认主键是 id，默认表名是 contacts，如果自定义过，需在 Contact 模型中声明 protected $table = '自定义表名'。
• 查看实际执行的 SQL：在代码中添加日志监听，查看预加载生成的 SQL 是否正确：

  DB::listen(function($query) { 
      var_dump($query->sql); 
  });
  

• 测试非预加载关联：单独查询单个工单的关联数据，排除预加载问题：

  $workOrder = WorkOrder::find(1);
  dd($workOrder->supplier);
  

• 检查软删除影响：如果 Contact 模型使用了软删除（引入 use SoftDeletes;），被软删除的供应商不会被预加载返回。可以临时在关联方法中加入 ->withTrashed() 测试：

  return $this->belongsTo(Contact::class, 'supplier_id', 'id')->withTrashed();
  

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