升级Next.js版本后无法运行Playwright测试求助

算力阿峰

2026-8-26

解决Next.js升级后Playwright命令--config参数报错问题

排查Playwright CLI调用来源：Next.js 12.2.x升级时可能自动更新了项目内Playwright依赖版本，或改变了yarn的命令解析优先级，导致你执行的playwright命令并非项目本地安装的版本。可以分别执行npx playwright --version和playwright --version对比版本差异，若不一致，改用npx playwright test --config=test/e2e/playwright.config.ts强制调用项目本地的Playwright。
调整环境变量设置方式：原命令中yarn env PWDEBUG=console && playwright test...的写法可能让环境变量仅作用于第一个命令，后续playwright命令未继承环境变量且可能触发解析异常。建议改为将环境变量前置到命令前：
```
PWDEBUG=console yarn playwright test --config=test/e2e/playwright.config.ts
```
这样既保证环境变量生效，也能让yarn正确解析项目本地的Playwright命令。
检查版本兼容性：Next.js 12.2.x对内置测试工具链做了调整，可能和你当前使用的Playwright版本存在兼容冲突。可以尝试将Playwright升级到与Next.js 12.2.x匹配的版本（如Playwright 1.24+），或查看项目package.json中Next.js自动添加的测试脚本，改用脚本执行（比如yarn test:e2e）避免参数冲突。
验证配置文件：确认test/e2e/playwright.config.ts存在且格式符合对应Playwright版本要求，新版本Playwright对配置文件结构有细微调整，若配置未同步更新也可能触发异常提示。