#!/usr/bin/env bash # mem-budget.sh —— 内存预算实测闸门(PLAN.md 判断 ⑥) # # 终端产品形态下,内存超标 = 不可交付。这条必须**实测**,不能靠感觉。 # # 用法: # bash scripts/mem-budget.sh # 用 release 产物,空载测量 # bash scripts/mem-budget.sh --bin # 指定二进制 # bash scripts/mem-budget.sh --budget 40 # 自定义空载预算(MB) # # 退出码:0 达标 / 1 超标 / 2 用法或环境错 # # ── 量什么 ── # **空载 RSS**(刚起来、健康检查通过、没有业务请求)。 # 典型/峰值预算要压测才能量,见 PLAN.md §2 判断 ⑥ 的表。 # # ⚠️ 测量口径按平台选: # macOS ⇒ `vmmap` 的 **Physical footprint**(准确,扣掉共享页与保留虚拟地址) # Linux ⇒ `ps -o rss=`(近似,但趋势够用) # 本机沙箱禁止 `ps` / `top`,所以必须走 vmmap 分支。 set -u ROOT="$(cd "$(dirname "$0")/.." && pwd)" BIN="$ROOT/target/release/sspf-admin" BUDGET_MB=40 PORT=30997 STARTUP_WAIT=25 while [ $# -gt 0 ]; do case "$1" in --bin) BIN="$2"; shift 2 ;; --budget) BUDGET_MB="$2"; shift 2 ;; --port) PORT="$2"; shift 2 ;; --help) sed -n '2,20p' "$0"; exit 0 ;; *) echo "未知参数: $1"; exit 2 ;; esac done [ -x "$BIN" ] || { echo "❌ 二进制不存在或不可执行: $BIN"; echo " 先跑: cargo build --release"; exit 2; } TMPDB="$(mktemp -d /tmp/sspf-memtest.XXXXXX)" LOG="$TMPDB/backend.log" cleanup() { if [ -n "${PID:-}" ] && kill -0 "$PID" 2>/dev/null; then kill "$PID" 2>/dev/null || true sleep 0.5 kill -9 "$PID" 2>/dev/null || true fi rm -rf "$TMPDB" } trap cleanup EXIT INT TERM echo "── 内存预算实测(空载 RSS,预算 ${BUDGET_MB} MB)──" echo " 二进制: $BIN" env PORT="$PORT" PGLITE_DIR="$TMPDB/db" "$BIN" >"$LOG" 2>&1 & PID=$! # 等健康检查(最多 STARTUP_WAIT 秒) ok=0 for _ in $(seq 1 $((STARTUP_WAIT * 2))); do if ! kill -0 "$PID" 2>/dev/null; then echo "❌ 后端启动即退出,日志尾部:" tail -20 "$LOG" | sed 's/^/ /' exit 2 fi if curl -s --noproxy '*' --max-time 1 "http://127.0.0.1:$PORT/api/health" 2>/dev/null | grep -q '"ok"'; then ok=1 break fi sleep 0.5 done if [ "$ok" -ne 1 ]; then echo "❌ ${STARTUP_WAIT}s 内健康检查未通过,日志尾部:" tail -20 "$LOG" | sed 's/^/ /' exit 2 fi # 让初始化(建表 + 种子)彻底落定,再量一次稳态 sleep 2 # 取「独占物理内存」(MB)。优先 vmmap,退回 ps。 # 🔴 本机沙箱里 `ps` / `top` 会被拦(Operation not permitted),vmmap 可用。 measure_rss_mb() { local pid="$1" raw val unit if command -v vmmap >/dev/null 2>&1; then raw="$(vmmap "$pid" 2>/dev/null | awk '/^Physical footprint:/{print $3; exit}')" if [ -n "$raw" ]; then unit="$(printf '%s' "$raw" | tr -d '0-9.')" val="$(printf '%s' "$raw" | tr -d 'KMG')" case "$unit" in K) awk -v v="$val" 'BEGIN{printf "%d", v/1024}' ;; M) awk -v v="$val" 'BEGIN{printf "%d", v}' ;; G) awk -v v="$val" 'BEGIN{printf "%d", v*1024}' ;; *) : ;; esac return 0 fi fi raw="$(ps -o rss= -p "$pid" 2>/dev/null | tr -d ' ')" if [ -n "$raw" ]; then awk -v v="$raw" 'BEGIN{printf "%d", v/1024}' return 0 fi return 1 } RSS_MB="$(measure_rss_mb "$PID")" [ -n "${RSS_MB:-}" ] || { echo "❌ 取不到内存(vmmap 与 ps 都不可用)"; exit 2; } echo " 空载物理内存: ${RSS_MB} MB" if [ "$RSS_MB" -le "$BUDGET_MB" ]; then printf '✅ MEM-BUDGET 达标:%d MB <= %d MB\n' "$RSS_MB" "$BUDGET_MB" exit 0 fi printf '❌ MEM-BUDGET 超标:%d MB > %d MB(差 %d MB)\n' \ "$RSS_MB" "$BUDGET_MB" "$((RSS_MB - BUDGET_MB))" echo " 排查顺序:" echo " 1) 是否 pglite 预分配过大(shared_buffers 一类)" echo " 2) 启动时是否把整表读进内存(MEM1 红线)" echo " 3) 是否有无界缓存(MEM2 红线)" exit 1