浏览器启动问题排查

发布时间: 2025-03-27 19:22

↑

# 浏览器启动问题排查

本文将详细介绍如何排查和解决Playwright中的浏览器启动问题，帮助你确保测试环境的正常运行。

## 常见问题

### 1. 启动失败

```typescript
// 错误：无法启动浏览器
try {
  const browser = await chromium.launch();
} catch (error) {
  console.error('浏览器启动失败:', error);
  
  // 检查错误类型
  if (error.message.includes('Failed to launch browser')) {
    // 检查系统依赖
    await checkSystemDependencies();
    // 重新安装浏览器
    await chromium.install();
  }
}

// 系统依赖检查
async function checkSystemDependencies() {
  const { execSync } = require('child_process');
  try {
    // 检查Chrome依赖
    execSync('ldd $(which google-chrome)');
  } catch (error) {
    console.error('缺少系统依赖');
  }
}
```

### 2. 权限问题

```typescript
// 错误：权限不足
try {
  const browser = await chromium.launch();
} catch (error) {
  if (error.message.includes('Permission denied')) {
    console.error('浏览器权限不足，请检查：');
    console.error('1. 浏览器安装目录权限');
    console.error('2. 缓存目录权限');
    console.error('3. 临时文件目录权限');
  }
}

// 修复权限
async function fixPermissions() {
  const { execSync } = require('child_process');
  try {
    execSync('sudo chmod -R 755 ~/.cache/ms-playwright');
  } catch (error) {
    console.error('权限修复失败:', error);
  }
}
```

## 环境配置

### 1. 系统要求

```typescript
// 检查系统环境
class SystemChecker {
  static async checkEnvironment() {
    const checks = {
      os: process.platform,
      arch: process.arch,
      node: process.version,
      memory: os.totalmem() / 1024 / 1024 / 1024
    };

console.log('系统信息:', checks);

// 验证系统要求
    if (checks.memory < 2) {
      console.warn('警告：系统内存不足2GB');
    }

return checks;
  }
}
```

### 2. 浏览器配置

```typescript
// 优化浏览器配置
const browser = await chromium.launch({
  // 启动参数
  args: [
    '--no-sandbox',
    '--disable-setuid-sandbox',
    '--disable-dev-shm-usage',
    '--disable-gpu'
  ],
  
  // 环境变量
  env: {
    ...process.env,
    PLAYWRIGHT_BROWSERS_PATH: '0'
  },
  
  // 下载选项
  downloadPath: './downloads',
  
  // 超时设置
  timeout: 30000
});
```

## 调试技巧

### 1. 启动调试

```typescript
// 启用调试日志
class BrowserDebugger {
  static async launchWithDebug() {
    try {
      // 设置调试环境变量
      process.env.DEBUG = 'pw:browser*';
      
      const browser = await chromium.launch({
        // 启用浏览器调试
        devtools: true,
        // 显示浏览器窗口
        headless: false
      });
      
      return browser;
    } catch (error) {
      console.error('启动调试失败:', error);
      throw error;
    }
  }
}
```

### 2. 错误分析

```typescript
// 错误分析工具
class ErrorAnalyzer {
  static analyzeLaunchError(error) {
    const errorInfo = {
      message: error.message,
      type: error.name,
      stack: error.stack,
      timestamp: new Date().toISOString()
    };

// 分析错误类型
    if (error.message.includes('Failed to launch')) {
      errorInfo.suggestion = '检查浏览器安装和系统依赖';
    } else if (error.message.includes('Permission denied')) {
      errorInfo.suggestion = '检查目录权限';
    }

return errorInfo;
  }
}
```

## 最佳实践

### 1. 启动策略

```typescript
// 创建启动管理器
class BrowserLauncher {
  static async launch(options = {}) {
    const defaultOptions = {
      headless: true,
      args: ['--no-sandbox'],
      timeout: 30000,
      retries: 3
    };

### 2. 资源管理

```typescript
// 资源清理工具
class ResourceCleaner {
  static async cleanup() {
    try {
      // 清理临时文件
      const { execSync } = require('child_process');
      execSync('rm -rf ~/.cache/ms-playwright/browsers/*');
      
      // 重新安装浏览器
      await Promise.all([
        chromium.install(),
        firefox.install(),
        webkit.install()
      ]);
      
      console.log('资源清理完成');
    } catch (error) {
      console.error('资源清理失败:', error);
    }
  }
}
```

## 常见解决方案

### 1. Docker环境

```typescript
// Docker环境配置
// Dockerfile
/*
FROM mcr.microsoft.com/playwright:v1.28.0-focal

WORKDIR /app

# 安装依赖
COPY package*.json ./
RUN npm ci

# 复制代码
COPY . .

# 设置环境变量
ENV NODE_ENV=production
ENV PLAYWRIGHT_BROWSERS_PATH=/ms-playwright

CMD ["npm", "test"]
*/

// 启动配置
const browser = await chromium.launch({
  args: [
    '--no-sandbox',
    '--disable-dev-shm-usage'
  ],
  executablePath: process.env.PLAYWRIGHT_CHROMIUM_PATH
});
```

### 2. CI/CD环境

```typescript
// CI环境配置
class CILauncher {
  static async launch() {
    const options = {
      // CI环境配置
      args: [
        '--no-sandbox',
        '--disable-gpu',
        '--disable-dev-shm-usage',
        '--disable-setuid-sandbox',
        '--no-first-run',
        '--no-zygote',
        '--single-process'
      ],
      // 禁用GPU
      chromiumSandbox: false,
      // 使用无头模式
      headless: true
    };

try {
      return await chromium.launch(options);
    } catch (error) {
      console.error('CI环境启动失败:', error);
      throw error;
    }
  }
}
```

## 下一步

1. 探索[测试用例组织结构](/article/playwright/best-practices/test-organization)
2. 学习[性能优化策略](/article/playwright/best-practices/performance)
3. 了解[跨浏览器测试方案](/article/playwright/best-practices/cross-browser)

## 参考资料

- [Playwright浏览器](https://playwright.dev/docs/browsers)
- [Playwright CI指南](https://playwright.dev/docs/ci)
- [Docker配置](https://playwright.dev/docs/docker)

元素码农