Go程序需主动读取/sys/fs/cgroup下cgroup v1或v2接口获取容器CPU和内存限制，推荐使用containerd/cgroups库安全解析，启动时探测版本并缓存结果，失败则回退默认值或环境变量配置。
Go 程序如何读取容器的 CPU 和内存限制
Go 程序本身不自动感知容器限制，必须主动读取 /sys/fs/cgroup/ 下的 cgroup v1 或 v2 接口。Kubernetes、Docker 等运行时会将资源限制写入对应 cgroup 文件，Go 只需按路径读取数值并解析。
- cgroup v1 路径示例：
/sys/fs/cgroup/cpu/cpu.cfs_quota_us（CPU 配额）、/sys/fs/cgroup/memory/memory.limit_in_bytes（内存上限） - cgroup v2 路径统一为：
/sys/fs/cgroup/memory.max、/sys/fs/cgroup/cpu.max，且默认值可能是max字符串，需特殊处理 - 容器可能运行在 cgroup v1 或 v2 环境下，需先探测版本（检查
/proc/1/cgroup内容或是否存在/sys/fs/cgroup/cgroup.version）
用 github.com/containerd/cgroups 安全读取限制值
手动解析 cgroup 文件易出错（如未处理 max、单位换算错误、权限拒绝）。推荐使用 containerd/cgroups 库，它封装了 v1/v2 的差异，并提供类型安全的接口。
- 安装：
go get github.com/containerd/cgroups - 关键函数：
cgroups.Load(cgroups.V1, cgroups.Pid(1))或cgroups.Load(cgroups.V2, cgroups.Pid(1))，传入 init 进程 PID（通常是 1）可获取容器根 cgroup - 读取内存限制：
stats.Memory.Usage.Limit（v1）或stats.Memory.Max（v2），返回uint64字节值；若为math.MaxUint64表示无限制 - 读取 CPU 限制：
stats.CPU.Usage.Limit（v1）或解析stats.CPU.Max字符串（格式如"100000 100000"，前者是 quota，后者是 period）
常见错误：读到 0、-1 或 panic
直接读文件却忽略边界情况，极易导致逻辑崩溃或误判。典型表现包括：
- 读
/sys/fs/cgroup/memory.limit_in_bytes得到-1：表示 cgroup v1 中未设限，不是错误，应视为无限 - 读
/sys/fs/cgroup/memory.max得到字符串"max"：cgroup v2 中未设限，不能转成整数，需显式判断 - 程序以非 root 用户运行，且容器未挂载
/sys/fs/cgroup为 ro：读取失败返回permission denied或no such file，应 fallback 到默认值或日志告警 - 在 Kubernetes Pod 中，
/proc/1/cgroup可能显示0::/（v2）或8:memory:/kubepods/...（v1），路径前缀不影响读取，但硬编码路径会失效
实际适配建议：启动时探测 + 环境变量兜底
生产环境不应只依赖 cgroup 探测。建议组合策略降低不确定性：
立即学习“go语言免费学习笔记（深入）”；
- 启动时调用
cgroups.Load一次，成功则缓存结果；失败则记录 warning 并使用默认值（如runtime.NumCPU()作为 CPU 上限，512 * 1024 * 1024作为内存基线） - 允许通过环境变量覆盖（如
CONTAINER_CPU_LIMIT=2、CONTAINER_MEM_LIMIT_MB=1024），便于本地调试或 CI 场景 - 对内存敏感服务（如 cache、buffer），用探测值动态设置
runtime/debug.SetMemoryLimit（Go 1.19+）或调整 GC 触发阈值 - 避免每秒轮询 cgroup 文件——限制值在容器生命周期内不变，读一次足够
package main <p>import ( "fmt" "log" "runtime/debug"</p><pre class='brush:php;toolbar:false;'>cgroups "github.com/containerd/cgroups"
)
func main() { cg, err := cgroups.Load(cgroups.V2, cgroups.Pid(1)) if err != nil { log.Printf("failed to load cgroup: %v, using defaults", err) return } defer cg.Close()
stats, err := cg.Stat()
if err != nil {
log.Printf("failed to stat cgroup: %v", err)
return
}
memLimit := stats.Memory.Max
if memLimit != ^uint64(0) { // not unlimited
debug.SetMemoryLimit(int64(memLimit))
fmt.Printf("set memory limit to %d bytes\n", memLimit)
}}
cgroup 版本探测和数值解析仍是容易被跳过的环节，尤其在混合部署（部分节点 v1、部分 v2）或低权限容器中，硬编码路径或忽略 max 字符串会导致行为不一致。
