修复 Gitea issue #1(armv7 包只在 stdout 为管道时能启动)。 根因:pglite 的 initDummyPort() 设 s.sock = 1,把 fd 1 当「名义客户端 socket」;pq_init() 把它注册进 WaitEventSet。Linux 走 epoll,而 epoll 不接受 普通文件与字符设备(实测 EPERM)⇒ ereport(ERROR) ⇒ longjmp ⇒ exit(100)。 macOS 走 kqueue(接受普通文件/字符设备)⇒ 同样形态正常,故此前未暴露。 - 重写 ensure_stdout_for_pglite():pipe + dup 原始 stdout + dup2 让 fd 1 成为管道写端 + drain 线程把内容转发回原 stdout。drain 是必需的: pgl_fcntl 是 dummy ⇒ pg_set_noblock(fd 1) 无效 ⇒ fd 1 始终阻塞 ⇒ 管道写满 64KB 会永久阻塞。macOS 分支保留空实现(kqueue 无需替换)。 - 开库前固化 PGLITE_RUNTIME_DIR 为带 arch + 构建指纹(路径/大小/mtime 的 FNV-1a)的路径,消除 x86_64/armv7 共用 runtime 目录的抢占;用户显式设置时不覆盖。 - 失败路径改为打印「启动诊断」,不再静默 dup2。 门禁:scripts/build-armv7.sh 冒烟改为三 case(A 管道 / B 普通文件 / C /dev/null) × 各自干净数据目录,断言 HTTP 通 + 进程常驻;B/C 另断言出现「启动诊断」 (证明替换路径真的走到)。探活改用 bash 内建 /dev/tcp(armhf 镜像无 wget/curl)。 验证:旧二进制 case B = EXIT 100 + 46 字节 banner;新二进制 = HTTP 200、 14255 条示例数据、登录返 200、优雅关闭。三 case 全绿。
9.8 KiB
9.8 KiB
CHANGELOG
2026-11-13(v0.5.0 内增量,不升版本号)—— 修 armv7「stdout 非管道即 exit 100」
- 修 Gitea issue #1:内嵌 PostgreSQL 的
initDummyPort()把 fd 1 当成名义客户端 socket(s.sock = 1)⇒pq_init()把它注册进 WaitEventSet ⇒ Linux 走 epoll,而 epoll 不接受普通文件与字符设备(实测EPERM)⇒ereport(ERROR)→ longjmp → exit 100。⇒ 所有标准部署形态(nohup … > app.log 2>&1 &、systemd、CI 重定向)全挂,只有 stdout 是管道时能起。 - 重写
boot.rs::ensure_stdout_for_pglite():pipe()+dup原始 stdout +dup2让 fd 1 变管道写端 + drain 线程把内容转发回原 stdout ⇒ 平台自身println!(「已启动」…)仍落到用户真正的 stdout。drain 线程是必需的:pglite 的pgl_fcntl是 dummy ⇒pg_set_noblock(fd 1)无效 ⇒ fd 1 始终阻塞 ⇒ 管道写满 64KB 会永久阻塞。macOS 走 kqueue(本就接受普通文件)⇒#[cfg(target_os = "macos")]保留原样。 - 开库前固化
PGLITE_RUNTIME_DIR为带架构 + 二进制指纹的路径(engine.rs支持该 env 覆盖)⇒ 消除 x86_64 与 armv7 共用 runtime 目录导致的runtime extraction race lost and target invalid。用户显式设置时不覆盖。 scripts/build-armv7.sh冒烟改为三 case × 各自干净数据目录:A 继承 docker pipe / B> /tmp/srv.log 2>&1/ C> /dev/null,每个断言「HTTP 探活成功 + 进程仍常驻(没提前 exit 100)」,A/B 另断言日志含「已启动」。探活从wget(armhf 镜像里没有)换成 bash 内建/dev/tcp。- 影响:仅 Linux(macOS 分支逐字保留原行为);stdout 形态不再影响启动 ⇒
> file/> /dev/null/ 终端均可正常起服务。根因与验证结论记在docs/armv7-build.md的「第四个坑 / 第五个坑」。
2026-11-12(v0.5.0 内增量,不升版本号)—— armv7(32 位 ARM)交叉编译与发布
- 上游
Midwess/pglite-rs只发布 aarch64/x86_64 四架构引擎,没有 armv7 ⇒ 自建引擎:pglite-rs-sys 0.2.7的 build.rs 认PGLITE_LIB_DIR,用它喂自建引擎(上游engine-06c837c6a303-p3,postgres-pglite commit06c837c6a303…)。 - 新增
scripts/build-pglite-engine.sh/build-libpglite-cross.sh/relocate-runtime-cross.sh/zig-cc-armv7.sh/build-armv7.sh:amd64 容器 +gcc-arm-linux-gnueabihf交叉工具链编 PostgreSQL 17.5,Rust 侧用zig cc链接(zig 自带 lld + armv7 libc)。不走 qemu 原生编译(apt 装依赖 9 分钟未完,PG 全量 make 要数小时)。 - 踩平三个坑(都记在
docs/armv7-build.md):① 仓库strip="symbols"会让 rustc 重建 native 静态库、破坏ProcessStartupPacket/pgl_shmem_reset全局符号 ⇒ 交叉构建强制CARGO_PROFILE_RELEASE_STRIP=none;② PG configure 在cross_compiling=yes时直接假定不支持--export-dynamic(postgres动态导出 0 符号 vs 官方 10802)⇒ 强制 cache 变量 + make 直传LDFLAGS_EX_BE;③ 上游把 runtime 可移植化拆成独立的relocate-runtime.sh(RPATH + libpq + libz)⇒ 新增交叉版补上。 scripts/release.sh支持--target <triple>:交叉出包跳过宿主消费方编译自检、改为二进制架构校验,rlib 走隔离目录target/rlibbuild-<triple>,解包目录名带 target 后缀(同版本多平台互不覆盖)。- 实测(
linux/arm/v7容器):initdb 成功、单用户模式退出码 0、pglite 探针读写全通、sspf-admin 启动并导入 14255 条示例数据(1709 个数据文件)、/api/oauth/Login返回 token、/api/oauth/CurrentUser返回 99 菜单节点 + 6 路由。从发布包 tar 解出的二进制端到端复测同样通过。 - 发布:Gitea Release
v0.5.0追加sspf-v0.5.0-armv7-unknown-linux-gnueabihf.tar.gz(平台包,自包含——runtime 已include_bytes!内嵌进二进制)与pglite-armv7-unknown-linux-gnueabihf.tar.gz+.sha256(引擎,给二次开发者)。 - 影响:不带
--target时release.sh行为逐字不变;宿主机 x86_64 构建不受影响。
v0.5.0(2026-11-04,业务库操作收进同一个 Db)
- 新增
Db::query_json_raw(sql, params):持Db.lock、row_to_json包裹、不做 JSON 键归一(f_id原样返回),给自带归一语义的厚业务仓用。 - 新增
Db::query_rows(sql, params):持锁返回原始pglite::Row(pg_catalog元数据 / 取首行首列),业务仓经sspf::pglite引用类型、不必自己声明依赖。 - 新增
Db::lock_owned() -> OwnedMutexGuard<()>:与所有Db::*/DbTransaction共用同一把锁;持 guard 期间可在裸句柄上跑自有 SQL。 query_json_inner拆成共用的query_json_inner_raw(包裹 + 反序列化)+ 归一那一层 ⇒ SQL 包裹只有一份;query_json*行为一字未改。- 新增闸门 AR20(raw 不归一 / 共用包裹段 / 公开入口全持同一把锁)+ 反自证 15/15;新增探针
db_raw_it.rs(4 条:raw 键不归一、归一路径同时成立、guard 期间Db::exec被阻塞、query_rows读pg_catalog)。 Db::pg()文档补「要与平台共用串行域该走哪个入口」的指路表;销掉 v0.3.0 的「双锁」已知局限(docs/known-limitations.md的 (bq))。- 影响:面 A / 面 B 端点形状、码表、表结构零变化;
Platform的公开签名未改(Finish::default()路径逐字等价)。sspf版本 0.5.0。 - 新增
scripts/release.sh:读crates/sspf版本 →cargo build --release -p sspf-admin→ 组装自包含发布包dist/sspf-vX.Y.Z.tar.gz(预编译sspf-admin二进制 + 平台 crate 源码闭包 17 个 +src/backend+Cargo.lock+rust-toolchain.toml+ 前端源码)。 消费方(技能仓 / 业务仓)解包到vendor/用path依赖接入,不再直接依赖 git 仓、不再 clone 整个 monorepo、不再每次重编 20+ crate。详见docs/SSPF-PLATFORM-PACKAGE.md§6。
2026-11-06(v0.5.0 内增量,不升版本号)
- 官方示例数据对齐:以
jnpf_dbnull_init.sql为真值源生成demo_seed.sql(58 表 / 14242 行)并缺省导入;补base_province/base_language/base_province_atlas修掉三个空页面;DDL 幂等化。 - 修静态托管相对路径 bug:
SSW_STATIC_DIR在配置解析时按 CWD 绝对化(PGlite 会chdir,否则/全返 JSON 404)。 - 新增
scripts/pack-jnpf-assets.sh:独立产出dist/jnpf-7.0-assets.tar.gz(官方 web 静态前端 + 示例数据库 + manifest/SHA256SUMS)。资产包只绑定 JNPF 版本,与 sspf 版本 / OS / CPU / 工具链 / 部署环境无关,所有平台复用一份。 - 新增
SSW_ASSETS_DIR(一个 env 同时定位web/与db/demo_seed.sql)、SSW_DEMO_SEED_FILE;外置示例数据优先、编译期内嵌兜底 ⇒ 换 JNPF 演示数据不必重编二进制。 scripts/release.sh的web/改以资产包为唯一真源,新增--no-web完全剥离静态前端;README 补两种消费方式。- 影响:不设新 env 时行为逐字不变;50 个 lib 单测通过、解包资产包端到端启动验证通过。差异明细见
docs/AB-COMPARE-2026-11-06.md。 - 发布:平台包覆盖上传到 Gitea Release
v0.5.0;资产包发到独立 releasejnpf-assets-7.0(附.sha256)。pack-jnpf-assets.sh --publish幂等重发(同名 asset 先删后传、tag 不存在自动推),不依赖 sspf 发版。
v0.4.0(2026-11-04,平台包零业务清理)
- 4 个示例业务包与
modules/的 4 个面 A 适配器整体移出本仓;packs/与sspf-pack-*依赖、example-packsfeature、门面example_packs()全部移除。 sspf-admin改为纯平台装配:只剩 177 张平台表,面 A 无业务端点;业务改由sspf::Platform::packs/ddl/menus/router注入。- 生成器
pack-sync.py把「零包」钉成合法目标态:四处派生位置恒空,出现业务包直接报错。 - 静态闸门(CP1 / check-module / 契约反自证)与运行时尺子(面 A 21 条、包冒烟)改跑防回流断言:示例业务回流平台仓立即红。
- 纯业务测试
crud_it.rs与new-pack脚手架随示例移交技能仓;db_it/batch7_it/auth_it改用平台内置夹具。 - 门面
sspf的 cargo 版本同步为0.4.0(与 tag 一致);技能仓按tag = "v0.4.0"锁依赖。 - 影响:本仓不再自带可跑的业务示例,集成测试数下降;
verify.sh --smoke需先cargo build --release -p sspf-admin。
v0.3.0(2026-11-04)
- 新增两阶段装配
Platform::assemble()/Assembled::finish()/serve()与Finish注入点:自带状态类型的业务路由可挂进平台唯一装配链,业务状态可在开库后构造。 Db改用Arc<PGlite>并公开pg()⇒ 业务仓与平台共用一个库句柄,不必另开 PGlite;Db::clone()语义不变。Extras新增自带状态路由 / 可替换兜底 / 全局 middleware 层三个注入点;with_state前移到 merge 之前,build_app()默认路径行为不变。- 面 A / 面 B、
base_*表、cipher、602 码、panic ⇒ 200 +code=400全部保持不变;v0.2.0的公开签名未改。 - 新增集成探针
business_composition_it.rs与闸门 AR19(唯一装配链,反自证 14/14);sspf版本 0.3.0。 - 已知局限:
Db::pg()绕过Db.lock时,平台与业务各自的多语句事务可能交错;业务 413 响应由平台改写为信封。见docs/known-limitations.md。
v0.2.0(2026-11-04)
- 新增门面 crate
sspf:业务仓唯一依赖,Platformbuilder +runtime启动动作;sspf-admin退化为 CLI 薄壳。 - 4 个示例包降为
example-packsfeature ⇒ 默认依赖树不含sspf-pack-*;新增 AR17 / AR18 与仓外消费探针。