flowchart TB
    subgraph GCTriggers["Go GC 觸發(fā)條件"]
        T1["條件一：堆內(nèi)存增長(zhǎng)\n新分配內(nèi)存 ≥ 上次 GC 后存活內(nèi)存 × GOGC%"]
        T2["條件二：定時(shí)觸發(fā)\n距離上次 GC 超過(guò) 2 分鐘"]
        T3["條件三：GOMEMLIMIT\n總內(nèi)存接近 GOMEMLIMIT 閾值\n觸發(fā)更頻繁的 GC"]
        T4["條件四：手動(dòng)觸發(fā)\nruntime.GC()"]
    end
    subgraph GCCycle["一次 GC 周期"]
        Start["GC 開(kāi)始"] --> Mark["標(biāo)記階段\nSTW: ~0.1ms"]
        Mark --> Sweep["清掃階段\n并發(fā)執(zhí)行"]
        Sweep --> End["GC 結(jié)束\n堆內(nèi)存釋放"]
    end
    subgraph Problem["未優(yōu)化容器場(chǎng)景"]
        P1["Pod Memory Limit: 2GB"]
        P2["GC 觸發(fā)閾值: ~1GB（GOGC=100）"]
        P3["剩余可用: 1GB"]
        P4["GC 期間額外內(nèi)存分配\n→ 超出 2GB Limit\n→ OOMKilled"]
    end

package main

import (
    "fmt"
    "os"
    "runtime"
    "runtime/debug"
    "strconv"
    "time"
)

// GCConfig GC 調(diào)優(yōu)配置
type GCConfig struct {
    GOGC        int   // GC 觸發(fā)百分比，默認(rèn) 100
    GOMEMLIMIT  int64 // 內(nèi)存軟上限（字節(jié)），Go 1.19+
    MaxHeapMB   int64 // 期望的最大堆內(nèi)存（MB）
    PodMemLimit int64 // Pod 內(nèi)存限制（MB）
}

// ApplyGCTuning 應(yīng)用 GC 調(diào)優(yōu)配置
func ApplyGCTuning(config GCConfig) error {
    // 設(shè)置 GC 觸發(fā)策略
    // GOGC=50 意味著堆內(nèi)存增長(zhǎng) 50% 就觸發(fā) GC（比默認(rèn)更頻繁）
    gogc := config.GOGC
    if gogc <= 0 {
        gogc = 50 // 默認(rèn)使用 50，適合容器環(huán)境
    }
    
    // 方式一：通過(guò)環(huán)境變量設(shè)置
    if os.Getenv("GOGC") == "" {
        os.Setenv("GOGC", strconv.Itoa(gogc))
    }
    
    // 方式二：通過(guò) API 設(shè)置（Go 1.20+ 有效）
    debug.SetGCPercent(gogc)
    
    // 設(shè)置內(nèi)存軟上限
    // 核心公式：GOMEMLIMIT = PodLimit × 80%
    // 留 20% 給非堆內(nèi)存（棧、GC 元數(shù)據(jù)、原生內(nèi)存）
    if config.GOMEMLIMIT <= 0 {
        config.GOMEMLIMIT = int64(float64(config.PodMemLimit) * 0.8 * 1024 * 1024)
    }
    
    // 設(shè)置 GOMEMLIMIT（Go 1.19+）
    debug.SetMemoryLimit(config.GOMEMLIMIT)
    
    // 驗(yàn)證設(shè)置
    actualLimit := debug.SetMemoryLimit(-1) // -1 返回當(dāng)前值，不修改
    fmt.Printf("GC 調(diào)優(yōu)配置:\n")
    fmt.Printf("  GOGC: %d\n", gogc)
    fmt.Printf("  GOMEMLIMIT: %d MB\n", actualLimit/1024/1024)
    
    return nil
}

// MonitorGCMetrics 監(jiān)控 GC 指標(biāo)——用于觀察調(diào)優(yōu)效果
func MonitorGCMetrics() {
    ticker := time.NewTicker(30 * time.Second)
    defer ticker.Stop()

    var prevStats runtime.MemStats

    for range ticker.C {
        var stats runtime.MemStats
        runtime.ReadMemStats(&stats) // 注意：此調(diào)用會(huì)觸發(fā) STW

        // 關(guān)鍵指標(biāo)
        allocMB := stats.Alloc / 1024 / 1024           // 當(dāng)前分配
        heapInUseMB := stats.HeapInuse / 1024 / 1024   // 堆使用
        gcCount := stats.NumGC - prevStats.NumGC       // 增量 GC 次數(shù)
        gcPauseTotal := stats.PauseTotalNs - prevStats.PauseTotalNs

        fmt.Printf("[GC Monitor] Alloc:%dMB HeapInUse:%dMB GC:%d次/30s Pause:%dms\n",
            allocMB, heapInUseMB, gcCount, gcPauseTotal/1_000_000)

        // 告警：GC 頻率過(guò)高（> 10 次/30s）
        if gcCount > 10 {
            fmt.Printf("[WARN] GC 頻率過(guò)高，建議調(diào)大 GOGC 或檢查內(nèi)存分配\n")
        }

        // 告警：堆內(nèi)存接近 GOMEMLIMIT
        limit := debug.SetMemoryLimit(-1)
        if stats.HeapInuse > uint64(limit*90/100) {
            fmt.Printf("[WARN] 堆內(nèi)存接近 GOMEMLIMIT: %d/%d MB\n",
                stats.HeapInuse/1024/1024, limit/1024/1024)
        }

        prevStats = stats
    }
}

// 場(chǎng)景一：容器環(huán)境（內(nèi)存限制 < 1GB）
func ContainerSmallConfig() GCConfig {
    return GCConfig{
        GOGC:        30,   // 更頻繁 GC，嚴(yán)格控內(nèi)存
        PodMemLimit: 512,  // 512MB
        MaxHeapMB:   300,  // 最大堆 300MB
    }
}

// 場(chǎng)景二：容器環(huán)境（內(nèi)存限制 >= 2GB）
func ContainerMediumConfig() GCConfig {
    return GCConfig{
        GOGC:        50,    // 適中的 GC 頻率
        PodMemLimit: 2048,  // 2GB
        MaxHeapMB:   1500,  // 最大堆 1.5GB
    }
}

// 場(chǎng)景三：離線批處理（追求吞吐，允許高內(nèi)存）
func BatchProcessingConfig() GCConfig {
    return GCConfig{
        GOGC:        200,   // 減少 GC 頻率，提升吞吐
        PodMemLimit: 4096,  // 4GB
        MaxHeapMB:   3500,
    }
}

// 場(chǎng)景四：延遲敏感服務(wù)（需要穩(wěn)定低延遲）
func LatencySensitiveConfig() GCConfig {
    return GCConfig{
        GOGC:        25,    // 頻繁小 GC，避免大暫停
        PodMemLimit: 1024,  // 1GB
        MaxHeapMB:   700,
    }
}