本质是go.mod声明版本与本地go版本不匹配。需检查go.mod首行go x.y是否等于go version输出，不一致则修改并运行go mod tidy，注意incompatible提示；同时排查依赖包版本及//go:build约束是否生效。
FrankenPHP 源码编译时报 requires go X.Y or later，本质是本地 Go 编译器版本与项目 go.mod 中声明的 go X.Y 不匹配——不是 FrankenPHP 本身有问题，而是 Go 模块约束在起作用。
检查 go.mod 声明版本是否高于本地 go version
这是最常见原因：你装了 go 1.25，但 go.mod 第一行写着 go 1.26，go build 会直接拒绝执行，连错误堆栈都不输出。
- 运行
go version确认真实版本（别只看$GOROOT路径） - 打开项目根目录的
go.mod，检查首行go X.Y是否严格等于go version输出的主次版本号 - 若不一致，手动改成匹配值（例如从
go 1.26改为go 1.25），然后立刻执行go mod tidy - 注意控制台是否出现
incompatible提示——那是模块版本解析失败的明确信号
FrankenPHP 依赖的 Go 包要求更高版本
FrankenPHP 本身可能没升级，但它所依赖的某个 Go 模块（比如 caddyserver/caddy/v2 或 php/php-go）已在新版本中声明 go 1.25+。此时即使你改了 go.mod，go mod tidy 仍可能把高版本依赖拉进来，触发校验失败。
- 运行
go list -u -m all | grep -E "(caddy|php-go|frankenphp)"查看关键依赖的实际版本 - 对可疑模块执行
go get github.com/xxx/yyy@vX.Y.Z锁定一个已知兼容的旧版（例如caddyserver/caddy/v2@v2.7.6） - 再跑一次
go mod tidy，观察go.sum中对应条目是否更新、是否还有incompatible - 不要删
go.sum来“绕过”校验——它保证的是依赖完整性，删了反而可能引入被篡改的包
//go:build 约束失效导致编译跳过适配逻辑
FrankenPHP 的某些 Go 文件用 //go:build go1.24 标记了仅在新版生效的代码路径。如果这个约束没生效，编译器可能误入不兼容分支，或干脆忽略本该启用的修复逻辑。
- 确认
//go:build行正上方**没有任何字符**（包括空格、tab、空行），且紧邻package声明 - 多条件写法必须用空格分隔，
//go:build go1.24 !windows正确，//go:build go1.24 && !windows会失效 - 用
!go1.23匹配的是所有 **低于 1.23 的版本**，不包含 1.23 本身——这点极易误判导致条件错位 - 可临时加
// +build ignore注释掉疑似问题文件，验证是否编译通过，缩小排查范围
FrankenPHP 编译卡在 Go 版本上，往往不是版本数字本身的问题，而是 go.mod、依赖链、构建约束三者之间没对齐。最容易被忽略的是：改完 go.mod 后忘记 go mod tidy，或者 tidy 后没检查 incompatible 提示——这两个动作缺一不可。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
