Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 29, 2026

go install go-micro.dev/v5/cmd/protoc-gen-micro@latest fails with module path conflicts because Go proxy has cached v0-v3 tags using incompatible module paths (github.com/micro/go-micro, github.com/asim/go-micro/v3, etc).

go: go-micro.dev/v5/cmd/protoc-gen-micro@latest: version constraints conflict:
    go-micro.dev/v5/cmd/protoc-gen-micro@v1.18.0: parsing go.mod:
    module declares its path as: github.com/micro/go-micro
            but was required as: go-micro.dev/v5/cmd/protoc-gen-micro

Changes

  • Documentation: Replace @latest with @v5.13.0 in all install commands
  • User guidance: Add notes explaining version pinning with links to releases page
  • Files updated: README.md, getting-started.md, server.md, migration guides, CLI README

Why Not Delete Tags or Use Retract

Investigated but rejected:

  • Tag deletion: Go proxy cache persists (173 cached versions). Destructive, no benefit.
  • Retract directive: Only works within same major version. Cannot retract v0-v3 from v5 go.mod.

Module Path History

Version Module Path Status
v0-v1 github.com/micro/go-micro ❌ Incompatible
v2 github.com/micro/go-micro/v2 ❌ Incompatible
v3 github.com/asim/go-micro/v3 ❌ Incompatible
v4-v5 go-micro.dev/v{4,5} ✅ Compatible

Documenting specific version is the only viable solution given Go module proxy behavior and retract limitations.

Original prompt

This section details on the original issue you should resolve

<issue_title>[QUESTION] About Go Install Cmd Package Failed With @latest tag</issue_title>
<issue_description>## Your question
Document https://go-micro.dev/docs/getting-started.html recormend go install go-micro.dev/v5/cmd/protoc-gen-micro@latest, but failed with follow message

go install go-micro.dev/v5/cmd/protoc-gen-micro@latest
go: go-micro.dev/v5/cmd/protoc-gen-micro@latest: version constraints conflict:
        go-micro.dev/v5/cmd/protoc-gen-micro@v1.18.0: parsing go.mod:
        module declares its path as: github.com/micro/go-micro
                but was required as: go-micro.dev/v5/cmd/protoc-gen-micro

What have you tried?

Try https://github.com/micro/go-micro/tree/master/cmd/protoc-gen-micro recormend go install go-micro.dev/v5/cmd/protoc-gen-micro@v5.10.0, and success.

go install go-micro.dev/v5/cmd/micro@v5.10.0
go: downloading github.com/golang-jwt/jwt/v5 v5.3.0
go: downloading github.com/xlab/treeprint v1.2.0
go: downloading github.com/stretchr/objx v0.5.2
go: downloading github.com/imdario/mergo v0.3.13

Context

My Question is the document was misunderstand. Hope can give some solution and make document less wrong infomation.

Resources you've checked

Helpful links

<agent_instructions>Resolve this issue. We've been dealing with inability to install latest for a long time. If it requires deleting old tags so be it but understand the issue and fix it.</agent_instructions>

Comments on the Issue (you are @copilot in this section)


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI and others added 3 commits January 29, 2026 08:48
…l commands

Co-authored-by: asim <17530+asim@users.noreply.github.com>
Co-authored-by: asim <17530+asim@users.noreply.github.com>
Co-authored-by: asim <17530+asim@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix Go install command package error with @latest tag Fix go install @latest module path conflicts Jan 29, 2026
Copilot AI requested a review from asim January 29, 2026 08:55
Copilot AI changed the title Fix go install @latest module path conflicts Fix go install @latest failures by documenting specific version Jan 29, 2026
@asim asim marked this pull request as ready for review January 29, 2026 10:19
@asim asim merged commit 87cf988 into master Jan 29, 2026
2 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[QUESTION] About Go Install Cmd Package Failed With @latest tag

2 participants