Laravel中获取分组最新记录：Eloquent关系与SQL策略解析

花韻仙語

发布时间：2025-10-28 11:46:27

941人浏览过

来源于php中文网

原创

laravel中获取分组最新记录：eloquent关系与sql策略解析

本文深入探讨在Laravel应用中，如何高效且准确地获取按用户分组的最新消息记录。针对传统`GROUP BY`可能无法返回最新记录的问题，文章推荐利用Eloquent关系进行数据预加载，以优化会话消息的整体检索。同时，针对“获取每个用户最新一条消息”的特定需求，文章将进一步介绍基于SQL子查询或窗口函数的数据库层面解决方案，并提供最佳实践建议。

理解Laravel中获取分组最新记录的挑战

在处理如用户消息会话这类数据时，一个常见需求是获取与当前用户有过交流的所有联系人，并显示他们之间最新的那条消息。初学者可能会尝试使用SQL的GROUP BY子句结合ORDER BY来达到目的，例如：

$users = Message::join('users',  function ($join) {
            $join->on('messages.sender_id', '=', 'users.id')
                ->orOn('messages.receiver_id', '=', 'users.id');
        })
        ->where(function ($q) {
            $q->where('messages.sender_id', Auth::user()->id)
            ->orWhere('messages.receiver_id', Auth::user()->id);
        })
        ->orderBy('messages.created', 'desc') // 尝试按时间倒序
        ->groupBy('users.id') // 按用户分组
        ->paginate();

然而，这种方法存在一个核心问题：当使用GROUP BY而没有聚合函数（如MAX(), SUM(), COUNT()等）时，SQL数据库（尤其是MySQL 5.7及更早版本，或在不启用ONLY_FULL_GROUP_BY模式时）在每个分组中选择哪一行作为代表是不确定的。即使前面有orderBy('messages.created', 'desc')，它也只是在分组操作之前对所有记录进行排序，GROUP BY操作本身并不能保证会选择排序后的第一行（即最新的记录）。因此，上述查询很可能返回的是旧消息而非最新消息。

利用Eloquent关系优化消息数据检索

在Laravel中，处理关联数据时，推荐使用Eloquent ORM提供的关系功能，这不仅能使代码更清晰，还能有效避免N+1查询问题。对于消息和用户之间的关系，我们可以这样定义：

1. 定义模型关系

首先，确保你的Message模型与User模型之间定义了正确的关联关系。一条消息通常有一个发送者和一个接收者。

app/Models/Message.php

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Message extends Model
{
    use HasFactory;

    // 假设你的时间戳字段是 'created' 而非 'created_at'
    // 如果是 'created_at'，则无需设置 $timestamps 和 CREATED_AT
    const CREATED_AT = 'created';
    const UPDATED_AT = null; // 如果没有 updated_at 字段

    protected $fillable = [
        'sender_id',
        'receiver_id',
        'content',
        'created', // 确保你的时间戳字段在此
    ];

    /**
     * 消息的发送者
     */
    public function sender()
    {
        return $this->belongsTo(User::class, 'sender_id');
    }

    /**
     * 消息的接收者
     */
    public function receiver()
    {
        return $this->belongsTo(User::class, 'receiver_id');
    }
}

2. 构建优化查询

定义好关系后，我们可以利用Eloquent的with()方法进行Eager Loading（预加载），从而高效地获取所有与当前用户相关的消息及其发送者和接收者信息。这种方法避免了GROUP BY的歧义问题，适用于展示完整的会话历史记录。

use App\Models\Message;
use Illuminate\Support\Facades\Auth;

// 获取当前用户ID
$currentUserId = Auth::id();

// 查询所有与当前用户相关的消息，并预加载发送者和接收者信息
$messages = Message::with(['sender', 'receiver'])
    ->where(function ($query) use ($currentUserId) {
        $query->where('sender_id', $currentUserId)
            ->orWhere('receiver_id', $currentUserId);
    })
    ->orderByDesc('created') // 假设你的时间戳字段是 'created'
    // 如果是 'created_at'，请使用 orderByDesc('created_at')
    ->paginate(15); // 分页显示结果

代码解释：

Message::with(['sender', 'receiver'])：这是Eager Loading的关键。它会一次性加载所有消息的发送者和接收者用户信息，而不是在每次访问$message->sender或$message->receiver时都执行一次新的数据库查询，从而有效解决了N+1查询问题。
where(function ($query) use ($currentUserId) { ... })：筛选出所有发送者或接收者是当前用户的消息。
orderByDesc('created')：确保返回的消息列表是按时间倒序排列的，即最新消息在前。
paginate(15)：对结果进行分页处理。

这个查询将返回一个Message模型的集合，每个Message对象都包含了其sender和receiver的User模型实例。这非常适合构建一个显示完整消息历史的界面。

深入探讨：如何获取每个用户的最新消息

尽管上述Eloquent查询能高效获取所有相关消息，但它返回的是一个消息列表，而非每个联系人仅显示一条最新消息的“会话列表”。如果你的核心需求是：列出所有与当前用户有过交流的联系人，并且每个联系人只显示他们之间最新的那条消息，那么这需要更高级的SQL技巧。

百度AI搜

百度全新AI搜索引擎

下载

1. 解决方案一：基于SQL子查询或窗口函数（推荐用于数据库层面优化）

为了在数据库层面精确地获取每个分组的最新记录，通常需要使用子查询或窗口函数（如ROW_NUMBER()）。

概念性SQL示例（MySQL）：

SELECT m1.*, u_sender.name as sender_name, u_receiver.name as receiver_name
FROM messages m1
JOIN (
    SELECT
        LEAST(sender_id, receiver_id) AS user_pair_id_1,
        GREATEST(sender_id, receiver_id) AS user_pair_id_2,
        MAX(created) AS latest_created_at
    FROM messages
    WHERE sender_id = [current_user_id] OR receiver_id = [current_user_id]
    GROUP BY user_pair_id_1, user_pair_id_2
) AS latest_messages ON (
    (m1.sender_id = latest_messages.user_pair_id_1 AND m1.receiver_id = latest_messages.user_pair_id_2) OR
    (m1.sender_id = latest_messages.user_pair_id_2 AND m1.receiver_id = latest_messages.user_pair_id_1)
) AND m1.created = latest_messages.latest_created_at
LEFT JOIN users u_sender ON m1.sender_id = u_sender.id
LEFT JOIN users u_receiver ON m1.receiver_id = u_receiver.id
WHERE m1.sender_id = [current_user_id] OR m1.receiver_id = [current_user_id]
ORDER BY m1.created DESC;

在Laravel中实现（使用joinSub或原生表达式）：

由于这种查询相对复杂，在Laravel中可以通过joinSub方法或直接使用DB::raw()来构建。以下是一个使用joinSub的思路：

use Illuminate\Support\Facades\DB;
use App\Models\Message;
use Illuminate\Support\Facades\Auth;

$currentUserId = Auth::id();

$latestMessagePerConversation = Message::select('messages.*')
    ->selectRaw('CASE WHEN messages.sender_id = ? THEN messages.receiver_id ELSE messages.sender_id END as conversation_partner_id', [$currentUserId])
    ->joinSub(function ($query) use ($currentUserId) {
        $query->from('messages')
            ->select(
                DB::raw('LEAST(sender_id, receiver_id) as user_a'),
                DB::raw('GREATEST(sender_id, receiver_id) as user_b'),
                DB::raw('MAX(created) as latest_created')
            )
            ->where('sender_id', $currentUserId)
            ->orWhere('receiver_id', $currentUserId)
            ->groupBy('user_a', 'user_b');
    }, 'latest_conversations', function ($join) {
        $join->on(function ($on) {
            $on->whereColumn('messages.sender_id', '=', 'latest_conversations.user_a')
               ->whereColumn('messages.receiver_id', '=', 'latest_conversations.user_b');
        })->orOn(function ($on) {
            $on->whereColumn('messages.sender_id', '=', 'latest_conversations.user_b')
               ->whereColumn('messages.receiver_id', '=', 'latest_conversations.user_a');
        });
        $join->on('messages.created', '=', 'latest_conversations.latest_created');
    })
    ->with(['sender', 'receiver']) // 预加载发送者和接收者
    ->where(function ($query) use ($currentUserId) {
        $query->where('messages.sender_id', $currentUserId)
              ->orWhere('messages.receiver_id', $currentUserId);
    })
    ->orderByDesc('messages.created')
    ->paginate(15);

这段代码首先构建一个子查询，找出每个“用户对”的最新消息时间。然后将主查询与这个子查询连接，以匹配到每对用户中的最新消息。LEAST()和GREATEST()函数用于标准化用户对的ID，确保无论谁是发送者/接收者，同一对用户都能被正确分组。

2. 解决方案二：PHP层面处理（适用于小数据集或特定场景）

如果数据集不大，或者上述SQL过于复杂难以维护，你也可以选择先获取所有相关消息，然后在PHP代码中进行处理。

use App\Models\Message;
use Illuminate\Support\Facades\Auth;

$currentUserId = Auth::id();

// 获取所有相关消息，按时间倒序
$allMessages = Message::with(['sender', 'receiver'])
    ->where(function ($query) use ($currentUserId) {
        $query->where('sender_id', $currentUserId)
            ->orWhere('receiver_id', $currentUserId);
    })
    ->orderByDesc('created')
    ->get(); // 注意这里是 get() 而非 paginate()

$latestMessagesPerUser = [];
foreach ($allMessages as $message) {
    // 确定对话伙伴的ID
    $partnerId = ($message->sender_id === $currentUserId) ? $message->receiver_id : $message->sender_id;

    // 如果该伙伴的最新消息尚未记录，或当前消息更新，则记录
    if (!isset($latestMessagesPerUser[$partnerId])) {
        $latestMessagesPerUser[$partnerId] = $message;
    }
    // 由于我们已经按时间倒序，第一个遇到的就是最新的，所以不需要再比较时间
}

// $latestMessagesPerUser 现在包含了每个联系人的最新消息
// 如果需要分页，可以在此手动处理数组，或在前端进行分页
$paginatedLatestMessages = collect($latestMessagesPerUser)->values()->paginate(15); // 需要自定义分页器

注意事项： 这种方法会将所有相关消息加载到内存中，对于非常大的数据集可能会有性能问题。在数据量较大时，强烈建议使用数据库层面的解决方案。

总结与最佳实践

优先使用Eloquent关系和Eager Loading： 对于大多数关联数据检索，with()方法是Laravel中最高效、最优雅的解决方案，能有效避免N+1查询问题。
理解GROUP BY的局限性： 除非结合聚合函数或窗口函数，否则GROUP BY不能保证返回每个分组的“最新”或“特定”记录。
针对“每组最新记录”的需求，考虑数据库层面的高级SQL技术： 当需要精确地从每个分组中选择最新记录时，子查询、joinSub或窗口函数（如ROW_NUMBER()）是更健壮的选择。
清晰的字段命名： 在数据库中，使用如created_at和updated_at这样的标准时间戳字段命名，可以更好地利用Laravel的ORM特性，减少配置。如果使用自定义名称（如created），请确保在模型中通过const CREATED_AT = 'created';进行明确定义。
根据数据量选择方案： 对于小到中等规模的数据集，PHP层面的处理可能足够简单；但对于大型生产系统，数据库层面的优化是必不可少的。

通过理解这些原则和

宝塔面板下如何手动修改MySQL的max_connections最大连接数？

宝塔面板怎么关闭不需要的端口_服务器安全优化方法【技巧】

如何在物理机服务器上从零开始搭建宝塔面板运维系统？

如何在PHP中正确显示MySQL存储的图片URL

Hyperf安装Composer依赖怎么管理_Hyperf包安装和更新技巧【教程】