kitex-knowledge

Run the kitex command with the -module flag for your Go module and the IDL file path, for example kitex -module myproject example.thrift. Add -service with a service name to also generate server scaffolding including main.go and handler.go.

Set RPC timeout with client.WithRPCTimeout and connection timeout with client.WithConnectTimeout at client creation. For retries, build a retry.NewFailurePolicy, set WithMaxRetryTimes, and pass it via client.WithFailureRetry; CallOptions can override per request.

Error code 103 is RPCTimeoutCode, meaning the RPC call to the server timed out or the business code canceled the context. Check the error message in call.log to distinguish a genuine timeout from an explicit context cancellation.

Apache Thrift v0.14.0 introduced incompatible APIs, causing errors like not enough arguments in call to iprot.ReadStructBegin. Pin the dependency with go get github.com/apache/[email protected] or a go.mod replace directive.

Yes, Kitex provides a built-in consistent hash balancer via loadbalance.NewConsistHashBalancer with a hash key function, useful for local cache affinity and session stickiness. Weighted random and weighted round robin are also built in, and custom balancers are supported.

Use type assertion on the req and resp interface{} parameters inside the middleware endpoint function, for example casting to your generated request type. Server middleware receives business Request/Response types, while client middleware receives Args/Result wrappers.