自动化测试点击注册按钮后触发等待事件超时TimeoutError问题咨询

问题成因 #

• 事件监听顺序错误：先执行page.click(btnSignUp)触发请求，再启动page.waitForResponse监听，若注册请求在监听启动前就已完成，监听逻辑会无法捕获已结束的请求，最终触发超时，这是该场景下最常见的原因。
• 接口URL匹配规则过严：实际请求的URL可能存在查询参数、尾部斜杠差异，或是apiURL拼接后与实际请求地址不完全一致，比如实际请求为apiURL + '/register/'多了尾部斜杠、带了?t=时间戳类的动态参数，全等匹配就会失效。
• 跨域预检请求干扰：若注册接口为跨域请求，浏览器会先发送OPTIONS预检请求，匹配逻辑若未过滤请求方法，可能匹配到预检请求后未继续匹配实际的业务POST请求，导致等待不到目标响应。
• 重定向导致请求终止：点击注册后页面立即触发重定向，可能导致未完成的注册请求被浏览器主动终止，waitForResponse无法拿到正常结束的响应对象。

排查方案 #

• 调整事件监听顺序：将page.waitForResponse的监听逻辑放到点击操作之前，确保请求发出前就已启动监听，修改后代码参考：

const responsePromise = page.waitForResponse(
  (response) => response.url() === apiURL + '/register',
  { timeout: 30 * 1000 }
)
await page.click(btnSignUp)
const response = await responsePromise
const responseData = await response.json()

• 放宽URL匹配规则：将全等匹配改为包含匹配，同时打印所有捕获到的请求地址，确认匹配规则是否合理：

const responsePromise = page.waitForResponse((response) => {
  console.log('捕获请求地址：', response.url())
  return response.url().includes('/register') && response.request().method() === 'POST'
}, { timeout: 30 * 1000 })

• 验证重定向影响：可以临时监听页面跳转事件，确认是否是重定向时机早于请求响应导致的问题：

page.on('framenavigated', (frame) => {
  console.log('页面跳转至：', frame.url())
})

• 临时拉长超时时间：将超时阈值调整到60秒以上，排除是网络波动导致的响应过慢问题。

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