Epic Stack项目中的Playwright测试URL验证问题解析

问题背景

在Epic Stack项目的持续集成测试过程中，发现了一个关于Playwright测试框架的URL验证问题。测试用例期望页面停留在/signup路由，但实际上却跳转到了根路径/，导致测试失败。

错误详情

测试用例在执行用户注册流程时，预期在GitHub OAuth认证完成后应保持在注册页面，但实际结果却是重定向到了首页。测试框架抛出了以下关键错误信息：

Error: Timed out 5000ms waiting for expect(locator).toHaveURL(expected)
Locator: locator(':root')
Expected string: "http://localhost:3000/signup"
Received string: "http://localhost:3000/"

技术分析

1. 测试流程：测试模拟了用户通过GitHub OAuth认证后完成注册的流程
2. 预期行为：认证完成后应保持在注册页面，显示"thanks for signing up"消息
3. 实际行为：系统将用户重定向到了应用首页
4. 重定向路径：中间曾短暂经过/onboarding/github?redirectTo=%2Fsignup路径

问题根源

这个问题源于路由重定向逻辑的一个小错误。虽然测试注释中明确指出"没有指定redirectTo参数"，但实际上系统在处理OAuth回调时可能自动添加了默认的重定向行为，导致用户最终被导向了首页而非预期的注册页面。

解决方案

项目维护者迅速定位并修复了这个问题。修正方案包括：

1. 确保OAuth回调后正确处理referrer信息
2. 在没有明确redirectTo参数时，确实保持在原始注册页面
3. 验证感谢消息的正确显示逻辑

经验总结

这个案例展示了端到端测试中常见的路由验证问题。在身份认证流程测试中，特别需要注意：

1. 重定向链的完整验证
2. 查询参数的正确处理
3. 测试等待时间的合理设置
4. 预期状态与实际状态的精确匹配

对于类似的前端测试场景，开发人员应当仔细检查：

• 路由守卫逻辑
• 认证后的重定向策略
• 测试环境的URL处理一致性

通过这个问题的解决，Epic Stack项目的测试可靠性得到了进一步提升，为后续开发奠定了更坚实的基础。