本文旨在解决 Laravel Eloquent 模型在关联查询时返回 null 值的问题。通过分析问题代码和模型定义，明确了外键字段在查询中的重要性，并提供了正确的查询方法，确保关联数据能够正确加载。
在使用 Laravel Eloquent 进行关联查询时，有时会遇到关联关系返回 null 的情况，这通常是由于查询中缺少必要的外键字段导致的。以下将详细介绍如何避免这种情况，并确保关联数据能够正确加载。
问题分析
当使用 with() 方法进行 eager loading 时，Eloquent 需要根据外键字段将主模型和关联模型连接起来。如果在主模型的查询中没有包含这些外键字段，Eloquent 将无法正确建立关联，从而导致关联关系返回 null。
解决方案
要解决这个问题，需要在主模型的查询中显式地选择外键字段。具体来说，在使用 select() 方法时，除了选择需要的字段外，还需要包含关联关系中使用的外键字段。
示例代码
假设我们有三个模型：Course、Files 和 User。Course 模型与 Files 和 User 模型分别存在 belongsTo 关系，通过 fileId 和 userId 字段进行关联。
以下是 Course 模型的定义：
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class Course extends Model
{
public function files()
{
return $this->belongsTo(Files::class, 'fileId', 'id');
}
public function user()
{
return $this->belongsTo(User::class, 'userId', 'id');
}
}正确的查询方式应该如下所示：
use App\Models\Course;
use Illuminate\Http\Request;
class CourseController extends Controller
{
public function index(Request $request)
{
$course = Course::with(['files:id,FileName,FilePath', 'user:id,name'])
->select('id', 'courseDisplayName', 'aboutCourse', 'userId', 'fileId')
->where('userId', $request->tutorId)
->get();
return response()->json($course);
}
}在这个查询中，我们使用 select() 方法选择了 id、courseDisplayName 和 aboutCourse 字段，同时还选择了 userId 和 fileId 这两个外键字段。这样，Eloquent 就能根据这些外键字段正确加载 files 和 user 关联关系。
注意事项
- 务必确保在 select() 方法中包含了所有关联关系中使用的外键字段。
- 如果使用了全局 scope 或者其他修改查询的方式，也需要注意是否会影响外键字段的选择。
- 在调试过程中，可以使用 toSql() 方法查看生成的 SQL 查询语句，以便确认是否选择了正确的字段。例如： dd(Course::with(['files:id,FileName,FilePath', 'user:id,name'])->select('id', 'courseDisplayName', 'aboutCourse', 'userId', 'fileId')->where('userId', $request->tutorId)->toSql());
总结
在使用 Laravel Eloquent 进行关联查询时，确保在主模型的查询中包含了所有必要的外键字段，是避免关联关系返回 null 的关键。通过显式地选择这些字段，可以确保 Eloquent 能够正确建立关联，并加载关联数据。
