Repository CHANGELOG

3.3.2

主仓库文档快照；main 的说明不自动适用于所有已发布版本。来源：原文 · 提交 832124aaacf0 · 返回目录

3.3.2

Summary

Apache Dubbo-go 3.3.2 is a production-readiness release focused on API consolidation, Triple protocol capabilities, application-level metadata, service governance, concurrency safety, and release tooling. It completes the removal of the legacy config package, moves the project baseline to Go 1.25, expands generic invocation and HTTP-facing Triple features, refreshes generated-project workflows, and fixes multiple races, stale-snapshot issues, and resource leaks.

Breaking Changes and Upgrade Notes

Go 1.25 is now required. The module and project toolchain have moved from Go 1.24 to Go 1.25. #3469
The legacy dubbo.apache.org/dubbo-go/v3/config package has been removed. Applications that imported it directly must migrate to the instance/options APIs and configuration types under global. The root compatibility bridge has also been removed. #3372 #3448 #3449
Direct users of the low-level triple_protocol.Client API must pass the RPC method explicitly. The higher-level client.Client and generated-client APIs remain unchanged. #3086
The Hystrix filter has moved to apache/dubbo-go-extensions. Existing users should import the extension implementation and keep using the registered filter name. #3253
The legacy gRPC and Dubbo3 protocol implementations and the IDL-mode switch are now deprecated in preparation for a future removal. #3469

New Features

Expand generic invocation support. Triple generic calls can now interoperate without generated stubs, with new protobuf-json and bean generalizers, typed invocation, class metadata, and exception-class handling. #3154 #3170 #3171 #3174 #3175 #3183
Enhance Triple for HTTP and cloud-native workloads. This release adds CORS, REST OpenAPI support, stateful HTTP/3 negotiation with probe and cooldown, mounting existing HTTP handlers on a Triple listener, and unary response header/trailer capture through call options. #3090 #3280 #3281 #3301 #3443 #3446
Add Kubernetes health probes. Applications can expose liveness, readiness, and startup checks. #3213
Rework graceful shutdown. The shutdown lifecycle now coordinates consumers, providers, registries, and acknowledgements through a unified implementation and configurable shutdown state. #3235 #3293 #3386 #3388
Strengthen application-level metadata. The release completes the local metadata lifecycle, makes metadata state concurrency-safe, clarifies metadata-report selection, canonicalizes revisions, adds renewal and garbage collection, and hardens remote loading with report-to-RPC fallback and conflict-aware service-to-application mapping updates. #3357 #3362 #3367 #3369 #3370 #3371 #3373 #3395
Improve routing and governance. Static router configuration injection, script-router registration, router-chain snapshot caching, and additional routing context are now supported. #3215 #3224 #3252 #3305
Improve observability. A context-aware logger interface integrates trace fields with Logrus and Zap, logger initialization now synchronizes the public Dubbo-go facade, and Triple metrics distinguish additional RPC failure conditions. #3189 #3195 #3345
Expose snapshots of CustomConfig and InstanceOptions for applications that need to inspect resolved instance configuration. #3481

Bug Fixes and Reliability

Fix races across URL cloning, shared extension registries, metadata state, protocol lifecycle, Nacos and directory state, consistent hashing, round-robin load balancing, sticky invokers, and service-discovery listeners. #3160 #3264 #3265 #3269 #3270 #3271 #3307 #3317 #3367 #3435 #3439 #3442
Respect cancellation and timeouts while dialing Triple HTTP/2 connections and validate Getty server TLS configuration before enabling SSL. #3156 #3165
Preserve Go/Java Triple interoperability with case-insensitive method routing that does not duplicate or pollute service metadata. #3277
Fix routing correctness for context attachments, provider tags, application names and URL attributes, affinity-router initialization, and invalid script-router configuration updates. #3164 #3185 #3208 #3216 #3256 #3417
Prevent panics during concurrent invoker destruction and avoid a server startup deadlock caused by holding the server lock while blocking in Serve. #3184 #3238
Reconcile initial Nacos and Polaris subscription state so stale providers are removed when current registry snapshots arrive. #3479 #3482
Fix retained URL state and clean up pending remoting responses on request errors and heartbeat timeouts to prevent memory growth. #3282 #3440
Preserve multiple Nacos providers and routable environment metadata, keep application tags in MetadataInfo, and retain Apollo context paths when building configuration-center addresses. #3309 #3331 #3400
Preserve OpenTelemetry traceparent values and fix the metadata supplier type mismatch that broke trace propagation. #3285 #3433
Make Triple stream response closure non-blocking and harden protocol initialization, metadata headers, trailer attachments, and Getty write error handling. #3307 #3418 #3428 #3434 #3466
Fix generic invocation of variadic methods and add warnings for unsupported or ambiguous variadic RPC definitions. #3284 #3294
Prevent JSON-RPC nil-pointer panics for unsupported content types and missing exporters. #3298 #3312
Make consistent hashing use the configured hash.arguments indexes and accept non-string request arguments without panicking. #3430 #3432
Add bounded exponential-backoff retries for Nacos subscriptions and failback cluster retries. #3178 #3180

Performance and Engineering

Refactor the low-level Triple client from one client per method to one client per service, reducing managed client instances from O(methods) to O(1) per service. #3086
Reduce allocations in common.URL cloning, string rendering, equality checks, map conversion, and key construction. #3399 #3403 #3404 #3412 #3488
Reduce temporary allocations in load-balancing and service-discovery hot paths, and add fast paths for Triple content-type canonicalization. #3410 #3414 #3415 #3416
Remove the Viper dependency and continue decoupling runtime components from legacy configuration internals. #3323 #3449
Add a Linux/RISC-V build check and update security-sensitive and networking dependencies. #3244 #3368 #3467 #3470

Tooling

Refresh the companion tool versions for the release: protoc-gen-go-triple and protoc-gen-triple-openapi 3.3.2, dubbogo-cli 1.0.1, and imports-formatter 1.0.11. The Triple generator now emits the modern NewXxx and RegisterXxxHandler API style by default, records generator and protoc versions in generated files, and retains legacy output behind useOldVersion=true. #3585
Rework CLI scaffolds to generate protobuf and Triple sources through make proto-gen instead of embedding generated files. New projects use Go 1.25 with the stable Dubbo-go v3.3.1 dependency, treat wrapped EOF as normal stream completion, and are compiled end to end in Linux CI. #3585 #3587

Documentation and CI

Document Triple header and trailer APIs and the migration path for reading generic-call response attachments; refresh filter documentation and repair outdated README links. #3158 #3365 #3380 #3381 #3447
Refresh the English and Chinese documentation for maintained tools, update the current configuration schema and example, and remove the obsolete variadic-RPC contract checker. #3585
Add default protection rules for the default and release branches, upgrade the Codecov action, and add the Linux/RISC-V build workflow. #3325 #3375 #3470

Contributors

Special thanks to all contributors to Apache Dubbo-go 3.3.2:

@04cb @Aetherance @Aias00 @Alanxtl @AlexStocks @AsperforMias @CAICAIIs @chaojixinren @eye-gu @fallintoplace @HarshMehta112 @HGD-coder @jieguo-coder @lesbass @mochengqian @MrSibe @nagisa-kunhah @nanjiek @NeverENG @Oxidaner @phpcyy @Qiao-yq @Saramanda9988 @Similarityoung @Snow-kal @Tsukikage7 @Vanillaxi @whimc1 @wyf027 @XnLemon @xxs588 @yangpixi @ywxzm03 @zbchi

Full Changelog: https://github.com/apache/dubbo-go/compare/v3.3.1...v3.3.2

3.3.1

Summary

This release introduces major enhancements to the Triple protocol, improvements to configuration and registry centers (Nacos, Apollo, Zookeeper), and extensive refactoring of core modules to improve stability and performance. This version also updates compatibility to Go 1.24.

New Features

Support group and version wildcards for exact interface matching. #3080
Support injecting dubbo.tag into service metadata. #3069
Expose Router-related APIs. #3066
Update Go version support to Go 1.24 and remove deprecated rand.seed usage. #3046
Introduce an imports formatter tool and integrate it into CI checks. #3019
Add configuration hot-reloading capability. #2992
Support running HTTP/2 and HTTP/3 servers simultaneously. #2972
Add WithInterface option for client initialization. #2946
Add tooling support to generate OpenAPI documentation for Triple services. #2951
Add experimental HTTP/3 support for the Triple protocol. #2916
Redesign TLS APIs and add new TLS configuration for Triple protocol. #2852 #2891
Support Non-IDL mode in the new Triple implementation. #2858
Add support for Apollo as a configuration center. #2857
Support decoding Hessian from stream to improve performance for large packet transmission. #2841
Add generic call support for the new Triple protocol. #2818

Bug Fixes

Fix Nacos deregistration failure during shutdown. #3108
Prevent panic when retrieving metadata from Java providers. #3092
Adjust log level from Error to Warn when application parameters are empty in Tag Router. #3035
Fix nil pointer dereference in multiple modules. #3071
Resolve URL parameter loss in SetParams method. #3022
Handle cluster extension creation failures instead of panicking. #3021 #3064
Fix incorrect log rotation paths to prevent file loss. #3014
Correct counter decrement logic on error. #3013
Fix metadata retrieval failures caused by meta-v errors and empty remote storage parameters. #2952 #2953
Fix provider configuration loading in dubbo.Load(). #2941
Fix attachment passing issues from server to client in Triple protocol. #2928 #2854
Fix Nacos weight configuration not taking effect. #2937
Reduce latency in Zookeeper client node perception. #2930
Fix read prefix EOF errors in the communication layer. #2912
Fix Nacos instance overwrite issues. #2882
Resolve logical infinite loop issues. #2879
Fix Nacos subscription issues where newly registered services were not detected. #2859
Fix Nacos weight option configuration logic. #2843
Fix error propagation in marshalRequest. #2817
Fix Context Attachment error handling in Triple streaming calls. #2810

Code Enhancements

Refactor: Config Decoupling. Decoupled dependencies from config package to resolve circular dependencies across registry, filter, and TLS modules.
Optimize performance by precompiling regex patterns. #3067
Improve Weighted RoundRobin by adding lastUpdate field to state storage. #3053
Fix multiple package imports in Triple code generation. #3052
Address memory leaks related to goroutine management, file handles, and extension caches. #3023
Refactor logger module and add comprehensive unit tests. #2838 #2993
Rewrite Makefile to improve build consistency and developer experience. #2975
Use errgroup to improve error handling during graceful shutdown. #2973
Replace deprecated CAS operations with CompareAndSwap. #2962
Harden Triple openServer error handling for configuration errors. #2945
Add timeout control for graceful shutdown in Triple protocol. #2943
Migrate interface{} to any throughout the codebase for Go 1.18+ compatibility. #2848

Observability

Add logging for the service registration lifecycle. #3043
Align trace scope names with OpenTelemetry specifications. #3041
Add Insecure option to tracing configuration. #3028
Upgrade OpenTelemetry dependencies to v1.21.0. #2971

Documentation & CI

Add make check-fmt command to CI pipeline. #3055
Update README contact info and fix invalid links in README_CN. #3020
Integrate imports formatter and License header checks into CI. #2961 #2957
Resolve various SonarQube/SonarCloud false positives and AI bot warnings. #2902

Contributors

Special thanks to all contributors for their efforts in this release: @1kasa @97ZQ @ALSoryu @Akashisang @Alanxtl @AlexStocks @CAICAIIs @Flying-Tom @FoghostCn @HSenCode @KamToHung @MinatoWu @MrSibe @Nexusrex18 @No-SilverBullet @Rinai-R @Similarityoung @Snow-kal @WangzJi @Whitea029 @ayamzh @baerwang @dongjiang1989 @evanzhang87 @flypiggyyoyoyo @hs80 @liushiqi1001 @manzhizhen @marsevilspirit @nanjiek @phpcyy @sebbASF @wqyenjoy @xuzhijvn @yumosx @yxrxy @zbchi @ziyyun

3.3.0 Summary

This release introduces multiple bug fixes, new features, and code enhancements to improve the stability and functionality of Apache Dubbo-Go. Key improvements include resolving various service discovery and registry-related issues, addressing memory leaks, and enhancing the error handling and stability of the underlying communication library. Additionally, new features such as script-based routing, improved Java compatibility, Triple protocol keepalive, and support for Protobuf-based MetadataService have been implemented.

Bug Fixes

Resolved initialization of the correct OTEL-GRPC exporter. #2666 #2679
Resolved test case inconsistencies. #2660
Resolved makezero bug. #2682
Resolved nacos service discovery issues. #2691 #2694
Corrected protoc-gen-go-triple path. #2690
Resolved segmentation fault due to a nil backupCodec. #2698
Resolved zookeeper mapping key issues. #2711
Resolved issues with nacos registry '*' subscription. #2713
Resolved nacos service discovery not retrieving all service names. #2715
Resolved potential deadlock scenarios. #2716
Resolved service disconnection and configuration invalidation issues. #2717
Implemented error handling for triple handler using codeUnimplemented. #2719
Resolved router rule parsing log errors. #2720
Resolved memory leak issues by setting baseinvoker's URL to nil. #2726
Resolved incorrect CallClientStream result handling. #2732
Resolved slice initialization length issue. #2734
Improved logging of file names, function names, and line numbers. #2744
Resolved automatic camel case conversion in HTTP proxy requests. #2746
Resolved issues reported by golangci-lint. #2754
Resolved incorrect metric type for dubbo_registry_directory. #2766
Resolved panic in findMappedServices. #2768
Ensured thread-safe ListenerSet usage in CacheListener. #2769
Improved subscription behavior to wait for register completion or timeout. #2775
Resolved rc.id being always nil. #2778
Resolved issue where the same address could not distinguish different registry centers. #2784
Removed unnecessary setdeadline usage. #2785
Resolved various problematic error returns. #2791
Resolved additional memory leak issues. #2792
Resolved some inaccurate comments. #2793
Fixed data race in ReadMessage(). getty#123
Fixed memory leak issue caused by slice interception. #hessian2/374
Resolved URL parsing panic and improve error handling in dubbogo-cli for ZooKeeper. 2795

New Features

Added script-based routing functionality. #2669
Introduced support for conditional routing with multiple destinations. #2685
Implemented new conditional rules. #2686
Enhanced Java interoperability. #2687
Added Protobuf-based MetadataService support. #2723
Introduced keepalive configuration for triple protocol. #2757
Enhanced nacos registry with multi-category subscription support. #2783
Added triple protocol keepalive config. #triple87
Added triple protocol connection pool. #triple91

Code Enhancements

Added unit tests for metadata. #2665
Improved code comments. #2668
Renamed method WithClientCheck to WithClientNoCheck. #2680
Optimized Nacos endpoint handling. #2692
Updated UseAsMetaReport and UseAsConfigCenter to use string values to prevent overrides. #2693
Updated condition rule sorting logic. #2688
Differentiated business errors from RPC wire errors. #2712
Standardized timeout unit to milliseconds in the Dubbo protocol. #2737
Move internal into dubbo-go-samples repo. 2794
Limited reconnect attempts and duration. getty#117

Contributors

Special thanks to all contributors for their efforts in improving Apache Dubbo-Go: @1kasa @AlbumenJ @AlexStocks @alingse @ALLen442 @baerwang @chickenlj @cuishuang @FinalT @FoghostCn @gexincoding @knowmost @linfeip @marsevilspirit @Nexusrex18 @No-SilverBullet @SHA-4096 @ShawnJeffersonWang @snowLeopard331 @solisamicus @wcy666103 @YarBor @yumosx

3.1.0

Features

Bugfixes

Enhancements

3.0.5

Bugfixes

3.0.4

Features

Bugfixes

Enhancements

3.0.3

Features

Bugfixes

Enhancements

3.0.2

Features

Bugfixes

Enhancements

3.0.1

Features

Bugfixes

Enhancements

3.0.0

Features

Bugfixes

Enhancements

3.0.0-rc3

Feature:

Triple features
- New triple pb generation tool
  
  Refer to QuickStart of dubbo-go 3.0, and Dubbo-go-samples to try protoc-gen-go-triple pb generator plugin.
- Response exception from client
  
  Triple client can get the error stacks from server, pointing to real error occurs position.
- Multi params support
New metrics support

Refer to Docs of dubbo-go 3.0 Metrics, and dubbo-go-samples/metrics] to try new metrics support.
Remove sleep to wait for service discovery logic

Set reference check default to true and remove extra time.Sleep logic in client side during service-discovery remove time.Sleep
- Registry Waittime configurable
Dynamic Route Config

Refer to Docs of dubbo-go 3.0 Router, and dubbo-go-samples/meshrouter to try dynamic mesh router support.
New config API support New root config API builder

Refer to Docs of dubbo-go 3.0 Configuration, and dubbo-go-samples/config-api to try new config API.
Support custom registry group name on Nacos
GRPC supports multi pb
New logger support

Refer to Docs of dubbo-go 3.0 logger, and dubbo-go-samples/logger to try new logger support.
Generic invocation supports

Refer to Docs of dubbo-go 3.0 generic, and dubbo-go-samples/generic to try new generic support.
Support key generate function in service event

Enhancement:

Configuration Enhancement

One of the biggest update in this release is the configuration optimization. We discarded the old configuration and introduced a new one. Currently, the new configuration has been updated to the master branch of samples (corresponding to latest dubbo-go 3.0), and there are introductions and detailed examples on the our website dubbogo.github.
Triple:
- Triple CPU usage optimization
  
  Set default tcp read buffer to 4k to decrease gc, and descrease CPU usage by 60% of 3.0.0-rc2
- Add Triple Debug Log
Support Apollo secret
Use class Name as the default reference name

You can set service/refernce key to provider/consumer's struct name: Config samples & Target provider struct,

And there is no needs to define (p*Provider) Reference() method from now on.
Set default logger level to info
Refactor of filter package sturcture
Refactor of cluster package structure