go-zero升级需分三步：先确认当前版本与v1.10.0的Breaking Changes（如移除Jaeger Exporter）、检查Go 1.23兼容性，再执行go get+go mod tidy、比对代码生成差异、运行全量测试及核心链路验证。
你正在维护一个用go-zero搭建的线上微服务，现在想升级框架版本但担心破坏现有功能、引发编译失败或运行时panic——这需要一套可落地的评估路径，而不是盲目执行go get。
确认当前版本与目标版本差异
进入项目根目录，执行go list -m github.com/zeromicro/go-zero，查看当前实际使用的版本号（注意不是go.mod里写的伪版本，而是实际拉取的commit hash或tag）。
访问go-zero GitHub Releases页面，筛选出目标版本（如v1.10.0），重点阅读其【Breaking Changes】和【Deprecations】章节。v1.10.0明确移除了Jaeger Exporter，若你的项目仍在使用该追踪上报逻辑，必须提前替换为OpenTelemetry SDK实现。
对比两个版本的go.mod中依赖项变化，尤其关注mongo-driver、go-redis、modelcontextprotocol/go-sdk等关键依赖的主版本跃迁。主版本升级往往伴随API不兼容，不能仅靠go mod tidy自动修复。
检查go语言运行时兼容性
运行go version确认本地及CI环境Go版本。v1.10.0要求最低Go 1.23，若当前为1.22或更低，必须先升级Go运行时。
方法一：直接升级Go
下载Go 1.23安装包→覆盖安装→执行go env GOROOT验证路径→运行go version确认输出含go1.23字样。
方法二：使用gvm管理多版本（适合团队协作） gvm install go1.23→gvm use go1.23→go version验证。注意：gvm切换后需重新go install常用工具如goctl。
【关键前提】升级Go前必须确保所有第三方依赖已发布Go 1.23兼容版本，否则go build会直接报错退出。
执行渐进式迁移验证
第一步：更新go.mod中的go-zero依赖 go get github.com/zeromicro/go-zero@v1.10.0→go mod tidy。此时若出现require ...: version "v1.10.0" invalid，说明go.sum校验失败，需手动删除go.sum并重试。
第二步：生成并比对代码结构变更
用当前goctl版本执行goctl api go -api user.api -dir .，将新生成的handler/logic代码与旧版本git diff。重点观察：
- internal/handler/v1/下是否仍存在v1.UserHandler（应保留）
- internal/handler/v2/是否新增（若项目未启用v2则不应出现）
- 所有handler函数签名是否被意外修改（如ctx参数类型变更）
第三步：运行全量单元测试 go test ./... -v -count=1。若测试大量失败，优先检查日志模块——v1.9.1起日志默认启用JSON格式，若原有测试断言依赖文本日志结构，需同步更新断言逻辑。
第四步：启动服务并触发核心链路
启动user-api服务→用curl调用/v1/users接口→观察日志是否输出"level":"info"而非INFO→检查HTTP响应状态码是否为200→验证返回JSON字段是否完整（特别注意v1.10.0对numeric类型字段的序列化修复可能导致小数位数变化）。
