kratos 框架已经在 github releases 页面把 v3.0.0 标记为正式最新版，发布时间显示为6月26日。这次更新不是普通的小功能补丁，而是直接把 kratos 主模块升级到 v3 版本路径，官方发布公告里明确列出了所有破坏性变更、新增功能和问题修复项。如果你的团队已经在生产环境用 kratos v2 搭建 go 微服务，这次升级得按主版本大迁移来处理，绝对不能直接把依赖版本号改成 latest 就合并上线。
来源：Kratos GitHub Releases
官方发布说明把「更新所有 Kratos 模块到 v3 路径」直接归类在 Breaking Changes 条目下，也就是说模块导入路径、代码生成工具、下游项目的 import 引用全都属于新主版本的调整范围。这次 v3.0.0 新增了不少实用能力：支持标准库 errors 包装、给 HTTP ServerStream 加了读写超时控制、protoc-gen-go-http 现在兼容 google.api.HttpBody 响应、泛型版的 config Get 方法，还有 JWT 解析器自定义配置等等，改动分布在错误处理、HTTP 传输、配置读取、校验、命令行工具多个层面，影响范围不止框架入口几行代码。
来源：Kratos GitHub Release
对开发者来说感知最直接的变化，是 v3 把「显式声明依赖」的优先级提得很高。Kratos 本身还是定位 Go 微服务框架，但从官方文档和 README 的表述就能看出来，核心模块、CLI 工具、contrib 第三方集成、代码生成器现在都需要单独核对版本。尤其是日志、JWT、OpenTelemetry、JSON 编解码器这类常用基础组件，升级的时候一定要仔细检查，别还留着 v2 的旧 import 路径、旧配置写法，或者之前用 v2 生成的旧代码结果。
这次发版也给新启动的项目提供了更清晰的基准。新建服务可以直接照着 v3 文档安装 `github.com/go-kratos/kratos/cmd/kratos/v3`，直接用 v3 模块搭配最新的项目布局就行。老项目要升级的话，得先提前评估 Go 工具链版本、CI 镜像、代码生成任务、集成测试这几部分的兼容性。官方完全没把 v3.0.0 宣传成毫无感知的无痛小更新，发布说明里明明白白列了一堆破坏性变更，生产环境的服务升级前一定要单独开分支做完整的回归验证。
从后续维护节奏来看，v3.0.0 发布之后，Kratos 的官方维护重心已经从 v2 的补丁线转移到新主版本了。现在 Release 页面还保留着 v2.9.2、v2.9.1 这些旧版本的记录，之后 v2 线上的 bug 修复还是能追溯到来源；但新项目如果直接上 v3 的话，依赖声明、CLI 安装命令、生成器路径全都要统一用 v3 版本，绝对不能在同一个仓库里混着用 v2 和 v3 生成的代码，很容易出难以排查的问题。
信源说明：本文内容全部整理自 Kratos GitHub Releases 页、v3.0.0 官方发布公告以及 Kratos 官方仓库 README，具体升级的影响范围，取决于你项目实际用到的传输组件、中间件、contrib 集成模块和生成代码的覆盖程度。
