#!/usr/bin/env bash # 契约对账尺子:`docs/contract.md` 的端点表 ↔ **实际注册路由**(v3 spec §8 B5 验收) # # 用法: # bash scripts/check-contract.sh # 自己起一个真进程(隔离数据目录 + 空闲端口),跑完即收 # B=http://127.0.0.1:30000 bash scripts/check-contract.sh # 打已经在跑的实例 # KEEP=1 bash scripts/check-contract.sh # 保留临时数据目录(排障用) # # 退出码:0 = 全绿 / 1 = 对账不一致 / 2 = 前置错误(起不来等) # # 🔴 **对账的是「实际注册路由」,不是源码字面量**:每个 (方法, 路径) 都真打一次, # 用「404 = 未注册 / 405 = 方法不对 / 其它 = 已注册」反推方法集合。 # ⇒ 文档写错方法、漏写端点、多写端点,三种都会判红。 # 🔴 所有 curl / urllib 都禁代理(本机 HTTP_PROXY 会劫持 loopback)。 # 🔴 所有含中文的变量引用一律写 ${VAR}(变量名后紧跟中文时,bash 会把中文并进变量名 ⇒ set -u 下 unbound variable)。 set -u if [ "${1:-}" = "-h" ] || [ "${1:-}" = "--help" ]; then sed -n '2,14p' "$0" | sed 's/^# \{0,1\}//' exit 0 fi ROOT="$(cd "$(dirname "$0")/.." && pwd)" BIN="${BIN:-$ROOT/target/debug/tdc-connector}" PY_BIN="${PY_BIN-$(command -v python3 2>/dev/null || true)}" KEEP="${KEEP:-0}" INTERNAL_TOKEN="${INTERNAL_TOKEN:-contract-probe-internal-token}" DOC="${DOC:-$ROOT/docs/contract.md}" TMP="$(mktemp -d)" SERVER_PID="" cleanup() { if [ -n "${SERVER_PID}" ]; then # 🔴 后端**不响应 SIGTERM**(实测)⇒ TERM → 最多等 5 秒 → KILL,最后 `wait` 收尸。 kill "${SERVER_PID}" 2>/dev/null || true for _ in $(seq 1 10); do kill -0 "${SERVER_PID}" 2>/dev/null || break sleep 0.5 done kill -9 "${SERVER_PID}" 2>/dev/null || true wait "${SERVER_PID}" 2>/dev/null || true fi if [ "${KEEP}" = "1" ]; then echo "(KEEP=1)临时目录保留在:${TMP}" else rm -rf "${TMP}" fi } trap cleanup EXIT pre_fail() { echo "❌ 前置错误:${1}" exit 2 } [ -n "${PY_BIN}" ] || pre_fail "找不到 python3。" if [ -z "${B:-}" ]; then if [ ! -x "${BIN}" ]; then echo "… ${BIN} 不存在,先 cargo build" (cd "${ROOT}" && cargo build --quiet) || pre_fail "cargo build 失败。" fi PORT="$("${PY_BIN}" -c 'import socket s = socket.socket() s.bind(("127.0.0.1", 0)) print(s.getsockname()[1]) s.close()')" B="http://127.0.0.1:${PORT}" DATA_DIR="${TMP}/data" mkdir -p "${DATA_DIR}" echo "… 起进程:${B}(数据目录 ${DATA_DIR})" TDC_DATA_DIR="${DATA_DIR}" \ PORT="${PORT}" \ TDC_IDENTITY_SECRET="contract-probe-dummy-not-a-real-secret" \ SSW_INTERNAL_TOKEN="${INTERNAL_TOKEN}" \ "${BIN}" >"${TMP}/server.log" 2>&1 & SERVER_PID=$! READY=0 for _ in $(seq 1 120); do if ! kill -0 "${SERVER_PID}" 2>/dev/null; then echo "--- server.log ---" sed -n '1,40p' "${TMP}/server.log" pre_fail "后端进程启动即退出。" fi if curl -s --noproxy '*' --max-time 3 -o /dev/null "${B}/api/health" 2>/dev/null; then READY=1 break fi sleep 1 done [ "${READY}" -eq 1 ] || { sed -n '1,40p' "${TMP}/server.log"; pre_fail "后端 120 秒内没起来。"; } else echo "… 打已在跑的实例:${B}" fi "${PY_BIN}" "${ROOT}/scripts/contract_probe.py" --base "${B}" --doc "${DOC}" --token "${INTERNAL_TOKEN}" RC=$? [ "${RC}" -eq 2 ] && exit 2 exit "${RC}"