Playwright E2E测试在Windows Server 2019上无法访问剪贴板求助

一、优先排查Windows Server桌面会话权限 #

Windows剪贴板依赖桌面会话，流水线代理如果以服务模式运行，默认没有桌面环境，会导致所有剪贴板操作失效：

• 把流水线代理的运行方式改成交互式登录（而非系统服务），确保测试运行时有活跃的桌面会话。
• 检查Windows Server本地安全策略：给测试运行账号赋予“剪贴板访问”相关权限（路径：本地策略→用户权限分配）。

二、调整Playwright浏览器启动配置 #

即使已配置权限，浏览器沙箱或无头模式可能限制剪贴板API：

• 启动浏览器时显式启用剪贴板特性，禁用沙箱并最大化窗口（确保页面处于激活状态）：

const browser = await chromium.launch({
  headless: false, // 必须有头模式，无头模式无桌面会话
  args: [
    '--start-maximized',
    '--no-sandbox',
    '--enable-features=Clipboard'
  ],
  permissions: ['clipboard-read', 'clipboard-write']
});

• 调用剪贴板API前，确保页面处于前台：

await page.bringToFront();
const clipboardText = await page.evaluate(() => navigator.clipboard.readText());

三、E2E测试专用替代方案（绕过系统剪贴板） #

如果只是验证业务逻辑，无需真的访问系统剪贴板，可以直接模拟剪贴板数据：

• 在页面上下文注入模拟的剪贴板方法：

// 预设剪贴板内容
await page.evaluate((mockText) => {
  navigator.clipboard.readText = async () => mockText;
}, '预设的粘贴内容');

// 执行粘贴操作
await page.click('#paste-btn');
// 验证粘贴结果
await expect(page.locator('#result')).toHaveText('预设的粘贴内容');

• 用键盘模拟替代剪贴板操作（适合简单场景）：

await page.bringToFront();
await page.focus('#input-box');
await page.keyboard.press('Control+V');

四、node-clipboardy权限问题处理 #

• 确保测试运行账号拥有本地管理员权限，或在本地安全策略中给账号添加“访问剪贴板”权限。
• 必须在有头模式下使用node-clipboardy，无头环境下无法访问系统剪贴板。

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