e2e-test

name	e2e-test
description	执行OAuth2系统的完整端到端(E2E)测试，验证用户登录、授权码流程、token交换、RBAC权限控制和受保护API访问的完整功能。当用户需要在代码变更后验证整个OAuth2认证流程、测试用户登录和权限管理、验证修复后的安全功能、或在生产部署前进行完整的功能验证时使用此技能。

OAuth2端到端测试

执行完整的OAuth2授权码流程和RBAC权限控制测试，验证系统从前端登录到后端API保护的完整认证链路。

使用时机

• 代码变更后验证OAuth2核心流程完整性
• 测试用户登录、权限验证和API访问控制
• 验证安全漏洞修复后的功能正常性
• 生产部署前的完整功能验证
• 回归测试确保修改未破坏现有功能

测试范围

1. 环境准备

• 数据库重置和schema初始化
• OAuth2测试数据准备
• 服务编译和启动

2. 完整OAuth2流程测试

• 用户登录获取授权码
• 授权码交换access token和refresh token
• Token验证和角色识别
• 受保护API资源访问

3. RBAC权限验证

• Admin用户权限验证
• 角色识别和权限检查
• 受保护资源访问控制

4. 安全功能验证

• 敏感信息POST body传递
• Refresh token撤销机制
• CORS策略验证
• Token过期处理

测试流程

步骤1: 环境准备

# 自动选择最佳环境
$env:FULLA_ENV_MODE = "auto"

# 检查 Docker 是否可用
docker ps | Out-Null
if ($?) {
    Write-Host "🐳 Docker 检测到，使用 Docker 模式"
    $env:FULLA_ENV_MODE = "docker"
} else {
    Write-Host "💻 使用本地模式"
    $env:FULLA_ENV_MODE = "local"
}

# Docker 模式推荐流程
if ($env:FULLA_ENV_MODE -eq "docker") {
    Write-Host "使用 Docker 完整测试流程..."
    # 跳到步骤 2 的 Docker 模式
} else {
    Write-Host "使用本地测试流程..."
    # 继续传统本地流程
}

Docker 模式（推荐）

# 使用 Docker 专项脚本
scripts/backend/full_test_docker.bat

# 此脚本会自动完成所有测试步骤

本地模式

# 重置数据库
cd /path/to/project
$env:PGPASSWORD='123456'
psql -U fulla_user -d postgres -c "DROP DATABASE IF EXISTS fulla_db;"
psql -U fulla_user -d postgres -c "CREATE DATABASE fulla_db;"
for f in apps/server/migrations/V*.sql; do
    psql -U fulla_user -d fulla_db -f "$f"
done
for f in apps/server/seed/*.sql; do
    psql -U fulla_user -d fulla_db -f "$f"
done

# 编译服务（如果需要）
.\manage.ps1 build-backend -release

步骤2: 启动服务

# 使用统一管理接口编译
.\manage.ps1 build-backend -release

# 停止旧服务
taskkill /F /IM fulla-server.exe 2>$null

# 启动服务（preset 构建路径：build/<preset>/apps/server/Release/）
$serverPath = "build/windows-msvc/apps/server/Release/fulla-server.exe"
if (Test-Path $serverPath) {
    Start-Process -FilePath $serverPath -WindowStyle Hidden
    Write-Host "✅ Server started from: $serverPath"
} else {
    Write-Host "❌ Server executable not found at: $serverPath"
    exit 1
}

# 等待服务启动
Start-Sleep -Seconds 3

# 验证服务状态
$response = Invoke-WebRequest -Uri "http://localhost:5555/health" -UseBasicParsing -TimeoutSec 5
if ($response.StatusCode -eq 200) {
    Write-Host "✅ Server is responding"
} else {
    Write-Host "❌ Server health check failed"
    exit 1
}

Docker 模式测试流程

# 完整 Docker 测试（推荐）
scripts/backend/full_test_docker.bat

# 此脚本包含：
# 1. PostgreSQL 容器启动
# 2. 数据库初始化
# 3. ORM 模型生成  
# 4. 项目构建
# 5. 单元测试
# 6. 服务启动
# 7. OAuth2 端点测试
# 8. 清理和停止

# 手动 Docker 测试流程
.\manage.ps1 docker-up
Start-Sleep -Seconds 10

# 在 Docker 容器中运行测试（前提：已 `.\manage.ps1 docker-up` 拉起完整栈。
# 注意：full_test_docker.bat 只启动 pg+redis 容器并在宿主机本地跑 server，
# 不会启动 fulla-backend 容器，因此下面的 docker exec 需先 docker-up）
docker exec fulla-backend /bin/bash -c "ctest --output-on-failure"

# OAuth2 端点测试
# ... (后续步骤)

# 清理
.\manage.ps1 docker-down

步骤3: 执行E2E测试

3.1 登录并获取授权码

curl -s -X POST "http://localhost:5555/oauth2/login" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=admin&password=admin&client_id=vue-client&redirect_uri=http://localhost:5173/callback&scope=openid&state=e2e_test"

预期结果: HTTP 302重定向，包含授权码

3.2 交换Token

# 提取授权码并交换token
CODE="<从上一步响应中提取的授权码>"

curl -s -X POST "http://localhost:5555/oauth2/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code&code=${CODE}&client_id=vue-client&redirect_uri=http://localhost:5173/callback"

预期结果: 返回access_token, refresh_token, roles数组

3.3 访问受保护的Admin资源

# 使用access_token访问admin dashboard
ACCESS_TOKEN="<从上一步响应中提取的access_token>"

curl -s -X GET "http://localhost:5555/api/admin/dashboard" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}"

预期结果: 返回admin dashboard数据

步骤4: 清理环境

# 停止服务
taskkill /F /IM fulla-server.exe 2>$null

测试验证标准

✅ 成功标准

• 登录返回HTTP 302重定向包含授权码
• Token交换返回包含access_token和roles的JSON
• Admin API返回200状态码和正确的响应数据
• roles数组包含"admin"角色
• 无服务崩溃或异常退出

❌ 失败标准

• 登录失败返回错误状态码
• Token交换失败或缺少必需字段
• API访问返回401/403权限错误
• 服务崩溃或无响应
• roles不包含预期的角色

错误处理

常见问题排查

服务启动失败

# 检查端口占用
netstat -ano | findstr :5555

# 检查服务日志
cd build/windows-msvc/apps/server/Release
.\fulla-server.exe

数据库连接失败

# 验证数据库连接
psql -U fulla_user -d fulla_db -c "SELECT 1;"

# 检查客户端数据
psql -U fulla_user -d fulla_db -c "SELECT * FROM oauth2_clients;"

登录失败

# 验证用户存在
psql -U fulla_user -d fulla_db -c "SELECT * FROM users WHERE username='admin';"

# 验证客户端配置
psql -U fulla_user -d fulla_db -c "SELECT * FROM oauth2_clients WHERE client_id='vue-client';"

性能指标

• 服务启动时间: < 5 秒
• 登录响应时间: < 500ms
• Token 交换时间: < 300ms
• API 访问时间: < 200ms
• 完整流程时间: < 2 秒
• Docker 模式完整流程: < 5 分钟（包含环境准备）

自动化脚本

PowerShell脚本版本

# 完整E2E测试脚本
$ErrorActionPreference = "Stop"

# 1. 启动服务
Write-Host "Starting fulla-server..."
cd build/windows-msvc/apps/server/Release
Start-Process -FilePath ".\fulla-server.exe" -WindowStyle Hidden
Start-Sleep -Seconds 3

# 2. 登录
Write-Host "Testing Login..."
$LoginResp = curl -s -X POST "http://localhost:5555/oauth2/login" `
  -H "Content-Type: application/x-www-form-urlencoded" `
  -d "username=admin&password=admin&client_id=vue-client&redirect_uri=http://localhost:5173/callback&scope=openid&state=e2e_test"

if ($LoginResp -match "code=([a-f0-9\-]+)") {
    $Code = $matches[1]
    Write-Host "✅ Login successful, code: $Code"
    
    # 3. 交换Token
    Write-Host "Exchanging token..."
    $TokenResp = curl -s -X POST "http://localhost:5555/oauth2/token" `
      -H "Content-Type: application/x-www-form-urlencoded" `
      -d "grant_type=authorization_code&code=$Code&client_id=vue-client&redirect_uri=http://localhost:5173/callback" | ConvertFrom-Json
    
    if ($TokenResp.access_token) {
        Write-Host "✅ Token obtained: $($TokenResp.access_token)"
        
        # 4. 访问Admin API
        Write-Host "Testing admin API access..."
        $ApiResp = curl -s -X GET "http://localhost:5555/api/admin/dashboard" `
          -H "Authorization: Bearer $($TokenResp.access_token)"
        
        if ($ApiResp -match "success") {
            Write-Host "✅ E2E test completed successfully!"
        } else {
            Write-Error "❌ API access failed"
        }
    } else {
        Write-Error "❌ Token exchange failed"
    }
} else {
    Write-Error "❌ Login failed"
}

# 5. 清理
Write-Host "Stopping service..."
taskkill /F /IM fulla-server.exe 2>$null

集成建议

CI/CD 集成

# .github/workflows/e2e-test.yml
name: E2E Tests
on: [push, pull_request]

jobs:
  e2e:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Start Docker services
        run: docker-compose up -d
        
      - name: Run E2E tests
        run: scripts/backend/full_test_docker.bat
        
      - name: Stop Docker services  
        run: docker-compose down

监控集成

• 将测试结果发送到监控系统
• 记录关键性能指标（登录时间、token 交换时间等）
• 设置告警阈值（响应时间 > 1秒触发告警）

定期执行

• 每次部署后立即执行 E2E 测试
• 每日自动执行作为健康检查
• 定期回归测试确保稳定性