Yii2高级版后端Codeception单元测试报错，前端测试正常求助

我按照官方教程配置了Codeception，执行codecept run命令后前端测试完全没问题，但后端测试一直报错。用的是完全默认的Yii2-advanced模板，已经确认user表存在，前后端也都把YII_ENV设置成了test。登录表单是放在根目录common文件夹里的，代码如下：

<?php
namespace common\models;
use Yii;
use yii\base\Model;
/**
 * Login form
 */
class LoginForm extends Model
{
    public $username;
    public $password;
    public $rememberMe = true;
    private $_user;
    /**
     * {@inheritdoc}
     */
    public function rules()
    {
        return [
            // username and password are both required
            [['username', 'password'], 'required'],
            // rememberMe must be a boolean value
            ['rememberMe', 'boolean'],
            // password is validated by validatePassword()
            ['password', 'validatePassword'],
        ];
    }
    /**
     * Validates the password.
     * This method serves as the inline validation for password.
     *
     * @param string $attribute the attribute currently being validated
     * @param array $params the additional name-value pairs given in the rule
     */
    public function validatePassword($attribute, $params)
    {
        if (!$this->hasErrors()) {
            $user = $this->getUser();
            if (!$user || !$user->validatePassword($this->password)) {
                $this->addError($attribute, 'Incorrect username or password.');
            }
        }
    }
    /**
     * Logs in a user using the provided username and password.
     *
     * @return bool whether the user is logged in successfully
     */
    public function login()
    {
        if ($this->validate()) {
            return Yii::$app->user->login($this->getUser(), $this->rememberMe ? 3600*24*30 : 0);
        }
        return false;
    }
    /**
     * Finds user by [[username]]
     *
     * @return User|null
     */
    protected function getUser()
    {
        if ($this->_user === null) {
            $this->_user = User::findByUsername($this->username);
        }
        return $this->_user;
    }
}

可能的排查方向和解决方案 #

作为经常折腾Yii2和Codeception的开发者，给你几个实际踩坑后总结的排查点：

• 先确认测试数据库的状态
  后端测试用的是test环境的独立数据库，你得检查common/config/test-local.php里的数据库配置是不是指向了正确的测试库，而且这个库必须执行过迁移命令：yii migrate --env=test。很多时候开发者忘了同步测试库的表结构，导致模型找不到字段或者无法查询数据，这是最常见的坑。

• 测试用户数据必须到位
  你的LoginForm验证依赖真实存在的用户，测试环境的user表里有没有创建对应的测试用户？如果是手动插入的，记得密码必须是用Yii的哈希函数生成的：Yii::$app->security->generatePasswordHash('你的测试密码')，明文密码肯定过不了validatePassword那关。更规范的做法是用Codeception的Fixture模块，在测试前自动加载预设的用户数据，避免手动维护测试数据的麻烦。

• 检查后端测试的配置文件
  看看tests/backend/codeception.yml或者tests/backend/config/test.php里是不是正确加载了common模块的配置，有没有初始化好Yii的test环境。有时候后端测试的配置没有正确关联common的数据库组件，导致模型无法正常连接数据库，自然会报错。

• 开启调试看具体错误
  把测试环境的调试模式打开，在common/config/test.php里设置YII_DEBUG = true，然后重新运行codecept run，这样就能看到具体的错误栈信息了——是数据库连接失败？还是用户找不到？或者是User模型的findByUsername方法有问题？模糊的报错信息没用，具体的错误细节才是定位问题的关键。

• 排查User模型的关联问题
  你的LoginForm里调用了User::findByUsername，确认common/models/User.php里存在这个方法，而且方法逻辑是正确的（比如是不是按username字段查询，有没有软删除之类的过滤条件导致找不到用户）。如果User模型里的这个方法有问题，LoginForm自然拿不到用户实例，就会触发密码错误的提示。

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