cmd/go: doc -http sometimes doesn't find x/pkgsite/cmd/internal/doc

[seankhliao]

Go version

go version go1.27-devel_d247ed00e4 2026-03-28 13:07:33 -0700 linux/amd64

Output of go env in your module/workspace:

AR='ar'
CC='gcc'
CGO_CFLAGS='-O2 -g'
CGO_CPPFLAGS=''
CGO_CXXFLAGS='-O2 -g'
CGO_ENABLED='0'
CGO_FFLAGS='-O2 -g'
CGO_LDFLAGS='-O2 -g'
CXX='g++'
GCCGO='gccgo'
GO111MODULE=''
GOAMD64='v3'
GOARCH='amd64'
GOAUTH='netrc'
GOBIN=''
GOCACHE='/home/user/.cache/go-build'
GOCACHEPROG=''
GODEBUG=''
GOENV='/home/user/.config/go/env'
GOEXE=''
GOEXPERIMENT='jsonv2'
GOFIPS140='off'
GOFLAGS='-trimpath "-ldflags=-s -w" -vet=all'
GOGCCFLAGS='-fPIC -m64 -Wl,--no-gc-sections -fmessage-length=0 -ffile-prefix-map=/tmp/go-build1601698657=/tmp/go-build -gno-record-gcc-switches'
GOHOSTARCH='amd64'
GOHOSTOS='linux'
GOINSECURE=''
GOMOD='/home/user/tmp/testrepo1442/go.mod'
GOMODCACHE='/home/user/.data/go/pkg/mod'
GONOPROXY=''
GONOSUMDB=''
GOOS='linux'
GOPATH='/home/user/.data/go'
GOPRIVATE=''
GOPROXY='https://proxy.golang.org,direct'
GOROOT='/home/user/sdk/go'
GOSUMDB='sum.golang.org'
GOTELEMETRY='on'
GOTELEMETRYDIR='/home/user/.config/go/telemetry'
GOTMPDIR=''
GOTOOLCHAIN='path'
GOTOOLDIR='/home/user/sdk/go/pkg/tool/linux_amd64'
GOVCS=''
GOVERSION='go1.27-devel_d247ed00e4 2026-03-28 13:07:33 -0700'
GOWORK=''
PKG_CONFIG='pkg-config'

What did you do?

go doc -http

What did you see happen?

go doc -http
go: golang.org/x/pkgsite/cmd/internal/doc@v0.0.0-20251223195805-1a3bd3c788fe: module golang.org/x/pkgsite@v0.0.0-20251223195805-1a3bd3c788fe found, but does not contain package golang.org/x/pkgsite/cmd/internal/doc

What did you expect to see?

docs being served.

---

I think this has something to do with how GOMODCACHE is added as a proxy https://cs.opensource.google/go/go/+/master:src/cmd/go/internal/doc/pkgsite.go;l=67?q=pkgsite&ss=go%2Fgo

If i copy the commands, I get the same result:

export GOPROXY=file:///home/user/.data/go/pkg/mod,https://proxy.golang.org,direct

go run golang.org/x/pkgsite/cmd/internal/doc@v0.0.0-20251223195805-1a3bd3c788fe
go: golang.org/x/pkgsite/cmd/internal/doc@v0.0.0-20251223195805-1a3bd3c788fe: module golang.org/x/pkgsite@v0.0.0-20251223195805-1a3bd3c788fe found, but does not contain package golang.org/x/pkgsite/cmd/internal/doc
19:08:28 ~/mono 0:00:00

What's in my module cache:

mod/cache/download/golang.org/x/pkgsite/cmd/internal/doc/@v
├── list
├── v0.0.0-20250608123103-82c52f1754cd.info
├── v0.0.0-20250608123103-82c52f1754cd.lock
├── v0.0.0-20250608123103-82c52f1754cd.mod
├── v0.0.0-20250608123103-82c52f1754cd.zip
├── v0.0.0-20250608123103-82c52f1754cd.ziphash
├── v0.0.0-20250611185244-041c7c0b878c.info
├── v0.0.0-20250611185244-041c7c0b878c.mod
├── v0.0.0-20251209150622-7dafa59905ae.info
├── v0.0.0-20251209150622-7dafa59905ae.lock
├── v0.0.0-20251209150622-7dafa59905ae.mod
├── v0.0.0-20251209150622-7dafa59905ae.zip
└── v0.0.0-20251209150622-7dafa59905ae.ziphash

mod/cache/download/golang.org/x/pkgsite/@v
├── list
├── v0.0.0-20250511204254-5c1473fa3d5c.info
├── v0.0.0-20250530170220-274f41854e53.info
├── v0.0.0-20250530170220-274f41854e53.lock
├── v0.0.0-20250530170220-274f41854e53.mod
├── v0.0.0-20250530170220-274f41854e53.zip
├── v0.0.0-20250530170220-274f41854e53.ziphash
├── v0.0.0-20250610033053-77fcf55b4a93.info
├── v0.0.0-20250610033053-77fcf55b4a93.lock
├── v0.0.0-20250610033053-77fcf55b4a93.mod
├── v0.0.0-20250610033053-77fcf55b4a93.zip
├── v0.0.0-20250610033053-77fcf55b4a93.ziphash
├── v0.0.0-20250611185244-041c7c0b878c.info
├── v0.0.0-20250611185244-041c7c0b878c.lock
├── v0.0.0-20250611185244-041c7c0b878c.mod
├── v0.0.0-20250611185244-041c7c0b878c.zip
├── v0.0.0-20250611185244-041c7c0b878c.ziphash
├── v0.0.0-20250624191723-ae590d8f0828.info
├── v0.0.0-20250624191723-ae590d8f0828.lock
├── v0.0.0-20250624191723-ae590d8f0828.mod
├── v0.0.0-20250624191723-ae590d8f0828.zip
├── v0.0.0-20250624191723-ae590d8f0828.ziphash
├── v0.0.0-20250714212547-01b046e81fe7.info
├── v0.0.0-20250714212547-01b046e81fe7.lock
├── v0.0.0-20250714212547-01b046e81fe7.mod
├── v0.0.0-20250714212547-01b046e81fe7.zip
├── v0.0.0-20250714212547-01b046e81fe7.ziphash
├── v0.0.0-20250808145627-259676f24e15.info
├── v0.0.0-20250808145627-259676f24e15.lock
├── v0.0.0-20250808145627-259676f24e15.mod
├── v0.0.0-20250808145627-259676f24e15.zip
├── v0.0.0-20250808145627-259676f24e15.ziphash
├── v0.0.0-20250814150923-ed9d06afb3a5.info
├── v0.0.0-20250814150923-ed9d06afb3a5.lock
├── v0.0.0-20250814150923-ed9d06afb3a5.mod
├── v0.0.0-20250814150923-ed9d06afb3a5.zip
├── v0.0.0-20250814150923-ed9d06afb3a5.ziphash
├── v0.0.0-20250911091732-133263251ca1.info
├── v0.0.0-20250924225224-211c74d89dd6.info
├── v0.0.0-20251002203609-0eaf81aaa318.info
├── v0.0.0-20251009145832-31e4cbb15040.info
├── v0.0.0-20251009145832-31e4cbb15040.lock
├── v0.0.0-20251009145832-31e4cbb15040.mod
├── v0.0.0-20251009145832-31e4cbb15040.zip
├── v0.0.0-20251009145832-31e4cbb15040.ziphash
├── v0.0.0-20251024141022-4bd6c634f204.info
├── v0.0.0-20251112223242-2e72efd8d3b2.info
├── v0.0.0-20251112223242-2e72efd8d3b2.lock
├── v0.0.0-20251112223242-2e72efd8d3b2.mod
├── v0.0.0-20251112223242-2e72efd8d3b2.zip
├── v0.0.0-20251112223242-2e72efd8d3b2.ziphash
├── v0.0.0-20251118165432-34653ef2f2a0.info
├── v0.0.0-20251128220431-d74adeade195.info
├── v0.0.0-20251128220431-d74adeade195.lock
├── v0.0.0-20251128220431-d74adeade195.mod
├── v0.0.0-20251128220431-d74adeade195.zip
├── v0.0.0-20251128220431-d74adeade195.ziphash
├── v0.0.0-20251203124402-99205010eb11.info
├── v0.0.0-20251208143429-c3ac91df4d42.info
├── v0.0.0-20251208194643-ee5cf2ff08b8.info
├── v0.0.0-20251208224453-b9c581e8f809.info
├── v0.0.0-20251208224703-b1518c6a6f10.info
├── v0.0.0-20251208224703-b1518c6a6f10.lock
├── v0.0.0-20251208224703-b1518c6a6f10.mod
├── v0.0.0-20251208224703-b1518c6a6f10.zip
├── v0.0.0-20251208224703-b1518c6a6f10.ziphash
├── v0.0.0-20251209150622-7dafa59905ae.info
├── v0.0.0-20251209150622-7dafa59905ae.lock
├── v0.0.0-20251209150622-7dafa59905ae.zip
├── v0.0.0-20251209150622-7dafa59905ae.ziphash
├── v0.0.0-20251213150745-dc8b9941bcba.info
├── v0.0.0-20251213155204-fe3eb9fd7911.info
├── v0.0.0-20251213224926-ad8e73ea1476.info
├── v0.0.0-20251214001343-d70694ebf6e2.info
├── v0.0.0-20251214084451-9bbfb19312a0.info
├── v0.0.0-20251214090911-4956025594a4.info
├── v0.0.0-20251215153041-4eb0af2c34bf.info
├── v0.0.0-20251215153041-4eb0af2c34bf.lock
├── v0.0.0-20251215153041-4eb0af2c34bf.mod
├── v0.0.0-20251215153041-4eb0af2c34bf.zip
├── v0.0.0-20251215153041-4eb0af2c34bf.ziphash
├── v0.0.0-20251222135808-7f1b33f0c89e.info
├── v0.0.0-20251223195805-1a3bd3c788fe.info
├── v0.0.0-20251223195805-1a3bd3c788fe.lock
├── v0.0.0-20251223195805-1a3bd3c788fe.mod
├── v0.0.0-20251223195805-1a3bd3c788fe.zip
├── v0.0.0-20251223195805-1a3bd3c788fe.ziphash
├── v0.0.0-20260116214158-550788255d99.info
├── v0.0.0-20260116214158-550788255d99.lock
├── v0.0.0-20260116214158-550788255d99.mod
├── v0.0.0-20260116214158-550788255d99.zip
├── v0.0.0-20260116214158-550788255d99.ziphash
├── v0.0.0-20260212172942-ce44214c045b.info
├── v0.0.0-20260212172942-ce44214c045b.lock
├── v0.0.0-20260212172942-ce44214c045b.mod
├── v0.0.0-20260212172942-ce44214c045b.zip
├── v0.0.0-20260212172942-ce44214c045b.ziphash
├── v0.0.0-20260214132943-80b9fcc7f7b5.info
├── v0.0.0-20260214133012-ffbebfd02cc3.info
├── v0.0.0-20260224180715-dfa517ef2f80.info
├── v0.0.0-20260224180715-dfa517ef2f80.lock
├── v0.0.0-20260224180715-dfa517ef2f80.mod
├── v0.0.0-20260224180715-dfa517ef2f80.zip
├── v0.0.0-20260224180715-dfa517ef2f80.ziphash
├── v0.0.0-20260306132053-fd3717b20fe8.info
├── v0.0.0-20260306132053-fd3717b20fe8.lock
├── v0.0.0-20260306132053-fd3717b20fe8.mod
├── v0.0.0-20260306132053-fd3717b20fe8.zip
├── v0.0.0-20260306132053-fd3717b20fe8.ziphash
├── v0.0.0-20260309224630-59cb58a64684.info
├── v0.0.0-20260309224630-59cb58a64684.lock
├── v0.0.0-20260309224630-59cb58a64684.mod
├── v0.0.0-20260309224630-59cb58a64684.zip
└── v0.0.0-20260309224630-59cb58a64684.ziphash

mod/golang.org/x
├── pkgsite
│   └── cmd
│       └── internal
│           ├── doc@v0.0.0-20250608123103-82c52f1754cd
│           └── doc@v0.0.0-20251209150622-7dafa59905ae
├── pkgsite@v0.0.0-20250530170220-274f41854e53
├── pkgsite@v0.0.0-20250610033053-77fcf55b4a93
├── pkgsite@v0.0.0-20250611185244-041c7c0b878c
├── pkgsite@v0.0.0-20250624191723-ae590d8f0828
├── pkgsite@v0.0.0-20250714212547-01b046e81fe7
├── pkgsite@v0.0.0-20250808145627-259676f24e15
├── pkgsite@v0.0.0-20250814150923-ed9d06afb3a5
├── pkgsite@v0.0.0-20251009145832-31e4cbb15040
├── pkgsite@v0.0.0-20251112223242-2e72efd8d3b2
├── pkgsite@v0.0.0-20251128220431-d74adeade195
├── pkgsite@v0.0.0-20251208224703-b1518c6a6f10
├── pkgsite@v0.0.0-20251209150622-7dafa59905ae
├── pkgsite@v0.0.0-20251215153041-4eb0af2c34bf
├── pkgsite@v0.0.0-20251223195805-1a3bd3c788fe
├── pkgsite@v0.0.0-20260116214158-550788255d99
├── pkgsite@v0.0.0-20260212172942-ce44214c045b
├── pkgsite@v0.0.0-20260224180715-dfa517ef2f80
├── pkgsite@v0.0.0-20260306132053-fd3717b20fe8
└── pkgsite@v0.0.0-20260309224630-59cb58a64684

[seankhliao]

cc @golang/go-command

[gabyhelp]

Related Issues

• cmd/go: doc: update embedded pkgsite version #76827 (closed)
• cmd/go: go doc -http downloads a module without license file #78450
• x/pkgsite: cannot refresh documentation locally #54479 (closed)
• x/pkgsite/cmd/pkgsite: Can’t display any non-stdlib docs #66781
• cmd/doc: go doc -http fails with undownloaded modules #73833 (closed)
• cmd/go,cmd/doc: http activity during 'go doc' #47196
• x/pkgsite/cmd/pkgsite: search not working in `-cache` mode #73877
• cmd/go: `go doc -http` ignores module when running from GOPATH #75976
• x/pkgsite: go doc -http shows duplicate std search results when run from GOROOT #74459 (closed)
• affected/package: godoc #52730 (closed)

_{(Emoji vote if this was helpful or unhelpful; more detailed feedback welcome in this discussion.)}

[gopherbot]

Change https://go.dev/cl/763760 mentions this issue: cmd/go: build pkgsite directory in same go command invocation