Codeception配置异常：PHPBrowser未访问localhost而是局域网未知服务器

我之前在配置Yii1和YiiBridge的Codeception测试时也碰到过完全一样的问题！PHPBrowser莫名其妙跑去访问局域网里的其他机器，根本不鸟localhost，折腾了好一阵才搞定，给你几个关键的排查和修复方向：

1. 检查Codeception测试套件的PHPBrowser配置 #

首先看你的测试套件配置文件（比如acceptance.suite.yml或者functional.suite.yml），确保PHPBrowser模块明确指定了正确的本地URL。配置应该类似这样：

modules:
    enabled:
        - Yii1
        - PHPBrowser:
            url: 'http://localhost/your-yii-app-root/' # 这里必须是你本地应用的正确地址
            # 可选：如果用了非默认端口，比如8080，要加上端口号

如果url参数留空或者填成了局域网内的其他地址，PHPBrowser自然会跑偏。

2. 修正YiiBridge的baseUrl配置 #

YiiBridge的配置文件（通常在codeception/config/yiibridge.php）里的baseUrl是核心，它会直接影响PHPBrowser的访问目标。打开这个文件，确认配置：

return [
    'baseUrl' => 'http://localhost/your-yii-app-root/',
    // 其他Yii相关配置（比如appPath、configFile等）
];

这个地址必须和你本地运行Yii应用的地址完全一致，包括端口号（如果有的话）。

3. 确认本地服务器的监听地址 #

如果你用的是Apache、Nginx或者PHP内置服务器，要确保服务器是绑定在127.0.0.1或localhost上，而不是直接监听局域网IP（比如192.168.x.x）。举个例子，用PHP内置服务器启动时，要明确指定地址：

php -S localhost:8080

而不是php -S 0.0.0.0:8080（后者会让服务器在局域网可见，可能导致Codeception解析到局域网IP）。

4. 清除Codeception缓存并重建配置 #

有时候旧的配置缓存会导致参数不生效，执行以下命令重置：

codecept clean
codecept build

这会清空缓存并重新生成测试模块的配置，确保新的URL设置生效。

额外调试技巧 #

如果还是不确定问题在哪，可以在你的测试方法里加一行调试代码，输出PHPBrowser实际使用的基础URL：

echo $I->getModule('PHPBrowser')->client->getBaseUrl();
die;

运行测试后就能看到PHPBrowser到底在访问哪个地址，再针对性调整配置。

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