如何使用 Playwright 对 .NET 微服务进行 E2E 测试？

来源：这里教程网时间：2026-02-21 17:27:16 作者：

对 .NET 微服务进行端到端（E2E）测试时，Playwright 主要用于验证通过 HTTP 接口暴露的 Web API 或前端界面是否按预期工作。虽然 Playwright 是为浏览器自动化设计的，但它也能高效地与后端服务交互，特别是当你的微服务提供 RESTful API 或承载前端应用时。

理解测试场景

Playwright 并不直接测试 .NET 业务逻辑或内部组件，而是从外部模拟用户行为或客户端调用。典型使用场景包括：

测试由 ASP.NET Core 托管的前端页面（如 Blazor、Razor Pages） 调用微服务暴露的 REST API 端点 验证身份认证流程（如 OAuth 登录） 确保多个服务协同工作（例如前端调用订单服务 + 用户服务）

启动本地服务并运行测试

在执行 Playwright 测试前，需要确保目标 .NET 微服务正在运行。推荐在测试开始时自动启动服务。

使用 Node.js 的 child_process 在测试前启动
dotnet run
等待服务端口就绪后再执行请求 测试结束后自动关闭进程

示例代码（TypeScript）：

import { chromium } from '@playwright/test';
import { exec } from 'child_process';
<p>// 启动 .NET 服务
const server = exec('dotnet run --project ./MyApiService');</p><p>server.stdout?.on('data', (data) => {
if (data.includes('Now listening on')) {
console.log('服务已启动');
runTests();
}
});</p><p>async function runTests() {
const browser = await chromium.launch();
const page = await browser.newPage();</p><p>// 调用 API 示例
const response = await page.request.get('<a href="https://www.php.cn/link/ac0d7b02669d3fc473a8a11232e89d82">https://www.php.cn/link/ac0d7b02669d3fc473a8a11232e89d82</a>');
const users = await response.json();
console.log(users);</p><p>await browser.close();
server.kill();
}</p>

编写结构化 E2E 测试用例

利用 @playwright/test 提供的测试框架组织测试逻辑。

使用
test.describe()
分组不同模块的测试通过
page.request
发送 GET/POST 请求 断言响应状态码和数据结构

示例测试片段：

import { test, expect } from '@playwright/test';
<p>test('应能创建新订单', async ({ request }) => {
const response = await request.post('<a href="https://www.php.cn/link/7cbeb964f1961a132a36052748a10320">https://www.php.cn/link/7cbeb964f1961a132a36052748a10320</a>', {
data: {
productId: '123',
quantity: 2
}
});</p><p>expect(response.ok()).toBeTruthy();
const result = await response.json();
expect(result.status).toBe('created');
});</p>

集成到 CI/CD 流程

在 GitHub Actions 或 Azure Pipelines 中运行这些测试。

安装 .NET SDK 还原依赖并构建项目：
dotnet restore && dotnet build
后台启动服务并运行 Playwright 测试

GitHub Actions 片段示例：

- name: Setup .NET
  uses: actions/setup-dotnet@v3
  with:
    dotnet-version: '7.0.x'
<ul><li><p>name: Build
run: dotnet build</p></li><li><p>name: Run Playwright tests
run: |
dotnet run --project MyApi & &
sleep 10
npx playwright test</p>

基本上就这些。关键是把 Playwright 当作“智能客户端”，让它驱动浏览器或直接调用 API 来验证整个系统行为。只要服务能响应 HTTP 请求，就能被 Playwright 测试覆盖。