Azure Pipeline中Playwright访问localhost:8000出现NS_ERROR_CONNECTION_REFUSED

核心排查与修复步骤 #

• 修改应用监听地址：本地IIS Express默认绑定localhost，但Azure Pipeline代理环境中，需将应用绑定到0.0.0.0才能让外部进程（Playwright）访问。可修改项目.vs/config/applicationhost.config里的站点绑定为0.0.0.0:8000，或启动时添加参数--urls=http://0.0.0.0:8000。
• 增加启动等待时长：Pipeline中应用启动速度通常慢于本地，Playwright可能在应用未完全就绪时发起请求。在测试代码里添加延迟（如await Task.Delay(5000);），或用Playwright的WaitForURL结合重试逻辑，确保服务就绪后再访问。
• 检查端口占用情况：在Pipeline步骤中执行netstat -ano | findstr :8000，确认8000端口未被其他进程占用，必要时更换端口。
• 禁用Windows Loopback检查：如果用Windows代理，Loopback检查可能阻止本地访问，执行以下命令关闭：

  reg add HKLM\SYSTEM\CurrentControlSet\Control\Lsa /v DisableLoopbackCheck /t REG_DWORD /d 1 /f
  

• 调整Playwright浏览器启动参数：添加--no-sandbox和--disable-dev-shm-usage参数，适配Pipeline的环境权限限制：

  await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions
  {
      Headless = true,
      Args = new[] { "--no-sandbox", "--disable-dev-shm-usage" }
  });
  

• 捕获应用启动日志：在Pipeline中输出应用启动的完整日志，检查是否存在启动失败、地址绑定失败等异常信息。

额外验证手段 #

• 在Pipeline中添加步骤，用curl或PowerShell命令直接访问目标地址，排除Playwright本身的问题：

  Invoke-WebRequest -Uri http://localhost:8000/Operations/Home -UseBasicParsing
  

• 确认应用是独立进程启动：避免应用在测试进程内存中运行，这种情况下Playwright无法通过网络访问。

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