本文详解yii2框架中因变量名不匹配导致`$product`在视图中为`null`的典型问题，重点说明`compact()`与数组键名映射的关系，并提供安全、清晰的参数传递方案。
在Yii2开发中，控制器向视图传递数据看似简单，却常因变量命名与模板接收方式不一致而引发静默失败——例如调用 var_dump($product) 返回 NULL。根本原因并非模型查询失败，而是视图中访问的变量名与render()实际注入的键名不匹配。
回顾原始代码：
// Controller 中使用 compact('product')
return $this->render('index', compact('product'));compact('product') 等价于 ['product' => $product]，即向视图注入了一个键名为 'product' 的数组元素。因此，视图中必须直接使用 $product 变量名才能正确访问。
但问题中的视图却写了：
<?php var_dump($product); die; ?>
这本身语法无误——那为何输出 NULL？关键在于：开发者很可能在视图顶部添加了 PHPDoc 注解或手动声明了变量类型，却未同步更新变量名，例如错误地写成：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
/* @var $productModel ProductList[] */ var_dump($product); // ← 此处仍用 $product，但上方注解暗示应使用 $productModel
更常见的情况是：开发者修改了注解（如 @var $productModel ...），却忘记将后续所有 $product 替换为 $productModel，导致逻辑混乱。
✅ 正确且推荐的做法是显式构造关联数组，避免依赖 compact() 的隐式键名推导：
// SliderController.php
public function actionIndex()
{
$products = ProductList::find()->all(); // 建议使用复数名体现集合语义
return $this->render('index', [
'products' => $products // 明确键名，语义清晰
]);
}对应视图 index.php 中应严格匹配该键名：
<?php
/* @var $this yii\web\View */
/* @var $products app\models\ProductList[] */
use yii\helpers\Html;
if (empty($products)) {
echo '<p class="text-muted">暂无商品</p>';
} else {
foreach ($products as $product) {
echo Html::tag('div',
Html::encode($product->name ?? 'N/A') . ' - ' .
Html::tag('span', '$' . ($product->price ?? 0), ['class' => 'price']),
['class' => 'product-item']
);
}
}
?>? 重要注意事项：
- compact() 仅生成键值对，不改变变量作用域；视图中变量名必须与 compact() 参数字符串完全一致；
- 使用 /* @var $varName Type */ 注解时，$varName 必须与实际传入的键名一致，否则 PHPStorm 等 IDE 类型提示失效，且易引发逻辑错误；
- 建议在控制器中采用语义化键名（如 products 而非 product），并在视图中通过注解明确声明类型和数组结构（ProductList[]）；
- 永远在视图中校验数据存在性（如 isset($products) 或 !empty($products)），避免因查询为空导致渲染异常。
通过显式数组传递 + 严格命名对齐 + 类型注解，可彻底规避此类“数据为NULL”的低级陷阱，提升代码可读性与可维护性。
