Laravel+React外键关联问题：无法获取关联模型名称

问题背景 #

使用Laravel和React开发，存在students、users、projects三张数据表，每个项目关联1名学生、1名导师和2名考官（导师与考官均来自users表）。尝试获取并展示学生、导师及考官的姓名时，调用project.projectStudent.name返回undefined。

现有代码情况 #

1. Project.php（模型） #

protected $with =['projectStudent', 'projectSupervisor', 'projectExaminer1', 'projectExaminer2'];
public function projectStudent()
{
    return $this->belongsTo('App\Models\Student', 'student_id', 'student_id');
}

public function projectSupervisor()
{
    return $this->belongsTo('App\Models\User', 'supervisor_id', 'id');
}

public function projectExaminer1()
{
    return $this->belongsTo('App\Models\User', 'examiner1_id', 'id');
}

public function projectExaminer2()
{
    return $this->belongsTo('App\Models\User', 'examiner2_id', 'id');
}

2. ProjectController.php（控制器） #

public function index()
{
    return ProjectResource::collection(
        Project::query()->with('projectStudent')->orderBy('id', 'desc')->paginate(5)
    );
}

3. Projects.jsx（React组件） #

const [projects, setProjects] = useState([]);
const [paginate, setPaginate] = useState(1);
const [loading, setLoading] = useState(false);
const {setNotification} = useStateContext();

useEffect(() => {
    getProjects();
}, [paginate])

const handlePaginate = (direction) => {
    setPaginate(prevPage => prevPage + direction)
}
function classNames(...classes) {
    return classes.filter(Boolean).join(' ')
}
const getProjects = () => {
    setLoading(true);
    axiosClient.get(`/projects?page=${paginate}`)
        .then(({data}) => {
            setLoading(false);
            setProjects(data.data);
            // 打印返回数据
            console.log(JSON.stringify(data.data, null, 2));
        })
        .catch(() => {
            setLoading(false);
        })
}

4. 接口返回的JSON数据 #

[
  {
    "id": 1,
    "title": "Stock Market Prediction",
    "student_id": "SW0102469",
    "supervisor_id": 18,
    "examiner1_id": 12,
    "examiner2_id": 33
  }
]

5. ProjectResource.php（资源类） #

<?php
namespace App\Http\Resources;

use Illuminate\Http\Resources\Json\JsonResource;

class ProjectResource extends JsonResource
{
    public static $wrap = false;
    /**
     * Transform the resource into an array.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return array|\Illuminate\Contracts\Support\Arrayable|\JsonSerializable
     */
    public function toArray($request)
    {
        return [
            'id' => $this->id,
            'title' => $this->title,
            'student_id' => $this->student_id,
            'supervisor_id' => $this->supervisor_id,
            'examiner1_id' => $this->examiner1_id,
            'examiner2_id' => $this->examiner2_id,
            // 'start_date' => $this->start_date->format('Y-m-d'),
            // 'end_date' => $this->end_date->format('Y-m-d'),
            // 'duration' => $this->duration,
            // 'status' => $this->status,
        ];
    }
}

问题原因 #

核心问题出在ProjectResource资源类：虽然模型中设置了$with预加载所有关联关系，控制器也尝试加载projectStudent，但资源类的toArray方法只返回了项目的基础字段，完全没有包含关联的学生、导师、考官数据。这就导致前端接收到的JSON里没有projectStudent这类关联字段，自然无法通过project.projectStudent.name获取值。

另外，控制器中仅显式加载了projectStudent，但模型的$with已经包含了所有需要的关联，这部分可以简化，但不是当前问题的直接诱因。

解决方案 #

1. 修改ProjectResource.php，添加关联数据到返回结果 #

更新toArray方法，将关联模型的数据加入返回数组，还可以指定只返回需要的字段（比如仅姓名），避免返回冗余数据：

public function toArray($request)
{
    return [
        'id' => $this->id,
        'title' => $this->title,
        // 关联学生数据，仅返回name字段（根据你的Student模型字段调整）
        'student' => [
            'id' => $this->projectStudent->student_id,
            'name' => $this->projectStudent->name
        ],
        // 关联导师数据
        'supervisor' => [
            'id' => $this->projectSupervisor->id,
            'name' => $this->projectSupervisor->name
        ],
        // 关联考官1数据
        'examiner1' => [
            'id' => $this->projectExaminer1->id,
            'name' => $this->projectExaminer1->name
        ],
        // 关联考官2数据
        'examiner2' => [
            'id' => $this->projectExaminer2->id,
            'name' => $this->projectExaminer2->name
        ],
        // 保留其他需要的基础字段
        // 'start_date' => $this->start_date?->format('Y-m-d'),
        // 'end_date' => $this->end_date?->format('Y-m-d'),
        // 'duration' => $this->duration,
        // 'status' => $this->status,
    ];
}

注意：如果关联模型可能不存在（比如某个项目未分配考官），建议使用?->可选链操作符避免报错，比如$this->projectExaminer1?->name。

2. 简化控制器的关联加载（可选） #

由于模型中已经通过$with预加载了所有需要的关联，控制器中的with('projectStudent')可以移除，让代码更简洁：

public function index()
{
    return ProjectResource::collection(
        Project::query()->orderBy('id', 'desc')->paginate(5)
    );
}

3. 前端调整数据访问路径 #

修改后前端接收到的JSON会包含student、supervisor等字段，此时可以通过以下方式访问姓名：

// 遍历projects展示示例
projects.map(project => (
    <div key={project.id}>
        <h3>{project.title}</h3>
        <p>学生：{project.student.name}</p>
        <p>导师：{project.supervisor.name}</p>
        <p>考官1：{project.examiner1.name}</p>
        <p>考官2：{project.examiner2.name}</p>
    </div>
))

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