大家好啊， GoFrame 框架今天发布了 v2.4.0 正式版本啦！👏👏👏👏

该版本最大的亮点在于提供了 微服务开发的功能特性、开发工具以及工程脚手架，并且提供了完善的 微服务开发文档！！微服务的组件设计仍然以接口设计为主，以保证良好的灵活性和扩展性，接口维护在框架主库中；具体的接口实现仍然以务实为主，并在社区组件中提供了常用的接口实现。

其实该版本特性功能早已 Ready，但由于文档工作量较大，陆续花了 1 个月左右才相对完善，因此版本的发布时间也相应做了调整。我们认为文档和代码同等重要，是发布里程碑不可分割的部分。我们知道怎么用好，也希望能告诉大家怎么用好，才能更务实地帮助到更多的开发者。这也是 GoFrame 框架的文档能够逐步沉淀丰富的原因之一。此外，详尽的源码注释依旧英文为主，以帮助到海外使用者。官网文档仍然以中文为主，帮助到主要的大中国区开发团队。

赶快来看看我们都更新了什么东西吧！ Enjoy! 🍺🍺🍺🍺🍺🍺🍺🍺

完整代码变更:v2.3.0…v2.4.0 ，感谢本次所有的贡献开发者：

新特性

正式发布微服务开发特性，并新增完整的微服务开发官网章节： 微服务开发

功能改进

数据库组件

1. gdb
2. 修复跨库操作时自动查询表结构失败的问题： https://github.com/gogf/gf/issues/2338
3. 修复 Namespace 配置在 pgsql 下未生效的问题。
4. 修复使用新版统一配置，无法打开 sqlite 数据库文件的问题： https://github.com/gogf/gf/issues/2435
5. 改进底层数据库操作返回逻辑，将底层错误通过 gerror.Wrap 后返回，以保证上层能获取底层自定义错误对象。
6. 修复查询数据表时，底层 unsigned 整形字段转换为了 signed 整形类型的问题： https://github.com/gogf/gf/issues/2356
7. 修复子查询时，多层 Model 作为子查询参数的解析问题： https://github.com/gogf/gf/issues/2339
8. 改进时间维护功能，写入/更新/删除时间支持完整的时间（粒度到纳秒）写入。
9. 修复在软删除场景下，给定空 Where 条件的未限制执行问题： https://github.com/gogf/gf/issues/2427
10. gredis
11. 修复对象创建时的配置处理及对象初始化问题。

容器组件

1. garray
2. 增加 Filter 方法，用于自定义遍历并过滤数组元素项。
3. 增加 RemoveValues 方法，支持按照参数值批量删除元素项。
4. 改进 InsertBefore 方法，支持批量的参数插入能力。
5. gmap
6. 增加 IsSubOf 方法，用于判断当前 map 是否是指定 map 的子集。
7. gqueue
8. 修复 Len/Size 长度计算问题： https://github.com/gogf/gf/issues/2509
9. 修复 Close 方法的并发安全问题： https://github.com/gogf/gf/issues/2015

网络组件

1. gclient
2. 增加 SetDiscovery 及 SetBuilder 方法，允许调用者自定义客户端的服务发现及负载均衡接口实现。
3. ghttp
4. 改进支持参数接收时从 Header/Cookie 中读取指定参数，支持规范路由中的 in 标签定义读取 Header/Cookie（ in:header/cookie）。
5. 改进 ResponseWriter 实现 http.Flusher 接口，简化使用者的 Stream 输出开发逻辑： 数据返回-Stream返回
6. 改进链路跟踪实现逻辑，避免内部读取提交内容发生错误时被忽略的问题。
7. 改进参数读取逻辑，避免 r.GetRequestMap() 返回内容包含 form-data 表单 body 信息的问题： https://github.com/gogf/gf/issues/2261
8. 改进内部上下文接收逻辑：
   1. 原有逻辑：去掉忽略底层 Request 的 ctx 并新建支持链路跟踪的 ctx
   2. 最新逻辑：继承底层 Request 的 ctx 对象，并扩展该 ctx 支持链路跟踪特性
9. 改进优雅关闭进程逻辑，允许自定义优雅关闭的超时时间。
10. 改进配置功能，允许开发者配置自定义的服务注册接口实现对象。

系统组件

1. gcmd
2. 改进 AddObject 方法，允许直接将指定的 *Command 或者规范编写的 Object 对象添加为子级命令。
3. gctx
4. 修复 GetInitCtx 方法缺失 TraceID 的问题： 上下文-gctx
5. gfile
6. 改进 Temp 方法，保持基础逻辑实现与标准库 os.TempDir 一致，避免单机多人协作时的临时目录冲突问题。
7. gtimer
8. 创建定时器新增 Quick 选项，用以实现是否在添加定时器时同时执行指定的回调方法。

工具组件

1. gconv
2. 修复 Scan 方法转换在部分场景下，如果属性为整型/浮点型数组时的转换失败问题： https://github.com/gogf/gf/issues/2391
3. 修复 Interfaces 方法在属性为0的场景下，转换结构体直接返回 [] 的问题： https://github.com/gogf/gf/issues/2395
4. 修复当 json tag 为 ,omitempty 不带变量名称的结构体转换问题。
5. 修复当转换目标类型为自定义基本类型的指针，而转换失败的问题。
6. 修复 gvar.Var 类型转换为常见第三方包 decimal.Decimal 类型失败的问题： https://github.com/gogf/gf/issues/2584
7. 改进 Struct 方法，解决当结构体的属性类型为 time.Time/*time.Time，给定的转换值为非标准库支持的字符串如 2022-12-15 16:11:34 而引发的转换失败问题： https://github.com/gogf/gf/issues/2371
8. gtag
9. 增加 SetGlobalEnums/GetEnumsByType 方法，用以实现自动化的 Golang Enums 管理。需要结合 gf gen enums 命令使用。
10. gutil
11. 修复 Dump 方法在个别场景下的空指针报错问题： https://github.com/gogf/gf/issues/2487
12. gvalid
13. 自定义校验方法参数新增 Field 字段，表示校验字段的名称，用以解决自定义校验错误提示的字段丢失问题： https://github.com/gogf/gf/issues/2499

社区组件

数据库驱动

1. 改进 dm/mysql 组件，解决当时区配置中带有特殊字符（例如 /）的 QueryEscape 问题。

NoSQL适配

1. 修复 redis 组件配置中缺失的连接池配置参数。

服务注册发现

1. 增加 file 注册发现组件，用于本地基于文件的服务注册发现，通常用于单节点测试。
2. 完善 etcd/polaris/zookeeper 实现细节，并完善单测用例。

微服务脚手架

1. 新增 grpcx 微服务组件，用于 grpc 通信协议的微服务开发： 微服务开发

开发工具

1. 增加 gf gen pb 命令，用于编译 proto 文件生成 go pb 文件： 协议编译-gen pb
2. 增加 gf gen pbentity 命令，用于自动生成数据库表的 proto 数据结构定义文件： 数据表PB-gen pbentity
3. 增加 gf gen enums 命令，用于解析指定目录 go 文件，并根据 enum 定义规范自动生成 enums 数据文件，主要用于 OpenAPI 接口文档展示（实验特性）： 枚举维护-gen enums
4. 改进 gf up 命令，增加自动升级工具 CLI 的功能。
5. 改进 gf gen service 命令，当方法注释后不再自动生成到接口定义文件中。
6. 改进 gf build 命令，增加 DumpENV 选项，用于控制在编译时是否打印编译使用的环境信息，默认关闭。
7. 改进 gf docker 命令，增加 Tag 选项，用以兼容旧版本。