Kitex v0.5.3 版本发布

项目:

重要变更介绍

功能

  1. 异常重试：添加配置，支持不对超时错误进行重试，用于请求非幂等的场景。

  2. 代码生成工具：支持 windows 环境使用。

  3. 超时错误类型拆分：支持细粒度的超时错误类型，将 ErrRPCTimeout 细分为三个错误类型：超时、业务cancel、业务timeout。

  4. Thrift FastCodec：支持 unknown fields。

    • unknown fields 使用背景：在 thrift 中，IDL 内增加字段对未更新 IDL 的一方是无感知的，必须更新 IDL 与生成代码以获取到新的字段。这会导致调用链路上某个节点更新 IDL 时，下游所有节点均需要进行更新。

    • unknown fields 则支持保留未识别的字段，对于 IDL 内不存在的字段，读取并设置于结构体的 _unknownFields 字段。

    • 使用方法：kitex -thrift keep_unknown_fields your.thrift

修复

  1. 失败重试策略：修复失败重试策略被动态修改后，结果重试 (resultRetry) 策略失效的问题。

详细变更

Feature:

  • [#887] feat(retry): 增加配置，支持异常重试场景下不对超时做重试，用于请求非幂等的场景
  • [#881] feat(tool): 支持 windows 场景下的代码生成
  • [#880] feat(rpctimeout): 支持细粒度的超时错误类型
  • [#872] feat(thrift): 在 fast codec 中支持 unknown fields 的序列化及反序列化

Optimize:

  • [#884] optimize(rpcinfo): RPCInfo.To().Tag() 优先使用服务发现的instance tag而不是remoteinfo tag

Fix:

  • [#896] fix(remoteinfo): 修复 remoteinfo 中非深拷贝的 CopyFrom 引入的 race 问题
  • [#892] fix(grpc): 注释 ReadFrame error 时输出的 error 日志
  • [#889] fix(retry): 在失败重试策略被动态修改后，结果重试策略失效
  • [#866] fix(grpc): stream 的 sendMsg/recvMsg 返回的 ctx 无需赋值给 stream 的 ctx

Chore:

  • [#898] chore: 更新 PR 的模板，对用户文档的更新做 check
  • [#854] style(nphttp2): 保证 receiver 的名字一致