Laravel一对一关联：学生列表页无法显示关联书籍名称的解决方法

算力阿峰

2026-7-23

解决方案

1. 修正模型关联方法名（可选但更符合语义）

Student模型里的关联是一对一的belongsTo，建议将方法名改为book()（对应单个书籍），更贴合业务逻辑：

class Student extends Model{
    protected $fillable = [
        'book_id','name' 
    ];

    public function book(){
        return $this->belongsTo(Book::class);
    }
}

2. 调整控制器查询逻辑（核心修复）

当前控制器仅查询了学生的id和name，未包含关联必需的book_id，也没有预加载关联模型，导致无法获取书籍数据。修改查询语句，预加载关联并保留必要字段：

public function index(){
    // 预加载book关联，避免N+1查询，同时指定书籍所需字段
    $students = Student::with('book:id,name')
        ->select('id', 'name', 'book_id') // 必须包含book_id才能建立关联
        ->latest()
        ->paginate(3);
    return view('students.index', compact('students'));
}

注：如果不需要单独传递书籍列表，可删除Book::all()，关联已能获取所需数据。

3. 在视图中调用关联字段

在循环中通过关联方法获取书籍名称，同时处理无关联书籍的情况避免报错：

@foreach($students as $student)
    <tr>
        <td>{{ $student->id }}</td>
        <td>{{ $student->book_id }}</td>
        <td>{{ $student->name }}</td>
        <td>{{ $student->book?->name ?? '无关联书籍' }}</td> {{-- 调用关联的书籍名称 --}}
        <td>
            <a href="{{ route('students.show',[$student->id]) }}" class="btn btn-sm btn-primary">查看</a>
            <a href="{{ route('students.edit',[$student->id]) }}" class="btn btn-sm btn-info">编辑</a>
            <a href="{{ route('students.delete',$student->id) }}" class="btn btn-sm btn-danger" onclick="return confirm('确定要删除该学生吗？')">删除</a>
        </td>
    </tr>
@endforeach