BzlMod结合Golang时出现包缺失与函数错误问题求助

错误分析 #

你遇到的fetch_repo: read .../bazel-bin: Incorrect function和no such package错误，核心原因是Gazelle错误地将本地greetings库当作外部远程依赖处理，尝试从Bazel输出目录bazel-bin读取内容，而该目录并非源码目录，导致读取失败。Windows系统下的"Incorrect function"错误通常表示程序尝试对非预期的文件系统对象执行操作（比如读取目录时遇到特殊文件或权限限制）。

具体修复步骤 #

1. 为本地模块添加正确的go.mod #

每个Go模块都需要独立的go.mod文件来标识模块身份：

• 在greetings目录下执行：

  go mod init com.bdl.greetings
  

• 在hello目录下执行，完成本地依赖关联：

  go mod init com.bdl.hello
  go edit -replace com.bdl.greetings=../greetings
  go get com.bdl.greetings
  

2. 调整MODULE.bazel配置 #

让BzlMod明确识别本地模块，避免Gazelle误将其当作远程依赖拉取：

module(name = "com.bdl.hello")

bazel_dep(name = "rules_go", version = "0.48.1")
bazel_dep(name = "gazelle", version = "0.35.0")

# 声明本地greetings模块的路径覆盖
local_path_override(
    module_name = "com.bdl.greetings",
    path = "../greetings",
)

3. 修复hello/BUILD文件的依赖引用 #

将错误的外部仓库依赖路径改为本地模块的正确引用格式：

load("@rules_go//go:def.bzl", "go_library", "go_binary")

go_library(
    name = "hello_lib",
    srcs = ["hello.go"],
    importpath = "com.bdl.hello",
    deps = ["@com_bdl_greetings//:greetings"],
)

go_binary(
    name = "hello",
    embed = [":hello_lib"],
)

4. 用Gazelle同步配置 #

在项目根目录执行以下命令，确保BUILD文件与Go模块配置一致：

bazel run //:gazelle -- update-repos -from_file=hello/go.mod
bazel run //:gazelle

关键注意事项 #

• 清理旧配置：迁移到BzlMod后，彻底移除旧WORKSPACE文件中与Go依赖相关的go_repository声明，避免新旧逻辑冲突。
• 清除缓存：如果之前的错误缓存导致问题残留，执行bazel clean --expunge清除所有Bazel缓存后重新构建。
• 模块路径一致性：确保go.mod中的模块名、MODULE.bazel中的local_path_override名称、BUILD文件中的依赖引用完全匹配。

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