Codeception升级后$I->seeInField需显式指定参数类型如何解决

DevOps 小满

2026-8-30

问题根因

调用seeInField必须传字符串类型的核心原因来自三层升级叠加的类型校验收紧：

PHP版本升级影响：PHP 8.0+版本对带显式类型声明的参数校验逻辑更严格，新版Codeception的WebDriver断言模块给seeInField的期望值参数显式声明了string类型约束，旧版本无类型声明时会自动对int、float、null等标量值做隐式字符串转换，新版本传入非字符串类型会直接抛出类型错误，不会自动转换。
Codeception本身逻辑变更：从4.0版本之后，seeInField的断言比对逻辑从弱类型相等（==）调整为严格类型相等（===），而Selenium从页面输入框抓取到的实际值永远是字符串类型，传入数字、布尔值等非字符串期望值时，哪怕字面量一致，类型不匹配也会判定断言失败。
Selenium组件升级适配：新版php-webdriver/webdriver组件对接W3C标准WebDriver协议后，所有交互值的传递都要求字符串格式，不再自动做非字符串值的兼容转换。

无手动类型转换的兼容方案

不需要每次调用都写strval($val)，选以下任意一种方案即可恢复旧版调用逻辑：

全局覆写Tester类方法（推荐，一劳永逸不影响升级）
在测试项目的AcceptanceTester（对应你使用的测试套件Tester类）中重写seeInField方法，内部统一做类型转换后调用父类原方法，示例代码：
```
public function seeInField($field, $value)
{
    if (is_scalar($value) || is_null($value)) {
        $value = strval($value);
    }
    return parent::seeInField($field, $value);
}
```
同逻辑还可以覆写dontSeeInField等其他同类字段断言方法，统一做类型兼容。
调整模块配置关闭严格类型校验
打开项目根目录的codeception.yml配置文件，找到WebDriver模块的配置段，添加strict_types: false配置项，部分Codeception版本会在该配置关闭后恢复旧版的弱类型自动转换逻辑，示例配置：
```
modules:
    enabled:
        - WebDriver:
            url: 'http://localhost'
            browser: 'chrome'
            strict_types: false
```
检查全局严格模式声明
确认测试启动文件（比如tests/_bootstrap.php）中没有开启全局严格类型声明declare(strict_types=1);，该声明会让PHP对当前文件内的所有函数调用强制做严格类型校验，关闭后即可恢复默认的弱类型参数转换能力。

注意：不要直接修改vendor目录下的Codeception或WebDriver源码实现兼容，后续执行依赖更新时修改会被直接覆盖，长期兼容优先选择Tester类覆写的方案。

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