Upgrading to bazel modules

[itmecho]

🐛 Bug Report

I'm trying to upgrade our monorepo to bazel modules but I'm getting an issue where grpc-gateway doesn't seem to be able to resolve the @googleapis module. This is the error I'm getting:

ERROR: no such package '@@[unknown repo 'googleapis' requested from @@gazelle++go_deps+com_github_grpc_ecosystem_grpc_gateway_v2]//google/api': The repository '@@[unknown repo 'googleapis' requested from @@gazelle++go_deps+com_github_grpc_ecosystem_grpc_gateway_v2]' could not be resolved: No repository visible as '@googleapis' from repository '@@gazelle++go_deps+com_github_grpc_ecosystem_grpc_gateway_v2'

I have tried running the following commands and they both work so I'm pretty sure I've configured the root module correctly

bazel build @googleapis//google/api:annotations_proto
bazel build @googleapis//google/api:annotations_go_proto

To Reproduce

I have created a minimal repo that has the same issue. The README contains the output from some relevant commands.

https://github.com/itmecho/bzlmodgotest

Expected behavior

grpc-gateway should be able to resolve @googleapis

Actual Behavior

ERROR: no such package '@@[unknown repo 'googleapis' requested from @@gazelle++go_deps+com_github_grpc_ecosystem_grpc_gateway_v2]//google/api': The repository '@@[unknown repo 'googleapis' requested from @@gazelle++go_deps+com_github_grpc_ecosystem_grpc_gateway_v2]' could not be resolved: No repository visible as '@googleapis' from repository '@@gazelle++go_deps+com_github_grpc_ecosystem_grpc_gateway_v2'

Your Environment

macOS 15.3.2
go 1.24
bazel 8.1.1

[johanbrandhorst]

Hi, thanks for the issue. I'm really not very familiar with Bazel, but I've been fortunate enough to have had help from contributors like @AlejoAsd, who may be able to figure out what's going on 😬.

[iampat]

@itmecho You can add these gazelle directive in your mono-repo

# gazelle:resolve proto proto google/api/annotations.proto @googleapis//google/api:annotations_proto
# gazelle:resolve proto go google/api/annotations.proto  @org_golang_google_genproto_googleapis_api//annotations
gazelle(name = "gazelle")

[itmecho]

I have tried adding those gazelle directives to both my work mono repo as well as the linked example repo and I still get the same error in both.

ERROR: BAZEL_ROOT/external/gazelle++go_deps+com_github_grpc_ecosystem_grpc_gateway_v2/internal/descriptor/apiconfig/BUILD.bazel:7:14: no such package '@@[unknown repo 'googleapis' requested from @@gazelle++go_deps+com_github_grpc_ecosystem_grpc_gateway_v2]//google/api': The repository '@@[unknown repo 'googleapis' requested from @@gazelle++go_deps+com_github_grpc_ecosystem_grpc_gateway_v2]' could not be resolved: No repository visible as '@googleapis' from repository '@@gazelle++go_deps+com_github_grpc_ecosystem_grpc_gateway_v2' and referenced by '@@gazelle++go_deps+com_github_grpc_ecosystem_grpc_gateway_v2//internal/descriptor/apiconfig:apiconfig_proto'

I'm pretty sure that the gazelle directives just affect what is emitted into the BUILD files in my repo, not the content of dependency BUILD files.

Just in case, I checked the BUILD.bazel file from the error message and I can see that it's importing google/api/http.proto, not annotations.proto so I tried adding directives for that as well and I still get the same error.

Again, I can see that @googleapis (and @@googleapis) are available in my repo using the following commands:

❯ bazel query "@googleapis//google/api:annotations_proto"
@googleapis//google/api:annotations_proto

❯ bazel query "@@googleapis//google/api:annotations_proto"
@@googleapis//google/api:annotations_proto