本文详解如何在 yii2 rest api 中通过 innerjoinwith 精确获取含匹配产品的分类，并实现无需手动指定 expand=products 即自动加载关联产品列表。
本文详解如何在 yii2 rest api 中通过 innerjoinwith 精确获取含匹配产品的分类，并实现无需手动指定 expand=products 即自动加载关联产品列表。
在 Yii2 REST API 开发中，当需要基于关联模型（如 Product）的字段（如 name）筛选主模型（如 Category），并仅返回实际包含匹配数据的分类及其对应产品时，单纯使用 with() 会导致“全量主表 + 空关联”的低效结果——这正是你遇到的问题：所有分类都被返回，但 products 数组为空。
根本原因在于：with() 执行的是 LEFT JOIN 或独立子查询，它先查出全部 Category，再按条件查 Product，但不会过滤掉没有匹配产品的分类。要实现「仅返回有匹配产品的分类」，必须改用 innerJoinWith()，它通过 INNER JOIN 强制关联存在性，天然完成数据过滤。
✅ 正确写法：使用 innerJoinWith 实现精准关联筛选
修改你的 actionSearchProductsByTerm() 方法如下：
public function actionSearchProductsByTerm()
{
$term = Yii::$app->request->get('term');
if (empty($term)) {
throw new BadRequestHttpException('Missing "term" parameter.');
}
return new ActiveDataProvider([
'query' => Category::find()
->innerJoinWith([
'products' => function ($query) use ($term) {
$query->andWhere(['like', 'product.name', $term]); // 注意：显式指定表别名避免歧义
}
])
->distinct(), // 防止因一对多导致重复分类（重要！）
'pagination' => [
'pageSize' => self::ITEMS_PER_PAGE,
],
'sort' => [
'defaultOrder' => [
'id' => SORT_ASC,
],
],
]);
}⚠️ 关键点说明：
- innerJoinWith() 替代 with()，确保只返回至少有一个匹配 Product 的 Category；
- 使用 product.name（假设 Product 表别名为 product）而非 name，避免字段歧义（尤其当 Category 也有 name 字段时）；
- 必须添加 ->distinct()，否则一个分类下多个匹配产品会导致该分类在结果中重复出现多次；
- use ($term) 显式捕获变量，确保闭包内可安全访问。
✅ 自动展开 products：避免每次请求都加 expand=products
Yii2 REST 序列化器默认不会加载 with() 或 innerJoinWith() 中声明的关联数据（除非显式 expand）。要让 products 总是被序列化，有两种推荐方式：
方案一：在 Category 模型中重写 fields()（简单直接，适用于该场景专属）
// api/modules/v1/models/Category.php
public function fields()
{
$fields = parent::fields();
// 仅在此 API 场景下强制包含 products；也可加条件判断（如仅当 isSearchResult === true）
$fields['products'] = 'products';
return $fields;
}✅ 优点：代码简洁，效果立竿见影；
❗ 注意：此方式会使 所有 Category 序列化场景（包括其他 API 或后台调用）都加载 products，若存在性能敏感场景，需谨慎评估。
方案二：动态注入 expand 参数（更灵活、无副作用）
在控制器中提前设置 expand，不影响全局行为：
public function actionSearchProductsByTerm()
{
$term = Yii::$app->request->get('term');
if (empty($term)) {
throw new BadRequestHttpException('Missing "term" parameter.');
}
// 动态追加 expand=products（兼容已存在的 expand 参数）
$queryParams = Yii::$app->request->getQueryParams();
$expand = isset($queryParams['expand']) ? explode(',', $queryParams['expand']) : [];
if (!in_array('products', $expand)) {
$expand[] = 'products';
$queryParams['expand'] = implode(',', $expand);
Yii::$app->request->setQueryParams($queryParams);
}
return new ActiveDataProvider([
'query' => Category::find()
->innerJoinWith([
'products' => function ($query) use ($term) {
$query->andWhere(['like', 'product.name', $term]);
}
])
->distinct(),
'pagination' => ['pageSize' => self::ITEMS_PER_PAGE],
]);
}✅ 优点：精准控制，仅影响当前动作；无模型侵入性；支持与用户传入的其他 expand 参数共存；
? 提示：可进一步封装为 setExpand() 工具方法提升复用性。
? 补充建议：优化关联定义与查询性能
-
确认关系定义正确（Category.php）：
public function getProducts() { return $this->hasMany(Product::class, ['id' => 'product_id']) ->viaTable('product_category', ['category_id' => 'id']); } -
添加数据库索引：
ALTER TABLE `product` ADD INDEX `idx_product_name` (`name`);
考虑分页粒度：若单个分类匹配产品过多，innerJoinWith 可能导致结果集膨胀，此时可改用「先查产品再反查分类」的两步策略（适用于产品总数可控场景）。
通过以上调整，你的 API 将精准返回：
✅ 仅含 name LIKE '%iphone%' 产品的分类；
✅ 每个分类下附带匹配的产品列表；
✅ 无需客户端手动传 expand=products；
✅ 响应结构清晰、性能可控、符合 REST 最佳实践。
