Bazel使用go:embed指令运行时报SIGSEGV段错误该如何解决？

问题根因 #

出现unexpected fault address 0x0段错误的核心原因是Bazel构建配置错误，导致embed.FS变量未被正确初始化：

• go_binary的embed字段用于指定要嵌入二进制的资源目标，不能用来引用Go代码库，你将带main包的my_lib放在embed字段中，导致库代码没有被正确链接到最终二进制，嵌入的资源段也没有被正确映射到变量地址。
• 额外添加的-dynlink编译参数和linkmode=pie配置在rules_go的旧版本中会破坏嵌入资源段的加载逻辑，进一步加重问题。

解决方案 #

步骤1：修正构建配置依赖关系 #

将go_binary中的embed = [":my_lib"]移动到deps字段，若没有强制动态链接需求，移除冗余的动态链接参数：

go_library(
    name = "my_lib",
    srcs = ["main.go"],
    embedsrcs = glob(["static/**/*"]),
    importpath = "github.com/myorg/myrepo",
    visibility = ["//visibility:private"],
    deps = ["//cmd"],
)

go_binary(
    name = "my_linux_amd64",
    cgo = True,
    deps = [":my_lib"], # 代码依赖放在deps字段
    # 无动态链接需求可删除以下两行
    # gc_goopts = ["-dynlink"],
    # linkmode = "pie",
    goarch = "amd64",
    goos = "linux",
    visibility = ["//visibility:public"],
)

步骤2（可选）：简化配置避免层级问题 #

如果不需要单独拆分go_library，可以直接将所有配置合并到go_binary中，减少配置出错概率：

go_binary(
    name = "my_linux_amd64",
    srcs = ["main.go"],
    embedsrcs = glob(["static/**/*"]),
    importpath = "github.com/myorg/myrepo",
    cgo = True,
    goarch = "amd64",
    goos = "linux",
    visibility = ["//visibility:public"],
    deps = ["//cmd"],
)

步骤3：校验嵌入资源有效性 #

可在main函数入口添加校验逻辑，提前定位嵌入失败问题：

package main

import (
    "embed"
    "log"
)

//go:embed static/*
var staticFS embed.FS

func main() {
    // 校验静态资源是否加载成功
    if _, err := staticFS.ReadDir("static"); err != nil {
        log.Fatalf("静态资源加载失败: %v", err)
    }
    // 后续业务逻辑
}

路径匹配检查 #

确保//go:embed static/*的路径和embedsrcs的glob规则匹配，static目录需要和main.go在同一个BUILD包的目录层级下。

内容的提问来源于stack exchange，提问作者a11hard