manta/gofaster/diagnose-swagger.ps1

# Swagger配置诊断脚本
Write-Host "🔍 Swagger配置诊断工具" -ForegroundColor Cyan
Write-Host "================================================" -ForegroundColor Cyan
Write-Host ""

# 检查后端服务状态
Write-Host "📋 检查后端服务状态..." -ForegroundColor Yellow

try {
    $response = Invoke-WebRequest -Uri "http://localhost:8080/health" -TimeoutSec 5 -ErrorAction Stop
    Write-Host "✅ 后端服务正在运行 (状态码: $($response.StatusCode))" -ForegroundColor Green
} catch {
    Write-Host "❌ 后端服务未运行或无法访问" -ForegroundColor Red
    Write-Host "   错误信息: $($_.Exception.Message)" -ForegroundColor Red
    Write-Host ""
    Write-Host "请先启动后端服务：" -ForegroundColor Yellow
    Write-Host "   cd backend" -ForegroundColor White
    Write-Host "   go run main.go" -ForegroundColor White
    exit 1
}

Write-Host ""

# 检查Swagger JSON文档
Write-Host "🔍 检查Swagger JSON文档..." -ForegroundColor Yellow

try {
    $response = Invoke-WebRequest -Uri "http://localhost:8080/swagger/doc.json" -TimeoutSec 5 -ErrorAction Stop
    $swaggerDoc = $response.Content | ConvertFrom-Json
    
    Write-Host "✅ Swagger JSON文档获取成功" -ForegroundColor Green
    
    # 检查安全定义
    if ($swaggerDoc.securityDefinitions) {
        Write-Host "✅ 安全定义配置存在" -ForegroundColor Green
        Write-Host "   安全定义类型: $($swaggerDoc.securityDefinitions.PSObject.Properties.Name)" -ForegroundColor White
    } else {
        Write-Host "❌ 安全定义配置缺失" -ForegroundColor Red
    }
    
    # 检查API安全配置
    $secureApis = @()
    foreach ($path in $swaggerDoc.paths.PSObject.Properties) {
        foreach ($method in $path.Value.PSObject.Properties) {
            if ($method.Value.security) {
                $secureApis += "$($path.Name) [$($method.Name)]"
            }
        }
    }
    
    if ($secureApis.Count -gt 0) {
        Write-Host "✅ 发现 $($secureApis.Count) 个需要认证的API" -ForegroundColor Green
        foreach ($api in $secureApis) {
            Write-Host "   - $api" -ForegroundColor White
        }
    } else {
        Write-Host "❌ 没有发现需要认证的API" -ForegroundColor Red
    }
    
} catch {
    Write-Host "❌ 获取Swagger JSON文档失败: $($_.Exception.Message)" -ForegroundColor Red
}

Write-Host ""

# 检查Swagger UI页面
Write-Host "🔍 检查Swagger UI页面..." -ForegroundColor Yellow

$swaggerUIs = @(
    @{Path="/swagger/index.html"; Name="默认Swagger UI"},
    @{Path="/swagger-ui"; Name="自定义Swagger UI"},
    @{Path="/swagger-ui-fixed"; Name="修复版Swagger UI"}
)

foreach ($ui in $swaggerUIs) {
    try {
        $uri = "http://localhost:8080$($ui.Path)"
        $response = Invoke-WebRequest -Uri $uri -TimeoutSec 5 -ErrorAction Stop
        Write-Host "✅ $($ui.Name): 页面加载成功" -ForegroundColor Green
    } catch {
        $errorMsg = if ($_.Exception.Response) { 
            "HTTP $($_.Exception.Response.StatusCode)" 
        } else { 
            $_.Exception.Message 
        }
        Write-Host "❌ $($ui.Name): $errorMsg" -ForegroundColor Red
    }
}

Write-Host ""

# 显示访问信息
Write-Host "💡 访问信息:" -ForegroundColor Cyan
Write-Host "   默认Swagger UI: http://localhost:8080/swagger/index.html" -ForegroundColor White
Write-Host "   自定义Swagger UI: http://localhost:8080/swagger-ui" -ForegroundColor White
Write-Host "   修复版Swagger UI: http://localhost:8080/swagger-ui-fixed" -ForegroundColor White
Write-Host "   Swagger JSON: http://localhost:8080/swagger/doc.json" -ForegroundColor White
Write-Host ""

Write-Host "🔧 Authorize按钮不显示的可能原因:" -ForegroundColor Cyan
Write-Host "   1. Swagger UI版本问题" -ForegroundColor White
Write-Host "   2. 浏览器缓存问题" -ForegroundColor White
Write-Host "   3. 安全定义配置问题" -ForegroundColor White
Write-Host "   4. API没有使用安全配置" -ForegroundColor White
Write-Host ""

Write-Host "🎯 解决方案:" -ForegroundColor Cyan
Write-Host "   1. 使用修复版Swagger UI: http://localhost:8080/swagger-ui-fixed" -ForegroundColor White
Write-Host "   2. 清除浏览器缓存 (Ctrl+Shift+Delete)" -ForegroundColor White
Write-Host "   3. 强制刷新页面 (Ctrl+F5)" -ForegroundColor White
Write-Host "   4. 检查浏览器控制台错误信息 (F12)" -ForegroundColor White
Write-Host ""

Write-Host "📝 测试步骤:" -ForegroundColor Cyan
Write-Host "   1. 访问 http://localhost:8080/swagger-ui-fixed" -ForegroundColor White
Write-Host "   2. 检查右上角是否有Authorize按钮" -ForegroundColor White
Write-Host "   3. 如果没有，按F12查看控制台错误信息" -ForegroundColor White
Write-Host "   4. 尝试不同的浏览器" -ForegroundColor White