在使用Laravel Eloquent 加載關(guān)聯(lián)數(shù)據(jù)時，若主模型查詢中指定了選擇的列，但未包含用於建立關(guān)係的外鍵，則關(guān)聯(lián)數(shù)據(jù)可能返回null。本文將詳細解釋此問題的原因，並提供解決方案：在主模型查詢的select 語句中明確包含所有關(guān)聯(lián)所需的外鍵，以確保Eloquent 能夠正確匹配並加載關(guān)聯(lián)數(shù)據(jù)。

問題描述

在Laravel 應(yīng)用中，當嘗試通過Eloquent 的with() 方法預加載關(guān)聯(lián)數(shù)據(jù)（例如Files 和User 模型），同時在主模型（Course）的查詢中使用了select() 方法來指定需要獲取的列時，可能會遇到關(guān)聯(lián)數(shù)據(jù)返回null 的情況。即使關(guān)聯(lián)關(guān)係在模型中已正確定義，且外鍵實際存在於數(shù)據(jù)庫中，但由於主查詢未選擇這些外鍵列，Eloquent 無法在內(nèi)存中建立正確的關(guān)聯(lián)映射。

考慮以下場景：我們希望從Course 表中獲取id、courseDisplayName 和aboutCourse 列，並同時預加載其關(guān)聯(lián)的files（獲取id、FileName、FilePath）和user（獲取id、name）信息。

最初的Eloquent 查詢代碼可能如下所示：

 $course = Course::with(['files:id,FileName,FilePath','user:id,name'])
    ->select('id','courseDisplayName','aboutCourse')
    ->where('userId',$request->tutorId)
    ->get();

相應(yīng)的Course 模型中定義了與Files 和User 的belongsTo 關(guān)係：

 // Course 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');
    }
}

儘管關(guān)係定義正確，但上述查詢的輸出結(jié)果中，files 和user 關(guān)聯(lián)數(shù)據(jù)卻顯示為null：

 [
    {
        "id": 20,
        "courseDisplayName": "asasasb",
        "aboutCourse": null,
        "files": null, // 期望有數(shù)據(jù)，但為null
        "user": null // 期望有數(shù)據(jù)，但為null
    },
    {
        "id": 14,
        "courseDisplayName": "yuu",
        "aboutCourse": "kljkl",
        "files": null,
        "user": null
    }
]

問題原因分析

這個問題產(chǎn)生的根本原因是Eloquent 在預加載關(guān)聯(lián)數(shù)據(jù)時，需要依賴主模型查詢結(jié)果中的外鍵列來匹配和鏈接關(guān)聯(lián)模型。當你在主模型查詢中顯式使用select() 方法，並且沒有包含用於建立關(guān)聯(lián)的外鍵列（例如fileId 和userId），Eloquent 就無法獲取到這些關(guān)鍵的連接信息。

具體來說，Course::with(['files', 'user']) 會首先執(zhí)行主查詢獲取Course 記錄。然後，Eloquent 會收集這些Course 記錄中的fileId 和userId 值，並使用它們來執(zhí)行單獨的查詢（或在某些情況下進行JOIN 操作）來獲取對應(yīng)的Files 和User 記錄。如果fileId 和userId 不在主查詢的結(jié)果集中，Eloquent 就無法構(gòu)建後續(xù)的關(guān)聯(lián)查詢，也無法將獲取到的關(guān)聯(lián)數(shù)據(jù)正確地“注入”到對應(yīng)的Course 對像中。

解決方案

解決此問題的方法非常直接：在主模型的select() 語句中，除了選擇所需的業(yè)務(wù)數(shù)據(jù)列外，還必須包含所有用於建立關(guān)聯(lián)關(guān)係的外鍵列。

對於本例，Course 模型通過fileId 關(guān)聯(lián)Files 模型，通過userId 關(guān)聯(lián)User 模型。因此，在select() 方法中，需要將fileId 和userId 也包含進來。

修正後的Eloquent 查詢代碼如下：

 $course = Course::with(['files:id,FileName,FilePath','user:id,name'])
    ->select('id','courseDisplayName','aboutCourse', 'userId', 'fileId') // 增加'userId' 和'fileId'
    ->where('userId',$request->tutorId)
    ->get();

通過在select 語句中加入userId 和fileId，Eloquent 就能在獲取Course 記錄的同時，獲得這些外鍵值。這樣，當Eloquent 嘗試加載files 和user 關(guān)聯(lián)時，它能夠正確地使用這些外鍵值來執(zhí)行後續(xù)的關(guān)聯(lián)查詢，並將結(jié)果映射回Course 對象。

注意事項與最佳實踐

1. 外鍵的必要性：當你對主模型使用select() 方法時，務(wù)必記?。喝魏斡渺秝ith() 預加載關(guān)聯(lián)關(guān)係的外鍵都必須包含在select() 的列列表中。
2. 默認行為：如果你的Eloquent 查詢沒有使用select() 方法，那麼Eloquent 默認會選擇表中的所有列（SELECT *），在這種情況下，外鍵通常也會被包含在內(nèi)，因此不會出現(xiàn)此問題。
3. 性能考量：儘管為了解決關(guān)聯(lián)問題需要包含外鍵，但在實際應(yīng)用中，仍應(yīng)遵循只選擇必要列的原則，以優(yōu)化查詢性能和減少內(nèi)存消耗。避免無謂地選擇所有列，除非你確實需要它們。
4. 多級關(guān)聯(lián)：如果存在多級關(guān)聯(lián)（例如Course -> Files -> FileOwner），那麼在預加載FileOwner 時，也需要確保Files 模型中用於關(guān)聯(lián)FileOwner 的外鍵被選中（如果Files 模型也使用了select()）。
5. 可讀性與維護：為了代碼的可讀性和未來的維護，建議將所有與關(guān)係相關(guān)的外鍵列明確地列在select() 方法中，即使它們在某些情況下可能不是嚴格必需的（例如，當不使用select() 時）。

總結(jié)

在使用Laravel Eloquent 進行數(shù)據(jù)查詢和關(guān)聯(lián)預加載時，如果對主模型的結(jié)果集進行了列篩選（即使用了select() 方法），務(wù)必確保將所有用於建立關(guān)聯(lián)關(guān)係的外鍵列包含在select() 的列表中。這是確保Eloquent 能夠正確識別並加載關(guān)聯(lián)數(shù)據(jù)的關(guān)鍵步驟。遵循這一原則，可以有效避免因外鍵缺失而導致的關(guān)聯(lián)數(shù)據(jù)為空的問題，從而構(gòu)建出健壯且高效的Laravel 應(yīng)用。

以上是解決 Eloquent 關(guān)係中關(guān)聯(lián)數(shù)據(jù)為空的問題：確保外鍵被選中的詳細內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！