Yii2导航添加新标签后登出功能报错：缺少label选项

问题根源 #

你大概率是在构建导航项时，错误地将「登录」「注册」项嵌套进了同一个数组中，导致导航组件解析时把嵌套数组当作单个导航项处理，找不到必填的label参数，进而触发报错。比如这种错误写法：

'items' => [
    ['label' => '首页', 'url' => ['/site/index']],
    // 错误：将两个项放在同一个数组里返回
    Yii::$app->user->isGuest ? [
        ['label' => '登录', 'url' => ['/site/login']],
        ['label' => '注册', 'url' => ['/site/signup']],
    ] : [
        ['label' => '退出', 'url' => ['/site/logout'], 'linkOptions' => ['data-method' => 'post']],
    ],
]

正确实现方式 #

推荐用分步构建数组的方式，逻辑更清晰，避免嵌套错误：

<?php
use yii\bootstrap5\Nav;

// 初始化基础导航项
$navItems = [
    ['label' => '首页', 'url' => ['/site/index']],
];

// 根据登录状态添加对应项
if (Yii::$app->user->isGuest) {
    $navItems[] = ['label' => '登录', 'url' => ['/site/login']];
    $navItems[] = ['label' => '注册', 'url' => ['/site/signup']];
} else {
    $navItems[] = [
        'label' => '退出 (' . Yii::$app->user->identity->username . ')',
        'url' => ['/site/logout'],
        'linkOptions' => ['data-method' => 'post'] // 登出必须用POST请求
    ];
}

// 渲染导航组件
echo Nav::widget([
    'options' => ['class' => 'navbar-nav navbar-right'],
    'items' => $navItems,
]);
?>

如果坚持用三元运算，需确保每个分支返回单个导航项或空值：

echo Nav::widget([
    'options' => ['class' => 'navbar-nav navbar-right'],
    'items' => [
        ['label' => '首页', 'url' => ['/site/index']],
        Yii::$app->user->isGuest ? ['label' => '登录', 'url' => ['/site/login']] : '',
        Yii::$app->user->isGuest ? ['label' => '注册', 'url' => ['/site/signup']] : '',
        !Yii::$app->user->isGuest ? [
            'label' => '退出 (' . Yii::$app->user->identity->username . ')',
            'url' => ['/site/logout'],
            'linkOptions' => ['data-method' => 'post']
        ] : '',
    ],
]);

关键注意点 #

• Nav组件的items参数要求每一项都是一维数组，不能嵌套数组
• 登出项必须设置data-method为post，否则Yii2默认的登出动作会拒绝请求

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