Laravel 8中关联查询用户表用户名遇报错及结果重复问题

• DB::select() 无论查询结果有多少条，返回值始终是数组：哪怕UUID匹配到唯一用户，返回的也是[ 0 => 用户对象 ]结构，直接用$users->username是在数组上访问对象属性，必然触发非对象报错。
• 之前用select * from videos, users的写法是无关联条件的隐式笛卡尔积，会把两张表的数据两两组合，出现1条视频配2个用户的重复结果属于正常语法表现，不是框架bug。
• 现有查询的where条件存在逻辑优先级错误：SQL中and运算优先级高于or，当前写法实际执行逻辑是title 匹配关键词 或 (描述匹配关键词 且 public=2)，和预期的「标题/描述匹配关键词，且public状态为2」逻辑不一致。

方案1：原生SQL最小改动版 #

如果暂时不想调整现有代码结构，只需要修正取值逻辑、查询条件优先级即可，同时建议用联表查询避免循环执行SQL产生的N+1性能问题：

<?php
// 统一处理关键词，修复where条件优先级
$keyword = "%".request('query')."%";
// 用left join关联用户表，明确关联条件，不会产生重复数据
$videos = DB::select("
    SELECT v.*, u.username AS uploader_name
    FROM videos v
    LEFT JOIN users u ON v.uploader = u.uuid
    WHERE (v.title LIKE ? OR v.description LIKE ?) AND v.public = ?
", [$keyword, $keyword, 2]);

foreach ($videos as $video) {
?>
<div class="video">
    <a href="/video?id={{{ $video->videoid }}}">
        <div class="row">
            <div class="col-12 col-md-3">
                <div class="thumbnail">
                    <span class="duration-mark">4:51</span>
                </div>
            </div>
            <div class="col-12 col-md-9 my-2 my-md-0">
                <h4 class="mb-1">{{{ $video->title }}}</h4>
                <!-- 加空值兜底，避免用户被删除等脏数据场景报错 -->
                <p class="viddesc mb-2">{{{ $video->uploader_name ?? '未知用户' }}} ● {{{ date('Y/m/d', strtotime($video->uploaddate)) }}}</p>
                <p class="viddesc">{{{ $video->description }}}</p>
            </div>
        </div>
    </a>
</div>
<?php
}
?>

如果坚持要在循环中查询用户，只需要取结果数组的首项即可：

$user = DB::select("SELECT username FROM users WHERE uuid = ? LIMIT 1", [$video->uploader])[0] ?? null;

方案2：Eloquent ORM 标准写法（推荐） #

Laravel 8的Eloquent提供了完善的关联能力，不需要手动写SQL即可处理表关联，可维护性更高：

1. 先给Video模型定义上传者关联：

// app/Models/Video.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Video extends Model
{
    // 关联用户表，外键为videos.uploader，关联users.uuid字段
    public function uploader()
    {
        return $this->belongsTo(User::class, 'uploader', 'uuid');
    }
}

2. 查询时用with预加载关联数据，自动解决N+1问题：

<?php
// 控制器层处理查询逻辑，不要直接在视图中写数据库操作
$keyword = "%".request('query')."%";
$videos = Video::with('uploader:uuid,username') // 仅预加载需要的uuid、username字段
    ->where('public', 2)
    ->where(function($query) use ($keyword) {
        // 用闭包包住or条件，保证逻辑优先级正确
        $query->where('title', 'like', $keyword)
              ->orWhere('description', 'like', $keyword);
    })
    ->get();
// 把$videos传递到视图即可

3. 视图中直接调用关联属性取值：

<p class="viddesc mb-2">{{{ $video->uploader->username ?? '未知用户' }}} ● {{{ date('Y/m/d', strtotime($video->uploaddate)) }}}</p>

注意事项 #

• 不要直接使用$_GET/$_POST取请求参数，用Laravel封装的request()助手函数获取参数，框架会自动做基础安全处理。
• 所有关联数据取值都建议加??空值兜底，避免上传用户被删除等脏数据场景触发页面报错。

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