迁移Yii2站点至Cloudways后调用Yii::$app->user报"Undefined variable: user"错误

近期将多个Yii2站点迁移至Cloudways平台，服务器运行PHP7.4版本（暂不升级PHP8），出现异常：每次调用Yii::$app->user->[任意属性/方法]时，都会触发**"Undefined variable: user"**错误，即使用户已登录，Yii::$app->user->isAdmin、Yii::$app->user->isGuest等功能也无法正常使用。

排查方向 #

• 组件与模块命名冲突：配置中同时注册了名为user的自定义组件（app\components\User）和user模块（dektrium\user\Module），Yii2的DI容器可能因命名冲突导致组件实例化异常。可先临时注释掉user模块配置，测试是否能正常调用Yii::$app->user，确认是否为命名冲突问题。
• 自定义User组件递归调用问题：app\components\User的getUsername()、getName()方法中，直接调用Yii::$app->user->identity，但当前类本身就是user组件的实现，会触发递归调用，导致变量未初始化错误。应改为使用$this->identity替代，示例：

  public function getUsername()
  {
      return $this->identity->username;
  }
  

• Session/Cookie配置异常：Cloudways服务器可能存在Session存储路径权限问题，或Cookie域名、路径配置不符合当前站点环境。检查web.php中session组件的savePath是否存在且有读写权限，同时确认Cookie的domain、path配置正确性。
• Dektrium User模块兼容性：确认使用的dektrium/user版本是否兼容PHP7.4和当前Yii2版本。部分旧版本模块可能在PHP7.4下存在隐性变量未定义错误，可查看模块官方issue或尝试更新至兼容版本（注意备份数据）。
• PHP扩展与初始化顺序：检查Cloudways的PHP配置是否禁用了Yii2依赖的扩展（如session、mbstring等），同时确认Yii2应用初始化流程中，user组件是否在其他依赖组件前完成初始化。

相关配置与代码 #

web.php组件配置 #

'components' => [
    'user' => [
        'identityClass' => 'app\models\User',
        'class' => 'app\components\User', // extend User component
        'enableAutoLogin' => true,
    ],

web.php模块配置 #

'modules' => [
    'user' => [
        'class' => 'dektrium\user\Module',
        'enableUnconfirmedLogin' => true,
        'cost' => 12,
        'rememberFor' => 1209600,
        'admins' => ['xxxxx','xxxxx'],
        'modelMap' => [
            'User' => 'app\models\User',
            'RegistrationForm' => 'app\models\RegistrationForm',
        ],
    ],

/components/User.php代码 #

class User extends \yii\web\User
{
    public function getUsername()
    {
        return Yii::$app->user->identity->username;
    }

    public function getName()
    {
        return Yii::$app->user->identity->name;
    }

    public function getIsAdmin()
    {
        $roles = Yii::$app->authManager->getRolesByUser(Yii::$app->user->getId());
        return in_array('admin',array_keys($roles));
    }
}

/models/User.php代码 #

class User extends BaseUser
{

    public function getUsername()
    {
        return $this->profile->name;
    }

    public function getAuthorname()
    {
        return $this->getUsername();
    }

    public function getAvatar()
    {
        return $this->profile->getAvatarUrl(75);
    }

    public static function findIdentityByAccessToken($token, $type = null)
    {
        return static::findOne(['access_token' => $token]);
    }

    public function beforeSave($insert)
    {
        if (parent::beforeSave($insert)) {
            if ($this->isNewRecord) {
                $this->auth_key = \Yii::$app->security->generateRandomString();
            }
            return true;
        }
        return false;
    }
}

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