Yii2 Codeception验收测试报错：类名必须是有效对象或字符串

根据你描述的环境和报错信息，这个错误通常和类加载、Codeception配置或者测试代码中的拼写问题有关，我给你梳理几个最可能的排查方向：

1. 先确认是否执行了codecept build #

当你修改了acceptance.suite.yml中的modules配置后，必须重新生成AcceptanceTester类文件，否则Codeception会找不到新增模块的方法或者出现类定义异常。执行以下命令：

codecept build

这一步很多人容易忽略，是验收测试配置变更后的必要操作。

2. 检查PageCest测试代码中的类引用错误 #

报错提示「Class name must be a valid object or a string」，大概率是你的PageCest.php的ensureThatAboutPageWorks方法里，出现了类名拼写错误、未引入类文件，或者调用了不存在的类。比如：

• 模型类名拼写错误（比如AboutPageModel写成了AboutPageModle）
• 使用了未通过use引入的类，直接在方法里调用
• 调用Yii2的组件或模型时，命名空间写错了

建议你仔细检查这个测试方法的代码，或者运行测试时加上详细日志参数，定位具体出错行：

codecept run acceptance PageCest -vv

-vv参数会输出完整的错误堆栈，告诉你哪一行代码导致了这个问题。

3. 验证Yii2模块的配置正确性 #

你的Yii2模块配置里启用了orm和email部分，需要确保：

• config/test.php中的数据库配置是正确的，并且测试数据库可以正常连接。如果ORM模块无法初始化数据库连接，可能会触发类加载相关的异常。
• entryScript: index-test.php确实存在于你的web目录下（也就是控制台显示的/var/www/test/web），并且这个入口文件的配置是正确的，能正常初始化Yii2的测试环境。

4. 排查WebDriver与Chrome版本兼容性 #

虽然你的控制台显示服务器收到了请求，但如果chromedriver和你安装的google-chrome-stable版本不匹配，也可能导致测试过程中出现奇怪的类加载错误。你可以通过以下命令查看Chrome版本：

google-chrome-stable --version

然后确保你安装的chromedriver版本和这个版本完全对应（大版本一致即可，比如Chrome 114对应chromedriver 114.x）。

按照上面的步骤逐一排查，应该能快速定位到问题所在。

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