Repository navigation
Versions and Migration
alanxtl edited this page Sep 20, 2026
·
1 revision
首页 · 全部 Release Notes · 仓库 CHANGELOG
截至 2026-09-20，本次 GitHub 公开 Release 采集中的最新框架正式版本为 v3.3.2。develop 是开发分支。
依次核对目标 tag 的 go.mod、该 tag 的 API／生成代码、Release Note 和 CHANGELOG。官网路径中的“当前”仅代表文章编写时上下文。下面列的是实际读取的 go 指令，不表示所有第三方依赖在所有环境中都已验证。
| 框架版本 | go.mod 的 Go 指令 | 证据 |
|---|---|---|
| v3.3.2 | 1.25.0 | go.mod · Release |
| v3.3.1 | 1.24.0 | go.mod · Release |
| v3.3.0 | 1.20 | go.mod · Release |
| v3.2.0-rc1 | 1.20 | go.mod · 预发布说明 |
| v3.1.1 | 1.16 | go.mod · Release |
| v3.0.0 | 1.15 | go.mod · Release |
| v1.5.9 | 1.15 | go.mod · Release |
对应 go.mod 原文另存于 sources/versions/。这里不自行承诺旧版本维护期限。
这些检查点整理自主仓库 CHANGELOG 的 3.3.2 部分；升级实施前仍需与目标 tag 和实际依赖核对。
- Go 工具链升至 1.25。 同步本地、CI 和容器构建环境。
-
迁移旧
config包。 变更记录明确该包及根级兼容桥已删除；使用 instance/options API，并检查global下的配置类型。旧官网中导入.../config的示例不能原样套用。 -
重新检查 stub。 新 Triple 生成器默认输出
NewXxx、RegisterXxxHandler风格接口；旧输出通过useOldVersion=true保留。是否需要兼容模式取决于目标框架 API，不只取决于生成器是否能运行。 -
检查底层 Triple Client 调用。 直接使用
triple_protocol.Client的代码需要显式传 RPC 方法；高层 client 和生成客户端的情况单独核对。 -
检查扩展依赖。 Hystrix filter 已迁到
apache/dubbo-go-extensions，需要引入对应扩展；核对扩展版本和注册名。 - 区分弃用与删除。 记录中 legacy gRPC、Dubbo3 实现和 IDL 模式开关被标为弃用，不把弃用直接写成已经删除。
完整 3.3.2 GitHub 发布说明 · 完整 CHANGELOG
先在现有版本记录依赖、配置和可复现调用，再升级工具链、框架与代码生成。通过编译后验证直连，再验证注册中心发现、跨语言互通、group/version、超时重试和路由，最后验证 tracing、metrics、探针与优雅下线。生产回归应覆盖应用实际依赖的能力；旧性能报告不能替代当前版本基准。
应用级与接口级注册迁移要单独检查：发现模型不同会导致 consumer 找不到 provider，不能仅靠升级 SDK 假设自动互通。需要混合过渡时阅读注册模式 all 的说明。应用级服务发现
官网历史教程目录 保留 1.5 与 3.0 文档；旧 Wiki 保留早期设计与用法。这些资料用于维护旧项目和理解演进，不作为今天的新项目默认配置。仓库年代、文章日期、框架版本和工具版本分别核对。