获取 Laravel 中广告及其多图的一次性查询与结构化处理

本文介绍如何在 laravel 8 + mysql 环境下，通过单条 sql 查询高效获取每条广告（`my_ads`）及其关联的所有图片路径（`ads_images`），并最终组织为含图片数组的嵌套结构，避免 n+1 查询和手动循环拼接。

在实际开发中，常需将一对多关系（如一条广告对应多张图片）聚合为「主记录 + 子数组」的 JSON 友好结构。原方案使用两次独立查询再嵌套遍历，不仅性能低下（N+1 问题），且逻辑冗余。MySQL 原生不支持直接返回 JSON 数组字段，但可通过 GROUP_CONCAT() 配合 Laravel 的集合处理，实现一次查询、结构清晰、易于扩展的目标。

✅ 推荐方案：GROUP_CONCAT + Laravel 集合映射

使用 LE

FT JOIN（而非 INNER JOIN）确保即使某广告无图片也能被查出（空数组而非丢失记录），配合 GROUP_CONCAT 将同一广告的所有图片路径拼接为逗号分隔字符串：

$adsWithImages = DB::table('my_ads as m')
    ->select(
        'm.id',
        'm.title',
        'm.gender',
        'm.country',
        'm.user_id',
        'm.created_at',
        DB::raw("GROUP_CONCAT(a.image_path SEPARATOR '|||') as image_paths")
    )
    ->leftJoin('ads_images as a', 'm.id', '=', 'a.my_ads_id')
    ->groupBy('m.id', 'm.title', 'm.gender', 'm.country', 'm.user_id', 'm.created_at')
    ->get()
    ->map(function ($item) {
        $item->image_paths = !empty($item->image_paths)
            ? explode('|||', $item->image_paths)
            : [];
        return $item;
    });

? 关键说明：使用 ||| 作为分隔符（而非默认逗号），可避免图片路径中含英文逗号导致 explode() 错误解析；LEFT JOIN 保证无图广告仍保留，image_paths 为空数组；GROUP BY 必须包含所有非聚合字段（Laravel 8 + MySQL 5.7+ 严格模式要求）；map() 在集合层面完成字符串→数组转换，语义清晰且不影响数据库查询效率。

⚠️ 注意事项与优化建议

• 长度限制：GROUP_CONCAT 默认最大长度为 1024 字符（由 group_concat_max_len 系统变量控制）。若单条广告图片过多或路径过长，需提前调整：

  SET SESSION group_concat_max_len = 1000000;

  （可在查询前通过 DB::statement() 执行）

• 性能提示：为 ads_images.my_ads_id 添加索引可显著提升 JOIN 效率：

  ALTER TABLE ads_images ADD INDEX idx_my_ads_id (my_ads_id);

• 替代方案（MySQL 5.7+）：若需原生 JSON 数组输出，可用 JSON_AGG()（MySQL 8.0.1+）或 JSON_ARRAYAGG()：

  DB::raw('JSON_ARRAYAGG(a.image_path) as image_paths')

  但需注意：Laravel 8 默认 MySQL 驱动对 JSON 字段返回为字符串，需 json_decode() 处理；且低版本 MySQL 不支持。

✅ 最终输出结构验证

上述代码执行后，$adsWithImages 即为符合预期的集合：

[
  (object)[
    'id' => 35,
    'title' => 'NOman Javed',
    'gender' => 'male',
    'country' => 'Pakistan',
    'user_id' => 1,
    'created_at' => '2025-02-18 10:35:49',
    'image_paths' => [
      '1645180558-Screenshot-(527).png',
      '1645180562-Screenshot-(528).png',
      '1645180564-Screenshot-(529).png'
    ]
  ],
  // ... 其他广告
]

此方案兼顾兼容性、可读性与性能，是 Laravel 中处理一对多聚合展示的经典实践。