feat: 配置多环境支持

- 创建环境配置文件environments.ts - 支持development/staging/production三个环境 - 更新playwright.config.ts使用环境配置 - 创建.env.example环境变量示例 - 创建ENVIRONMENT.md环境配置指南 - 支持CI/CD集成配置
2026-02-28 15:12:04 +08:00
parent 5cdb021994
commit 925f79c45a
4 changed files with 314 additions and 10 deletions
@@ -0,0 +1,184 @@
+# E2E测试环境配置指南
+
+## 环境说明
+
+本项目支持三个测试环境：
+
+- **development**: 本地开发环境 (http://localhost:3001)
+- **staging**: 预发布环境
+- **production**: 生产环境
+
+## 快速开始
+
+### 1. 配置环境变量
+
+复制环境变量示例文件：
+
+```bash
+cp e2e/.env.example e2e/.env
+```
+
+### 2. 运行测试
+
+#### 开发环境测试
+
+```bash
+# 默认使用development环境
+npm run test:e2e
+
+# 或者显式指定
+TEST_ENV=development npm run test:e2e
+```
+
+#### 预发布环境测试
+
+```bash
+TEST_ENV=staging npm run test:e2e
+```
+
+#### 生产环境测试
+
+```bash
+TEST_ENV=production npm run test:e2e
+```
+
+## 环境配置详解
+
+### Development环境
+
+- **baseURL**: http://localhost:3001
+- **headless**: false (显示浏览器窗口)
+- **slowMo**: 100ms (减慢操作速度，便于调试)
+- **retries**: 0 (不重试)
+- **webServer**: 自动启动开发服务器
+
+### Staging环境
+
+- **baseURL**: https://staging.novalon.com
+- **headless**: true (无头模式)
+- **slowMo**: 0 (正常速度)
+- **retries**: 1 (失败重试1次)
+- **webServer**: 不启动
+
+### Production环境
+
+- **baseURL**: https://novalon.com
+- **headless**: true (无头模式)
+- **slowMo**: 0 (正常速度)
+- **retries**: 2 (失败重试2次)
+- **webServer**: 不启动
+
+## 环境变量
+
+| 变量名 | 说明 | 默认值 |
+|--------|------|--------|
+| TEST_ENV | 测试环境 | development |
+| BASE_URL | 基础URL | 根据环境配置 |
+| API_URL | API URL | 根据环境配置 |
+| HEADLESS | 无头模式 | true |
+| SLOW_MO | 减慢操作(ms) | 0 |
+| TIMEOUT | 超时时间(ms) | 120000 |
+| RETRIES | 重试次数 | 0 |
+| SCREENSHOT | 截图策略 | only-on-failure |
+| VIDEO | 视频策略 | retain-on-failure |
+| TRACE | 追踪策略 | retain-on-failure |
+| CI | CI环境 | false |
+| DEBUG | 调试模式 | false |
+| PWDEBUG | Playwright调试 | false |
+
+## CI/CD集成
+
+### Woodpecker CI配置示例
+
+```yaml
+pipeline:
+  test-smoke:
+    image: mcr.microsoft.com/playwright:v1.48.0-focal
+    commands:
+      - cd e2e
+      - npm ci
+      - TEST_ENV=staging npx playwright test --project=chromium --grep=@smoke
+    when:
+      event: [push, pull_request]
+
+  test-regression:
+    image: mcr.microsoft.com/playwright:v1.48.0-focal
+    commands:
+      - cd e2e
+      - npm ci
+      - TEST_ENV=staging npx playwright test --project=chromium --grep=@regression
+    when:
+      event: [push, pull_request]
+
+  test-full:
+    image: mcr.microsoft.com/playwright:v1.48.0-focal
+    commands:
+      - cd e2e
+      - npm ci
+      - TEST_ENV=production npx playwright test
+    when:
+      event: [deployment]
+```
+
+## 最佳实践
+
+### 1. 本地开发
+
+使用development环境，可以看到浏览器操作过程，便于调试：
+
+```bash
+TEST_ENV=development npm run test:e2e
+```
+
+### 2. 代码提交
+
+在staging环境运行smoke和regression测试：
+
+```bash
+TEST_ENV=staging npm run test:e2e -- --grep="@smoke|@regression"
+```
+
+### 3. 生产部署
+
+在production环境运行完整测试套件：
+
+```bash
+TEST_ENV=production npm run test:e2e
+```
+
+### 4. 调试测试
+
+启用Playwright调试模式：
+
+```bash
+PWDEBUG=1 TEST_ENV=development npm run test:e2e -- --grep="test name"
+```
+
+## 故障排查
+
+### 问题1: 环境变量不生效
+
+确保在项目根目录运行命令，或者在e2e目录下运行。
+
+### 问题2: 开发服务器启动失败
+
+检查端口3001是否被占用，或者修改配置中的端口。
+
+### 问题3: 测试超时
+
+增加TIMEOUT环境变量值：
+
+```bash
+TIMEOUT=180000 npm run test:e2e
+```
+
+### 问题4: 网络问题
+
+检查网络连接，确保可以访问目标环境URL。
+
+## 相关文档
+
+- [测试数据管理](./test-data-management.md)
+- [性能测试指南](./performance-testing.md)
+- [安全测试指南](./security-testing.md)
+- [可访问性测试指南](./accessibility-testing.md)