- 内核只有 lib:启动装配 → crates/sspf-admin(bin sspf-admin);37 个集成测试 → crates/tests(package sspf-tests)。
- demo/shop/books 的 spec/菜单/DDL/面 B 路由搬进 packs/{demo,shop,books};内核 modules/*.rs 只剩「面 A 适配器 + pub use」⇒ 内核零业务知识,示例可整目录搬走。面 A 与前端零改动。
- 示例表 DDL 按平台规则补 f_tenant_id + 复合主键(spec 不加 ⇒ JSON 键与响应逐字不变)。
- 修 is_builtin_table 只认 schema.sql 的漏洞:包表(含 asset_data_resource)此前可被建模页删除/改;现为「平台 DDL ∪ 包表」。
- sspf-compat-online_dev → onlinedev(包名/模块/文件/路由别名同步);6 个 5 行转发壳合并为 forward.rs。
- 新增 AR16 闸门 + lib.rs「30 秒地图」+ src/backend/README.md;pack-sync 补两处判据(module_key=None 的 urlAddress、apiFile 查存在性)。
- 回归:704 tests / 6 道静态闸门全绿;health 181 表;四个包面 A/面 B 运行时全部 200。
128 lines
4.0 KiB
Bash
Executable File
128 lines
4.0 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
# mem-budget.sh —— 内存预算实测闸门(PLAN.md 判断 ⑥)
|
||
#
|
||
# 终端产品形态下,内存超标 = 不可交付。这条必须**实测**,不能靠感觉。
|
||
#
|
||
# 用法:
|
||
# bash scripts/mem-budget.sh # 用 release 产物,空载测量
|
||
# bash scripts/mem-budget.sh --bin <path> # 指定二进制
|
||
# 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
|