go-zero v1.10.1 同步调整了配置格式规则与开发环境适配要求。官网版本记录显示,该版本发布于2026年3月28日,新增json5配置支持、redis通用命令执行入口两项功能,同时把项目最低要求的go版本上调到1.24。这一版本属于已有正式版的补丁迭代,并非11月新推出的版本。

来源:Go-Zero 官方文档
配置模块新增了JSON5格式的转换、加载入口。官方合并记录列出注释、尾随逗号、未加引号的有效键名和单引号字符串等支持特性,后缀为.json和.json5的配置文件,都会统一使用JSON5解析器处理。此前正在使用的标准JSON配置完全向下兼容,并不要求一次性批量改写所有存量文件。这次配置格式的扩展,也不会自动改动配置里存储的数据库地址、访问凭据或业务超时参数等原有内容。
Redis 组件新增了 Do 与 DoCtx 两个方法。官方合并请求说明,这两个入口支持执行通用命令,给原有类型化接口未单独封装的命令提供调用通道,其中带上下文的形式可以直接传入调用上下文。此前已封装好的专用操作方法全部保留,不必仅因新增入口就重写全部 Redis 访问代码。

该合并请求以 RedisJSON 一类扩展模块的命令作为典型使用场景做了演示。调用这类命令的前提仍是实际部署的Redis服务端支持目标命令;框架仅提供通用调用入口,不会替服务端安装相应扩展模块,也没有把通用执行包装成所有命令在任何 Redis 环境都可用的保证。命令传入参数、返回类型和服务端实际能力仍需一一对应。
开发环境适配方面,发布日志把升级到 Go 1.24 与相关依赖调整列在改进项中。目前还在较旧工具链上构建的项目,需要把这一变化纳入升级评估范围,不能仅替换框架依赖就默认原有构建条件完全符合要求。此处标注的版本要求属于该补丁记录,不应拿来替代后续版本各自发布的兼容信息。
日志还列出 HTTP 客户端对 HEAD 请求体的处理修复,以及 core/codec 的重要安全修复。官方该页面没有展开安全问题的完整触发条件,因此不能据此给所有线上服务套用同一种受影响结论。对应改动的实际影响,应以官方合并记录和项目所用代码路径继续核对。
文档图片署名 go-zero contributors,按 CC BY 4.0 许可引用;图片为官方页面节选,已裁剪或等比缩放,图床另附站点水印。
测试补充涉及熵计算、字符串工具、哈希与各类边界场景,依赖更新覆盖性能分析、TOML、MCP SDK 和 Redis 客户端等组件。这些变化表明本次补丁的更新内容不只有新增配置格式;存量服务评估升级时,仍需同时检查工具链、配置加载逻辑和实际使用的客户端接口,不能把新增格式支持误当成必须切换配置格式的强制通知。











