Kitex Release v0.15.1

Projects:

Introduction to Key Changes

Announcements

  1. Go Version Support Changes: Kitex’s minimum declared Go version has been adjusted to Go1.20 and supports up to Go1.25
    • Currently does not affect Go v1.18/v1.19 compilation, but after being declared for higher versions, subsequent versions will introduce features of higher versions

New Features

  1. Generic Call: New v2 API Supporting Multi-Services and Streaming Calls

    The Thrift binary generic call API now provides v2 version, supporting multi-services and streaming calls. For detailed usage, see Generic Call User Guide

  2. Generic Call: Support for Unknown Service Handler

    Facilitates rapid development of streaming proxy, see Proxy Application Development Guide for details

  3. Generic Call: Support for Server-Level JSON/Map Streaming Generic Calls

    See: Generic Call User Guide for details

  4. TTHeader Streaming: Support for ctx Cancel to Control Flow Lifecycle

    • Quickly terminate streaming calls, saving model resources
    • Aligns with gRPC, for detailed usage see Stream Lifecycle Control Best Practices
    • Supports Client actively invoking cancel to end streaming calls
    • Supports Client sensing the ctx cancel signal of the current Handler and cascading to end streaming calls

  5. Streaming Error Handling Optimization

    • Quickly address specific error scenarios, accelerate troubleshooting of cascade cancel link issues, see Stream Error Handling Best Practices for details
    • In cascade cancel scenarios, error description includes complete cancel link, quickly locating the first-hop service that actively cancels
    • Error description includes specific error scenarios and corresponding unique error codes
    • Unified and convenient cancel error handling method, eliminating the need for cumbersome string matching

Feature/Experience Optimization

  1. Generic Client: Optimize Background Goroutine Startup Logic

    Starting from Kitex v0.13.0, a generic client supports both Ping-Pong and streaming calls, and uses the TTHeader Streaming protocol by default. Each generic client automatically starts a background goroutine to clean up idle connections for TTHeader Streaming.

    If users previously used the generic client incorrectly (e.g., creating a generic client for each request), upgrading to Kitex v0.13.x would result in a large number of background goroutines being created, leading to goroutine leaks, even though streaming generics are not actually used.

    The v0.15.1 version only creates background goroutines when streaming generalization is actually used.

Code Generation Tool Kitex Tool

  1. Strict Enum Value Checking

    For scenarios where Thrift IDL defines enum value overflow, strict generation checks have been added, see Kitex Tool Enum Type Checking Instructions for details

    This change will cause some products to fail to generate because correctness already has issues, posing a significant risk to the service!

Special Change - Minor Services May Be Affected

Interface Breaking Change that has no impact on 99.9% of users

Kitex will ensure compatibility with normal usage patterns of internal users. However, individual users may have dependencies on definitions in the Kitex repository, and this version adjustment of Kitex will have an impact on these users.

This version has made minor adjustments to non-standard usage of remote.Message, rpcinfo.RPCInfo or generic.Generic interfaces. If there are special usages, they need to be adjusted to conform to the new version’s interface definition.

Full Change

Feature

  • feat(ttstream): support ctx cancel and detailed canceled error by @DMwangnima in #1821 | #1859 | #1856
  • feat(generic): support new thrift binary generic call api, server streaming generic call and unknown service or method handler by @jayantxie in #1837 | #1857
  • feat(grpc): support dump MaxConcurrentStreams of HTTP2 Client by @DMwangnima in #1820

Fix

  • fix(retry): shallow copy response to avoid data race by @jayantxie in #1799 | #1814
  • fix(lbcache): check the existence before new Balancer to prevent leakage by @ppzqh in #1825
  • fix(generic): descriptor.HTTPRequest.GetParam nil pointer exception by @jayantxie in #1827
  • fix(generic): fix generic write int range check by @HeyJavaBean in #1861
  • fix(rpcinfo): protect bizErr and extra field of ri.Invocation by lock by @jayantxie in #1850
  • fix(timeout): remove timer pool to avoid timer race issue by @jayantxie in #1858
  • fix(tool): disable fast api for protobuf by @DMwangnima in #1807
  • fix(tool): skip pb code gen for arg -use by @xiaost in #1819

Optimize

  • optimize(grpc): access metadata.MD without ToLower by @xiaost in #1806
  • optimize(ttstream): lazy init cleaning task for ObjectPool to reduce the impact of lots of goroutines caused by creating too many Generic Client by @DMwangnima in #1842
  • optimize(tool): remove string deepcopy because the string type is read-only in Go by @jayantxie in #1832

Refactor

  • refactor(ttstream): remove ttstream provider by @jayantxie in #1805
  • refactor(rpcinfo): move service/method info from message to rpcinfo, remove protocol info from message and update min go version to 1.20 by @jayantxie in #1818 | #1855
  • refactor(server): remove service middleware and SupportedTransportsFunc api by @jayantxie in #1839
  • refactor(server): remove useless TargetSvcInfo field by @jayantxie in #1840

Chore

  • chore: update dependencies of kitex to support go 1.25 and new features by @jayantxie @AsterDY in #1848 | #1834 | #1862 | #1836
  • chore: update version v0.15.0 by @jayantxie in #1864
  • docs: fix broken link to blogs by @scientiacoder in #1813
  • chore: support custom ctx key to pass to downstream in Service-Inline by @Duslia in #1709