FrankenPHP静态构建失败时无独立日志文件，所有错误仅输出到终端stderr，必须当场重定向捕获（如make static > build.out 2>&1）或用script命令录屏，否则消失；ldd验证需显示“not a dynamic executable”才算真正静态成功。
frankenphp 静态构建失败时，没有独立的“编译日志文件”，所有构建过程输出（含错误）都直接打印在终端 stderr，必须当场捕获或重定向，否则消失。
构建命令本身不生成日志文件，stderr 就是唯一线索
FrankenPHP 的静态构建（如 make static 或 go build -ldflags '-extldflags "-static"' ./cmd/frankenphp）由 Go 工具链驱动，它不会写入 build.log 或类似文件。任何失败信息——比如 undefined reference to 'dlopen'、cannot find -lcrypto、CGO_ENABLED=0 required but cgo is enabled——都只出现在你执行命令的终端里。
- 别等构建完再找日志：失败瞬间就停，最后一屏就是关键
- 如果用了
nohup或后台任务，必须显式重定向：make static > build.out 2>&1 - 用
script命令录屏式捕获更可靠：script -c "make static" build-session.log
常见失败原因与对应错误关键词
Go 静态链接对 C 依赖极其敏感，报错通常直指缺失项或冲突配置：
-
undefined reference to 'SSL_CTX_new'→ OpenSSL 符号未解析，说明系统 OpenSSL 开发包未安装（Ubuntu/Debian 要libssl-dev，CentOS/RHEL 要openssl-devel） -
cannot find -lresolv→libc静态版缺libresolv.a，需装glibc-static（RHEL 系）或libc6-dev+ 手动补全（Debian 系） -
CGO_ENABLED=0 required但提示cgo is enabled→ 环境变量没生效，检查是否漏了export CGO_ENABLED=0，或被Makefile覆盖 -
plugin.Open: plugin was built with a different version of package→ Go 版本混用，确保整个构建环境（go version、GOPATH、GOROOT）统一
验证静态性是否真正达成
即使构建成功，也不代表二进制真的静态——得用 ldd 实锤：
立即学习“PHP免费学习笔记（深入）”；
- 运行
ldd ./frankenphp，若输出not a dynamic executable，才算成功 - 若列出一堆
libcrypto.so、libssl.so，说明仍动态链接，构建“假静态” - 此时回看构建终端输出，重点搜
linker、dynamic、shared相关警告行，它们常被淹没在大量编译输出中
交叉构建或 CI 环境下日志易丢失
Docker 构建或 GitHub Actions 中，stdout/stderr 可能被截断或缓冲，导致关键错误被吞掉：
- 在
Dockerfile中加ENV CGO_ENABLED=0和GOFLAGS=-v，让 Go 输出更详细步骤 - CI 脚本里避免管道过滤：
make static 2>&1 | grep -i error会丢上下文，应先保存完整输出再查 - GitHub Actions 可用
actions/upload-artifact上传build.out，便于事后下载分析
静态构建失败几乎从不藏在某个配置文件里，它就卡在你敲下回车后那几秒的终端输出里——盯住 stderr，比翻文档快十倍。
