收编 TDS 侧重编的 glibc26 引擎后,补上 issue #1 关联问题 2 的实测验收, 并把「版本回退会重新绑高」这件事变成构建期可拦的门禁。 - 新增纯宿主侧 glibc 版本门禁(build-armv7.sh 第 3 步):读 ELF 动态符号的 版本节点,超过 GLIBC_2.18 直接构建失败。用宿主自带 LLVM objdump 即可读 arm ELF,不起容器、秒级。阈值可用 GLIBC_MAX_MINOR= 覆盖。 - 冒烟镜像由 bookworm-slim(glibc 2.36,与编译 sysroot 同版本 ⇒ 天然掩盖 问题)改为 buster(2.28)⇒ 版本回退会当场暴露。 - 实测版本需求:postgres 封顶 GLIBC_2.17、initdb 封顶 GLIBC_2.14、 sspf-admin 封顶 GLIBC_2.18(Rust std thread_local 析构,2.18 是理论下限) ⇒ 全部 ≤ 2.18,低于 ZYNQ 基线 2.26。libpglite.a 的 fcntl64 undefined 引用归零。 - 实测老 glibc:buster(2.28) 与 stretch(2.24,低于 ZYNQ) 里 initdb/postgres 正常;用已发布包里的 sspf-admin 在两个镜像上跑 stdout 三形态全部探活 200、 进程常驻、导入 14255 条示例数据。已发布包与本次编译 sha256 一致(可复现)。 - 文档:docs/armv7-glibc-compat.md 补 §5.1 收编结果与实测数据, §2.5 的建议标注为已落实。 commit: 关联 issue #1 的关联问题 2
9.8 KiB
armv7 平台包 glibc 兼容性整改规格(给 ssw-platform)
提交方:ssw-tds-test(设备侧接入方) 日期:2026-11-12 关联产物:
dist/sspf-v0.5.0-armv7-unknown-linux-gnueabihf.tar.gz(150M) 关联引擎:dist/pglite-armv7-unknown-linux-gnueabihf.tar.gz(10M)
1. 结论一句话
armv7 平台包架构是对的(rlib 全部 armv7-unknown-linux-gnueabihf,引擎二进制是 ARM EABI5 armhf),
但链接用的 sysroot 是 Debian 12 的 GLIBC 2.36,导致引擎被绑定到 GLIBC_2.34 版本节点,
在 glibc ≤ 2.28 的设备上无法启动(已实测复现)。
2. 实测证据
2.1 产物架构正确
libpglite.a : ARM 静态库
bin/initdb : ELF 32-bit LSB pie executable, ARM, EABI5, interpreter /lib/ld-linux-armhf.so.3
bin/postgres : ELF 32-bit LSB pie executable, ARM, EABI5
sspf 平台包 127 个 rlib : 目标三元组均为 armv7-unknown-linux-gnueabihf,无 x86_64 残留
2.2 版本要求过高(根因)
objdump -T 读出的版本需求:
| 二进制 | 需要的 GLIBC 版本 |
|---|---|
bin/postgres |
2.17, 2.25, 2.28, 2.29, 2.33, 2.34 |
bin/initdb |
2.10, 2.14, 2.28, 2.29, 2.33, 2.34 |
按版本号分组的符号:
| 版本节点 | 符号 |
|---|---|
| GLIBC_2.34 | __libc_start_main dlopen dlsym dlclose dlerror sem_init sem_destroy sem_post sem_wait sem_trywait shm_open shm_unlink |
| GLIBC_2.33 | stat64 fstat64 lstat64 |
| GLIBC_2.29 | exp log pow |
| GLIBC_2.28 | fcntl fcntl64 |
这些符号本身在 glibc 2.26 就全部存在(sem_*/shm_open/dlopen 都是老符号),
只是版本节点被绑高了 ⇒ 不是缺功能,是版本标签不匹配。
2.3 复现(不需要设备)
docker run --rm --platform linux/arm/v7 -v <rt>:/rt:ro arm32v7/debian:buster sh -c '/rt/bin/initdb --version'
输出(buster = glibc 2.28):
/rt/bin/initdb: /lib/arm-linux-gnueabihf/libm.so.6: version `GLIBC_2.29' not found (required by /rt/bin/initdb)
/rt/bin/initdb: /lib/arm-linux-gnueabihf/libc.so.6: version `GLIBC_2.33' not found (required by /rt/bin/initdb)
/rt/bin/initdb: /lib/arm-linux-gnueabihf/libc.so.6: version `GLIBC_2.34' not found (required by /rt/bin/initdb)
⇒ 在 glibc 2.28 上已经起不来。
2.4 根因定位
scripts/build-pglite-engine.sh用gcc-arm-linux-gnueabihf+libc6-dev-armhf-cross交叉编译引擎;scripts/build-armv7.sh的ZIG_SYSROOT指向dist/pglite-engine-armv7/sysroot;- 该 sysroot 里的 libc 是
Debian GLIBC 2.36-9+deb12u14(实测strings确认)。
⇒ 链接时所有符号取 glibc 2.36 的版本节点 ⇒ 最高 GLIBC_2.34。
2.5 上游现有冒烟为什么没发现
build-armv7.sh 的冒烟用 arm32v7/debian:bookworm-slim = glibc 2.36,
与编译 sysroot 同版本 ⇒ 天然通过,掩盖了问题。
建议把冒烟镜像改成 arm32v7/debian:buster(2.28)或更老的 stretch(2.24)。
✅ 已于 2026-11-13 落实:冒烟镜像默认改为
arm32v7/debian:buster, 另加了一道纯宿主侧的 glibc 版本门禁(超过GLIBC_2.18直接构建失败), 详见 §5.1.5。
3. 目标设备基线
| 设备 | 架构 | glibc | 备注 |
|---|---|---|---|
| ZYNQ 192.168.1.233 | armv7l | 2.26 | 无 docker,BusyBox,静态二进制唯一可行 |
| 海光 192.168.1.102 | x86_64 | 2.28 | 有 docker,但 glibc 仍低于 2.34 |
⇒ 引擎必须能在 glibc 2.26 上跑(ZYNQ 是硬约束)。
4. 两条可选修法
方案 A(推荐):改用 musl 静态,零设备 libc 依赖
- 目标三元组改为
armv7-unknown-linux-musleabihf; zig cc -target arm-linux-musleabihf -static自带 musl libc(zig 0.14.1 已验证);- 产物完全静态 ⇒ 设备 glibc 版本无关,ZYNQ 的 2.26 无任何风险;
- 顺带解决「ZYNQ 无 glibc 头文件/运行时」的依赖问题。
已本地验证 musl 静态 armv7 二进制在 arm32v7/debian:buster 与 alpine:3.20 上均正常运行。
⚠️ 注意点:
relocate-runtime-cross.sh里的patchelf --set-rpath对静态产物无意义,可跳过;- musl 下
libpq.so.5仍需打进 runtime(initdb依赖它); pglite-rs-sys的build.rs无条件-lz,musl 下 zlib 同样要静态链入。
方案 B:保留 gnueabihf,但用 ≤ 2.26 的 sysroot
- 交叉工具链换成 glibc ≤ 2.26 的 sysroot(如 Debian 9 stretch armhf / Ubuntu 16.04 armhf);
- 引擎与 Rust 侧二进制都用它链接;
- 优点:与设备 glibc 语义一致,
patchelf/RPATH 逻辑不变; - 缺点:sysroot 需自备,且 stretch 的 glibc 无
dlopen新符号问题要一并确认。
5. 验收标准(上游重编后请逐条自验)
# ① 引擎二进制不得要求高于 2.26 的 GLIBC
objdump -T bin/postgres | grep -oE 'GLIBC_2\.[0-9]+' | sort -uV | tail -1 # 期望 ≤ GLIBC_2.26
objdump -T bin/initdb | grep -oE 'GLIBC_2\.[0-9]+' | sort -uV | tail -1 # 期望 ≤ GLIBC_2.26
# ② 在老 glibc 的 armv7 容器里能起
docker run --rm --platform linux/arm/v7 -v <rt>:/rt:ro arm32v7/debian:buster \
sh -c '/rt/bin/initdb -D /tmp/pg -U check --no-sync -A trust -E UTF8' && echo INITDB_OK
# ③ 若走方案 A(musl),产物必须是静态
file bin/postgres | grep -q 'statically linked' && echo STATIC_OK
# ④ sspf-admin 整体冒烟(老 glibc 容器里起服务 + 探活)
docker run --rm --platform linux/arm/v7 ... arm32v7/debian:buster sh -c '...'
设备侧我方会再用 build/check-armv7-runtime.sh 做最终裁决(读设备 glibc 版本 + 试跑 initdb)。
5.1 平台侧收编结果(2026-11-13 已实测通过)
本节由 ssw-platform 填写,对应 Gitea issue
ssw/ssw-platform#1的「关联问题 2」。
5.1.1 采取的方案
走的是方案 B(保留 gnueabihf,替换为低版本 sysroot),未走方案 A(musl)——
因为方案 A 会改变三元组(armv7-unknown-linux-musleabihf),与已发布的
armv7-unknown-linux-gnueabihf 发布包不兼容,且 TDS 侧已按方案 B 重编好引擎。
引擎改用 zig cc 0.14.1 + glibc 2.26 sysroot 交叉编译,产物目录 dist/pglite-engine-armv7-glibc26/。
5.1.2 验收①:版本需求(实测)
objdump -T 读出的全部版本节点:
| 二进制 | 收编前(issue 实测) | 收编后(本次实测) | 封顶符号 |
|---|---|---|---|
postgres |
2.17, 2.25, 2.28, 2.29, 2.33, 2.34 | 2.17 | clock_gettime |
initdb |
2.10, 2.14, 2.28, 2.29, 2.33, 2.34 | 2.14 | syncfs |
sspf-admin(Rust 侧) |
— | 2.18 | __cxa_thread_atexit_impl |
⇒ 全部 ≤ 2.18,远低于文档 §3 要求的 ≤ 2.26(ZYNQ 基线)。
(__cxa_thread_atexit_impl 是 Rust std thread_local 析构所需,
任何 Rust 二进制都绕不开 ⇒ 2.18 是理论下限,再低不可达。)
静态库符号层面(issue 验收口径「fcntl64=0、pgl_fcntl=0、fcntl=1」):
libpglite.a:
undefined fcntl64 = 0 ← 收编前 pqcomm.o / postmaster.o 引用 fcntl64(GLIBC_2.28)
undefined fcntl = 6 ← miscinit.o postmaster.o pqcomm.o noblock_srv.o pglitec.o pglite_reset.o
undefined pgl_fcntl = 0
defined pgl_fcntl = 1 ← pglitec.o 内定义(T pgl_fcntl)
⇒ fcntl64 的 undefined 引用已归零。
5.1.3 验收②:老 glibc 容器实跑(实测)
| 镜像 | glibc | initdb --version |
initdb 实跑 |
postgres --version |
|---|---|---|---|---|
arm32v7/debian:buster |
2.28 | ✅ 17.5 | ✅ INITDB_OK(生成完整 PG_VERSION=17 数据目录) |
✅ |
arm32v7/debian:stretch |
2.24 | ✅ 17.5 | ✅ INITDB_OK |
✅ |
stretch 的 2.24 比 ZYNQ 的 2.26 更老 ⇒ 过了 stretch ⇒ ZYNQ 必然过。
5.1.4 验收④:sspf-admin 端到端(实测,用已发布包里的二进制)
dist/sspf-v0.5.0-armv7-unknown-linux-gnueabihf.tar.gz 内的 bin/sspf-admin,
在两个老 glibc 镜像上各跑 stdout 三形态(每形态都是全新容器 + 全新数据目录):
| 镜像 | case | stdout 形态 | HTTP 探活 | 进程常驻 | 「已启动」 | 「启动诊断」 |
|---|---|---|---|---|---|---|
| buster (2.28) | A | 继承 docker pipe | ✅ 200 | ✅ | ✅ | —(不走替换,符合预期) |
| buster (2.28) | B | → 普通文件 | ✅ 200 | ✅ | ✅ | ✅「原为 普通文件」 |
| buster (2.28) | C | → /dev/null | ✅ 200 | ✅ | —(进 /dev/null) | ✅「原为 字符设备(含终端)」 |
| stretch (2.24) | A | 继承 docker pipe | ✅ 200 | ✅ | ✅ | — |
| stretch (2.24) | B | → 普通文件 | ✅ 200 | ✅ | ✅ | ✅ |
| stretch (2.24) | C | → /dev/null | ✅ 200 | ✅ | — | ✅ |
数据导入:两个镜像均为 14255 条示例数据,数据目录 50M 正常。
5.1.5 已落地的门禁(防回退)
原冒烟用 arm32v7/debian:bookworm-slim(glibc 2.36,与编译 sysroot 同版本)
⇒ 天然通过、天然掩盖问题(正是 §2.5 指出的盲区)。现已改为:
- glibc 版本门禁(
scripts/build-armv7.sh第 3 步,纯宿主侧、秒级、不起容器): 读 ELF 动态符号的版本节点,超过GLIBC_2.18直接构建失败。 用宿主自带的/usr/bin/objdump(LLVM 版,可直接读 arm ELF)。 阈值可用GLIBC_MAX_MINOR=覆盖。 - 冒烟镜像改为
arm32v7/debian:buster(glibc 2.28)⇒ 版本回退会当场暴露。
6. 不在本次整改范围(但请知悉)
ssw-tds侧连接器(含tdc-rs)在 ZYNQ 上是独立静态二进制(Go,musl), 不依赖平台包的 glibc 符号版本 ⇒ 方案 B 落地后即使平台包仍有版本问题, 连接器本身仍可单独部署;- 但连接器启动后会拉起本地 PostgreSQL 引擎 ⇒ 引擎必须先修好,否则连接器起不来。