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

Features

• Introduce brand new programming API.
• Upgraded triple protocol, 100% compatible with gRPC while supporting direct HTTP API access with application/json payload.
• RPC service definition supports both IDL and NON-IDL.
• Observability enhancement, metrics & tracing
• Introduce weighted round-robin and alias-method load-balance strategies

Interoperability With Java

This version guarantees fully interoperability between dubbo go and java implementations, below are some interop examples:

• Example demonstrating dubbo + hesian interop
• Example demonstrating triple + protobuf interop
• Example demonstrating triple + non-protobuf interop
• Example demonstrating service discovery interop

Compatibility

This version is completely compatible with 3.0.x ~ 3.1.x versions. Users using old API and triple protocol can upgrade to this version directly without changing any code.

New Contributors

• @Axkea made their first contribution in #2393
• @L2ncE made their first contribution in #2421
• @Jafeyyu made their first contribution in #2552
• @shikharish made their first contribution in #2573
• @klboke made their first contribution in #2579
• @setcy made their first contribution in #2596
• @NX-Official made their first contribution in #2606

Bugfixes

• Fix metrics path set in config does not work, #2553
• Fix retry time calculation, #2550
• Fix nacos App Metadata not compatible with that in dubbo-java, #2563
• Fix router warn log, #2559
• Change timeout of DubboInvoker from Milliseconds to Nanoseconds, #2546
• Set default application name to dubbo.io if it's empty, #2572
• Service discovery always try to resue protocol port to avoid listening on too many ports, #2548

Features

• Wrapper sliding window with custom aggregator
• Wrapper sliding window with custom counter for caculating QPS
• Add some metrics
• Add registry metrics
• Add metadata rt metrics
• Add medata and config center metrics
• Introduce metrics bus
• Add metrics base api interface
• Implement meta cache
• Add prometheus pushgateway support
• Add switch for metric collector
• Add rpc exception metrics

BugFixes

• Cache manager test
• Fix an issue that random ports can't be assgined
• Fix variable name typo
• Fix registry primitiveURL
• Fix health.proto has name conflict with the one in google.golang.org/grpc
• Rename 'one' to 'cacheOnce'
• Fix config random port
• Fix ConsumerConfig nil pointer problem
• Limit header size to avoid unexpected OOM
• Fix zookeeper and nacos issues working as registry, metadata and configcenter
• Fix service discovery subscription

Enhancements

• Make rt metric more performance and easy to use
• Migrate old RT metric impl to new RT impl
• Nacos support subscribe to all with '*'
• Optimize the integration of otel tracing
• Add fmt make task
• Rewrite RPC metrics into the event pattern
• Change metric config to url like other module
• Simplify configuration when enable metrics
• Remove redundant nil check in Init
• Improve cache init time and add application name
• Zk registry support customize 'rootPath'
• Refactor metrics config
• Improve tag and configurator rules to keep up with official site

Breaking Changes

For users upgrading from 3.0.x or below, please notice that the default service discovery model in 3.1.0 has changed to registry-type: instance, which stands for the application-level discovery model in Dubbo3.

To be able to discover instances of lower version, please set registry-type of 3.1.0 instance to interface in via dubbogo.yml or API:

dubbo:
  registries:
     zk: 
       protocol: zookeeper
       address: 127.0.0.1:2181
       registry-type: interface

Features

• Implement RemoveConfig API for nacos and zookeeper
• Expose TLSConfig for config api
• Add subscribe any value
• Implement condition routing basic functions and complete related tests
• Implement dynamic routing
• Tag route static config
• Upgrade nacos 2.x
• Print logs of registered providers and consumers
• Add request processing total and request succeed total metrics
• Add some metrics about RT
• Add metrics base api interface
• Sliding window and rt quantile metrics

Bugfixes

• Fix: Call Java provider occur error use group+version on triple protocol
• Fix: Register instance protocol info to polaris when use Tripe
• Fix: Custom triple server message size
• Fix: Start a new routine when subscribing
• Fix: Upgrade hessian2 to fix java wrapper object decoding bug
• Fix: Polaris service discovery cause nil panic
• Fix: The metadata invoker is destroyed too early
• Fix: Format imports in metrics module
• Fix: Solve config bool field zero value bug by using pointer
• Fix: Disable metrics filter by default instead

Enhancements

• Add serviceMappingListener for application service discovery
• The argument to ioutil.ReadFile in the config.WithPath method is changed to conf.path
• Upgrade hessian2 to support java wrapper types
• Tablewrite cli show
• Refactor: remove providers and add prefix when use polaris
• Log configuration supports other frameworks and can configure log file generation directory and file size
• Ignore node not exist error message and continue retry
• Refactor: Split metrics module into multiple files
• Ignore zk node already exist when store provider/consumer metadata
• Try update value if node already exists
• Refactor: Use promauto and promhttp
• Chore: Unnecessary use of fmt.Sprintf
• Chore: Pkg imported more than once

Bugfixes

• Fix: Consumers try to reconnect to the metadata service of offline providers infinitely
• Fix: Service discovery registry notify before return
• Fix: Do not launch Polaris governance capability if Polaris is not enabled
• Fix: Config of metrics enbale not works
• Fix: Replace assignment behavior with copy operation to avoid OOM

Bugfixes

• Fix: Consumers try to reconnect to the metadata service of offline providers infinitely
• Fix: Service discovery registry notify before return
• Fix: Do not launch Polaris governance capability if Polaris is not enabled
• Fix: Config of metrics enbale not works
• Fix: Replace assignment behavior with copy operation to avoid OOM

Features

• CLI: Support getting metadata from metadataCenter
• Support TLS for gRPC protocols
• Support TLS for Dubbo/Triple protocols
• Support Polaris subscribe
• Support Polaris ratelimit
• Support polaris router ability

Bugfixes

• Fix: leastactive choose wrong invoker
• Fix: add more setter of ReferenceConfigBuilder
• Fix: timeout don't support ms bug
• Fix: env DUBBO_IP_TO_REGISTRY doesn't work

Enhancements

• Upgrade Triple to v1.1.9
• Docs: update style and out-of-date links in readme
• Upgrade Hessian to v1.11.3
• Upgrade gopkg.in/yaml.v3 to 3.0.0
• Refactor registry polaris project

Release Notes

3.0.4

Features

• CLI: Support getting metadata from metadataCenter
• Support TLS for gRPC protocols
• Support TLS for Dubbo/Triple protocols
• Support Polaris subscribe
• Support Polaris ratelimit
• Support polaris router ability

Bugfixes

• Fix: leastactive choose wrong invoker
• Fix: add more setter of ReferenceConfigBuilder
• Fix: timeout don't support ms bug
• Fix: env DUBBO_IP_TO_REGISTRY doesn't work

Enhancements

• Upgrade Triple to v1.1.9
• Docs: update style and out-of-date links in readme
• Upgrade Hessian to v1.11.3
• Upgrade gopkg.in/yaml.v3 to 3.0.0
• Refactor registry polaris project