Docker容器中PlayWright HTML报告服务无法正常运行问题

问题原因 #

Playwright默认将报告服务绑定到127.0.0.1（容器内部的localhost），而Docker端口映射仅能将主机请求转发到容器的公开网络接口，容器内部的127.0.0.1仅允许本地访问，导致主机侧请求无法触达报告服务，返回空响应。

解决方案 #

方法1：启动报告服务时指定监听所有地址 #

执行测试后手动启动报告服务，通过--host参数指定服务监听容器的所有网络接口：

npx playwright show-report --host 0.0.0.0

若希望测试失败后自动启动带正确绑定的报告服务，可直接修改测试命令：

npx playwright test --show-report --host 0.0.0.0

方法2：确保Docker端口映射配置正确 #

启动容器时，必须明确将主机9323端口映射到容器的同端口：

docker run -p 9323:9323 [你的容器名/镜像名]

方法3：集成到项目启动脚本（持久化配置） #

在项目的package.json中添加预配置好的测试脚本，避免每次手动输入参数：

{
  "scripts": {
    "test": "playwright test --show-report --host 0.0.0.0"
  }
}

后续在容器内执行npm run test即可自动按正确方式启动测试及报告服务。

验证 #

完成上述配置后，重新运行测试流程，当测试失败触发报告服务时，访问http://localhost:9323即可正常加载测试报告页面。

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