Follow Us
- -Subscribe to one or more of the following channels to receive project updates, keep connection with community developers.
- -
-
-
-
-
-
-
-Subscribe to one or more of the following channels to receive project updates, keep connection with community developers.
- -\ No newline at end of file +
diff --git a/content/en/docs3-v2/java-sdk/faq/0/2.md b/content/en/docs3-v2/java-sdk/faq/0/2.md index db74f760a3cf..90b7d0fc07df 100644 --- a/content/en/docs3-v2/java-sdk/faq/0/2.md +++ b/content/en/docs3-v2/java-sdk/faq/0/2.md @@ -9,6 +9,6 @@ weight: 2 This hint means that the value configured by the user does not match the data type required by the attribute itself. For example, the `dubbo.comsumer.threads` attribute can only accept numeric attributes, but the value entered by the user is mixed with letters. ### Troubleshooting and resolution steps -According to the [Configuration Item Reference Manual](../../../reference-manual/config/properties), find the wrong configuration item, check the type specified by the item, and check whether there is a type inconsistency. +According to the [Configuration Item Reference Manual](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/), find the wrong configuration item, check the type specified by the item, and check whether there is a type inconsistency. -
\ No newline at end of file +
diff --git a/content/en/docs3-v2/java-sdk/faq/1/12.md b/content/en/docs3-v2/java-sdk/faq/1/12.md index c2b858900999..793be1778810 100644 --- a/content/en/docs3-v2/java-sdk/faq/1/12.md +++ b/content/en/docs3-v2/java-sdk/faq/1/12.md @@ -12,4 +12,4 @@ During the process of destroying the `unexport` of `Registryprotocol`, the `getR ### Troubleshooting and resolution steps > see also -[Configuration item reference manual](../../../reference-manual/config/properties) \ No newline at end of file +[Configuration item reference manual](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) diff --git a/content/en/docs3-v2/java-sdk/faq/1/14.md b/content/en/docs3-v2/java-sdk/faq/1/14.md index 5188e6e4d444..7bbb3b7af609 100644 --- a/content/en/docs3-v2/java-sdk/faq/1/14.md +++ b/content/en/docs3-v2/java-sdk/faq/1/14.md @@ -12,4 +12,4 @@ Please check whether the content or format of the dynamic configuration file is ### See also -> [Configuration Reference Manual](../../../reference-manual/config/properties) \ No newline at end of file +> [Configuration Reference Manual](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) diff --git a/content/en/docs3-v2/java-sdk/faq/1/17.md b/content/en/docs3-v2/java-sdk/faq/1/17.md index e89c456f07df..e625f0cfc874 100644 --- a/content/en/docs3-v2/java-sdk/faq/1/17.md +++ b/content/en/docs3-v2/java-sdk/faq/1/17.md @@ -13,6 +13,6 @@ It may be that there is a problem with the parameter configuration of metadata, 2. Check whether the `metadataServicePort` port number conflicts. If the ports configured by Provider and Consumer are in conflict at the same time, a 1-17 error will be generated. ## see also -[Configuration item reference manual](../../../reference-manual/config/properties) +[Configuration item reference manual](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) -
\ No newline at end of file +
diff --git a/content/en/docs3-v2/java-sdk/faq/1/18.md b/content/en/docs3-v2/java-sdk/faq/1/18.md index ad70f24f74c6..b81501e92489 100644 --- a/content/en/docs3-v2/java-sdk/faq/1/18.md +++ b/content/en/docs3-v2/java-sdk/faq/1/18.md @@ -13,6 +13,6 @@ It may be that `metadataType` is in local mode, and `metadataServicePort` is con 2. Check whether the configuration of `metadataServicePort` on the Provider side is correct, and pay special attention to whether there is any conflict with other application ports. ## see also -[Configuration item reference manual](../../../reference-manual/config/properties) +[Configuration item reference manual](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) -
\ No newline at end of file +
diff --git a/content/en/docs3-v2/java-sdk/faq/1/3.md b/content/en/docs3-v2/java-sdk/faq/1/3.md index 9f5491e21777..bd71505ee1ff 100644 --- a/content/en/docs3-v2/java-sdk/faq/1/3.md +++ b/content/en/docs3-v2/java-sdk/faq/1/3.md @@ -10,4 +10,4 @@ When `FrameworkExecutorRepository` is destroyed, calling `CacheableFailbackRegis ### Troubleshooting and resolution steps -> See also the [Configuration Items Reference Manual](../../../reference-manual/config/properties) \ No newline at end of file +> See also the [Configuration Items Reference Manual](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) diff --git a/content/en/docs3-v2/java-sdk/faq/1/4.md b/content/en/docs3-v2/java-sdk/faq/1/4.md index e2f200cc84ab..2288b3210e38 100644 --- a/content/en/docs3-v2/java-sdk/faq/1/4.md +++ b/content/en/docs3-v2/java-sdk/faq/1/4.md @@ -15,4 +15,4 @@ weight: 4 3. Check whether `enable-empty-protection` of the registration center is true (the default is true). > see also -[Configuration item reference manual](../../../reference-manual/config/properties) \ No newline at end of file +[Configuration item reference manual](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) diff --git a/content/en/docs3-v2/java-sdk/faq/1/8.md b/content/en/docs3-v2/java-sdk/faq/1/8.md index 20f1150bc3ac..98b866944ff3 100644 --- a/content/en/docs3-v2/java-sdk/faq/1/8.md +++ b/content/en/docs3-v2/java-sdk/faq/1/8.md @@ -15,4 +15,4 @@ weight: 8 3. Check whether the provider’s registry-related parameters such as `registry` `config-center` `metadata-report` are configured correctly. > see also -[Configuration item reference manual](../../../reference-manual/config/properties) \ No newline at end of file +[Configuration item reference manual](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) diff --git a/content/en/docs3-v2/java-sdk/reference-manual/protocol/http.md b/content/en/docs3-v2/java-sdk/reference-manual/protocol/http.md index 53433653774f..bb943f4e0e39 100644 --- a/content/en/docs3-v2/java-sdk/reference-manual/protocol/http.md +++ b/content/en/docs3-v2/java-sdk/reference-manual/protocol/http.md @@ -6,6 +6,11 @@ weight: 6 --- +{{% alert title="Note" color="warning" %}} +Since Dubbo 3.3, the rest protocol has been moved to the extensions library, with the triple protocol now providing more comprehensive support for Rest. For details refer to [Triple Rest User Manual](../../tripe-rest-manual/). +If you wish to continue using the original rest protocol, please include the corresponding [dubbo-spi-extensions](https://github.com/apache/dubbo-spi-extensions/tree/master/dubbo-rpc-extensions/dubbo-rpc-rest) dependency. +{{% /alert %}} + ## Feature description HTTP form-based remote invocation protocol, implemented by Spring's HttpInvoker, supported by versions above `2.3.0`. diff --git a/content/en/docs3-v2/java-sdk/reference-manual/protocol/rest.md b/content/en/docs3-v2/java-sdk/reference-manual/protocol/rest.md index e20537a33ba7..d9acddd826a2 100644 --- a/content/en/docs3-v2/java-sdk/reference-manual/protocol/rest.md +++ b/content/en/docs3-v2/java-sdk/reference-manual/protocol/rest.md @@ -5,6 +5,11 @@ linkTitle: "Rest protocol" weight: 4 --- +{{% alert title="Note" color="warning" %}} +Since Dubbo 3.3, the rest protocol has been moved to the extensions library, with the triple protocol now providing more comprehensive support for Rest. For details refer to [Triple Rest User Manual](../../tripe-rest-manual/). +If you wish to continue using the original rest protocol, please include the corresponding [dubbo-spi-extensions](https://github.com/apache/dubbo-spi-extensions/tree/master/dubbo-rpc-extensions/dubbo-rpc-rest) dependency. +{{% /alert %}} + Support for REST calls based on the standard Java REST API - JAX-RS 2.0 (short for Java API for RESTful Web Services) ### Quick Start diff --git a/content/en/docs3-v2/java-sdk/reference-manual/protocol/tripe-3.3.md b/content/en/docs3-v2/java-sdk/reference-manual/protocol/tripe-3.3.md new file mode 100644 index 000000000000..d87aa6e3de69 --- /dev/null +++ b/content/en/docs3-v2/java-sdk/reference-manual/protocol/tripe-3.3.md @@ -0,0 +1,282 @@ +--- +type: docs +title: "Tripe 3.3 New Features" +linkTitle: "Tripe 3.3 New Features" +weight: 13 +--- + + + +## New Rest Support + +### Rest Features + +Since Dubbo 3.3, the Triple protocol reuses the existing HTTP stack to fully support RESTful service exports. Without the need for generic or gateway protocol conversion, users can +directly access backend Triple protocol services via HTTP in a decentralized manner. Additionally, it offers extensive annotation and SPI extension support for advanced REST usage, +such as path customization, output format customization, and exception handling. Key features include: + +- **Triple Protocol Integration** + Reuses the existing Triple HTTP stack, allowing support for HTTP/1, HTTP/2, and HTTP/3 without additional configuration or new ports. +- **Decentralization** + Exposes Rest APIs directly, eliminating dependency on gateway applications for traffic forwarding, thus improving performance and reducing stability risks caused by gateways. + Security concerns can be addressed through internal application extensions, a practice verified in Taobao’s MTOP. +- **Support for Existing Servlet Infrastructure** + Supports Servlet API and Filter, allowing users to reuse existing security components based on the Servlet API. Integrating OAuth and Spring Security is as simple as implementing + a Servlet Filter. +- **Multiple Dialects** + Considering that most users are accustomed to using SpringMVC or JAX-RS for REST API development, Triple Rest allows continued use of these methods for service definitions and + supports most extensions and exception handling mechanisms (with over 80% of the original framework’s functionality). For lightweight users, the Basic dialect is available, and + Triple’s out-of-the-box REST capabilities are based on this dialect. +- **High Extensibility** + Offers more than 20 extension points, enabling users to easily create custom dialects and flexibly customize parameter retrieval, type conversion, error handling, and other + logic. +- **Out-of-the-Box** + REST capabilities are available out of the box; simply enable the Triple protocol to have direct REST access to services. +- **High-Performance Routing** + The routing component uses an + optimized [Radix Tree](https://github.com/apache/dubbo/blob/3.3/dubbo-rpc/dubbo-rpc-triple/src/main/java/org/apache/dubbo/rpc/protocol/tri/rest/mapping/RadixTree.java) and Zero + Copy technology to improve routing performance. +- **Seamless OpenAPI Integration (TBD)** + Upcoming OpenAPI integration will allow for out-of-the-box OpenAPI Schema export. With the Swagger dependency, a Web UI can be used for service testing. Using the OpenAPI Schema, + API tools like [Postman](https://www.postman.com/) and [Apifox](https://apifox.com/) can manage and test APIs, and the OpenAPI ecosystem can facilitate cross-language calls. + Future enhancements will support a Schema First approach, allowing frontend teams to define OpenAPI collaboratively, generate call code and mocks based on OpenAPI, and enable + backend development using stubs generated from OpenAPI, greatly improving collaboration efficiency. + + + +### Example + + + +###### Sample Code + +```java +package org.apache.dubbo.rest.demo; + +import org.apache.dubbo.remoting.http12.rest.Mapping; +import org.apache.dubbo.remoting.http12.rest.Param; + +// Service Interface +public interface DemoService { + String hello(String name); + + @Mapping(path = "/hi", method = HttpMethods.POST) + String hello(User user, @Param(value = "c", type = ParamType.Header) int count); +} + +// Service Implementation +@DubboService +public class DemoServiceImpl implements DemoService { + @Override + public String hello(String name) { + return "Hello " + name; + } + + @Override + public String hello(User user, int count) { + return "Hello " + user.getTitle() + ". " + user.getName() + ", " + count; + } +} + +// Model +@Data +public class User { + private String title; + private String name; +} +``` + + + +###### Download and Run Example + +```bash +# Get the example code +git clone --depth=1 https://github.com/apache/dubbo-samples.git +cd dubbo-samples/2-advanced/dubbo-samples-triple-rest/dubbo-samples-triple-rest-basic +# Run +mvn spring-boot:run +``` + + + +###### Curl Test + +```bash +curl -v "http://127.0.0.1:8081/org.apache.dubbo.rest.demo.DemoService/hello?name=world" +# Output +#> GET /org.apache.dubbo.rest.demo.DemoService/hello?name=world HTTP/1.1 +#> +#< HTTP/1.1 200 OK +#< content-type: application/json +#< content-length: 13 +#< +#"Hello world" +# +# Explanation +# The output shows "Hello world", with quotes because the default content-type is application/json. +# This example shows that Triple exports services to the /{serviceInterface}/{methodName} path by default, supporting parameter passing via URL. + +curl -v -H "c: 3" -d 'name=Yang' "http://127.0.0.1:8081/org.apache.dubbo.rest.demo.DemoService/hi.txt?title=Mr" +# Output +#> POST /org.apache.dubbo.rest.demo.DemoService/hi.txt?title=Mr HTTP/1.1 +#> c: 3 +#> Content-Length: 9 +#> Content-Type: application/x-www-form-urlencoded +#> +#< HTTP/1.1 200 OK +#< content-type: text/plain +#< content-length: 17 +#< +#Hello Mr. Yang, 3 +# +# Explanation +# The output shows "Hello Mr. Yang, 3", without quotes because the output was specified as text/plain by using the txt suffix. +# This example shows how to customize paths using the Mapping annotation and customize parameter sources using the Param annotation, supporting parameter passing via post body or URL. +``` + + + +### Documentation + +Please visit the user manual: [Triple Rest Manual](../triple-rest-manual/) + + +## Support for Servlet Integration + +In version 3.3, you can reuse existing Spring Boot servlet listening ports to handle HTTP traffic, eliminating the need for Netty to listen on new ports. This simplifies deployment +and reduces maintenance costs. By reducing reliance on external ports, it helps to easily pass through enterprise firewalls and gateways, simplifying network deployment and +enhancing the maintainability and security of enterprise applications. + + +### Example + + + +###### Download and Run Example + +```bash +# Get the sample code +git clone --depth=1 https://github.com/apache/dubbo-samples.git +cd dubbo-samples/2-advanced/dubbo-samples-triple-servlet +# Run directly +mvn spring-boot:run +``` + + + +###### Curl Test + +```shell +curl --http2-prior-knowledge -v 'http://localhost:50052/org.apache.dubbo.demo.GreeterService/sayHelloAsync?request=world' +# Output +#* [HTTP/2] [1] OPENED stream for http://localhost:50052/org.apache.dubbo.demo.GreeterService/sayHelloAsync?request=world +#* [HTTP/2] [1] [:method: GET] +#* [HTTP/2] [1] [:scheme: http] +#* [HTTP/2] [1] [:authority: localhost:50052] +#* [HTTP/2] [1] [:path: /org.apache.dubbo.demo.GreeterService/sayHelloAsync?request=world] +#> +#* Request completely sent off +#< HTTP/2 200 +#< content-type: application/json +#< date: Sun, 25 Aug 2024 03:38:12 GMT +#< +#"Hello world" +``` + + + +### Documentation + +Please +visit: [how-to-enable-servlet-support-for-triple](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-triple-servlet#how-to-enable-servlet-support-for-triple) +to learn how to configure and enable servlet support. + + +## Support for HTTP/3 Protocol + + + +### HTTP/3 Features + +In version 3.3, Triple implements support for the HTTP/3 protocol, allowing RPC and REST requests to be transmitted via HTTP/3. Using HTTP/3 offers the following benefits: + +- **Enhanced Performance** + With HTTP/3 support, the use of the QUIC protocol reduces latency and accelerates request-response times. This significantly boosts overall service + performance, especially in high-latency or complex network environments. +- **Improved Reliability** + HTTP/3 leverages multiplexing and connection migration to avoid head-of-line blocking, maintaining stable connections even under poor network conditions + and ensuring reliable service delivery. +- **Increased Security** + HTTP/3 enforces TLS 1.3 encryption, providing a more secure communication channel compared to the optional encryption in traditional HTTP/2. +- **Better Adaptation to Weak Networks** + In scenarios with high packet loss or unstable bandwidth, HTTP/3 maintains high connection quality and service performance, improving + outcomes in weak network environments. + +Since HTTP/3 is based on the QUIC protocol (UDP), it might be blocked by firewalls or gateways. To mitigate this, Triple has implemented HTTP/3 negotiation capabilities and enabled +it by default. Connections are initially established via HTTP/2, and if the server responds with an [Alt-Svc](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Alt-Svc) +header indicating HTTP/3 support, the client will automatically switch to HTTP/3. + + +### Example + + + +###### Download and Run Example + +```bash +# Get the sample code +git clone --depth=1 https://github.com/apache/dubbo-samples.git +cd dubbo-samples/2-advanced/dubbo-samples-triple-http3 +# Run directly +mvn spring-boot:run +``` + + + +###### Testing with Curl + +Note that Curl must be upgraded to a version that supports HTTP/3. Refer to: [https://curl.se/docs/http3.html](https://curl.se/docs/http3.html). + +```shell + +curl --http3 -vk 'https://localhost:50052/org.apache.dubbo.demo.GreeterService/sayHelloAsync?request=world' +# Output +#* QUIC cipher selection: TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_CCM_SHA256 +#* Skipped certificate verification +#* using HTTP/3 +#* [HTTP/3] [0] OPENED stream for https://localhost:50052/org.apache.dubbo.demo.GreeterService/sayHelloAsync?request=world +#* [HTTP/3] [0] [:method: GET] +#* [HTTP/3] [0] [:scheme: https] +#* [HTTP/3] [0] [:authority: localhost:50052] +#* [HTTP/3] [0] [:path: /org.apache.dubbo.demo.GreeterService/sayHelloAsync?request=world] +#> +#* Request completely sent off +#< HTTP/3 200 +#< content-type: application/json +#< +#"Hello world" +``` + + + +### Performance Comparison + +#### Impact of Packet Loss on QPS + + + +#### Impact of Packet Loss on RT + + + + + +### Architecture Diagram + + + +### Documentation + +For information on how to configure and enable HTTP/3 support, please +visit: [how-to-enable-http3-support-for-triple](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-triple-http3#how-to-enable-http3-support-for-triple). diff --git a/content/en/docs3-v2/java-sdk/reference-manual/protocol/tripe-rest-manual.md b/content/en/docs3-v2/java-sdk/reference-manual/protocol/tripe-rest-manual.md new file mode 100644 index 000000000000..d7fd5125944b --- /dev/null +++ b/content/en/docs3-v2/java-sdk/reference-manual/protocol/tripe-rest-manual.md @@ -0,0 +1,984 @@ +--- +linkTitle: Triple Rest User Manual +title: Triple Rest User Manual +type: docs +weight: 14 +--- + +{{% alert title="Note" color="warning" %}} +Since Dubbo 3.3, the original Rest protocol has been moved to the Extensions library, and the Triple protocol now provides more comprehensive support for Rest. To continue using +the original Rest protocol, you can add the corresponding [dubbo-spi-extensions](https://github.com/apache/dubbo-spi-extensions/tree/master/dubbo-rpc-extensions/dubbo-rpc-rest) +library dependency. +{{% /alert %}} + +## Introduction + +Since Dubbo 3.3, the Triple protocol reuses the existing HTTP stack to fully support RESTful service exports. Without the need for generic or gateway protocol conversion, users can +directly access backend Triple protocol services via HTTP in a decentralized manner. Additionally, it offers extensive annotation and SPI extension support for advanced REST usage, +such as path customization, output format customization, and exception handling. Key features include: + +- **Triple Protocol Integration** + Reuses the existing Triple HTTP stack, allowing support for HTTP/1, HTTP/2, and HTTP/3 without additional configuration or new ports. +- **Decentralization** + Exposes Rest APIs directly, eliminating dependency on gateway applications for traffic forwarding, thus improving performance and reducing stability risks caused by gateways. + Security concerns can be addressed through internal application extensions, a practice verified in Taobao’s MTOP. +- **Support for Existing Servlet Infrastructure** + Supports Servlet API and Filter, allowing users to reuse existing security components based on the Servlet API. Integrating OAuth and Spring Security is as simple as implementing + a Servlet Filter. +- **Multiple Dialects** + Considering that most users are accustomed to using SpringMVC or JAX-RS for REST API development, Triple Rest allows continued use of these methods for service definitions and + supports most extensions and exception handling mechanisms (with over 80% of the original framework’s functionality). For lightweight users, the Basic dialect is available, and + Triple’s out-of-the-box REST capabilities are based on this dialect. +- **High Extensibility** + Offers more than 20 extension points, enabling users to easily create custom dialects and flexibly customize parameter retrieval, type conversion, error handling, and other + logic. +- **Out-of-the-Box** + REST capabilities are available out of the box; simply enable the Triple protocol to have direct REST access to services. +- **High-Performance Routing** + The routing component uses an + optimized [Radix Tree](https://github.com/apache/dubbo/blob/3.3/dubbo-rpc/dubbo-rpc-triple/src/main/java/org/apache/dubbo/rpc/protocol/tri/rest/mapping/RadixTree.java) and Zero + Copy technology to improve routing performance. +- **Seamless OpenAPI Integration (TBD)** + Upcoming OpenAPI integration will allow for out-of-the-box OpenAPI Schema export. With the Swagger dependency, a Web UI can be used for service testing. Using the OpenAPI Schema, + API tools like [Postman](https://www.postman.com/) and [Apifox](https://apifox.com/) can manage and test APIs, and the OpenAPI ecosystem can facilitate cross-language calls. + Future enhancements will support a Schema First approach, allowing frontend teams to define OpenAPI collaboratively, generate call code and mocks based on OpenAPI, and enable + backend development using stubs generated from OpenAPI, greatly improving collaboration efficiency. + + +## Quick Start + +Let's explore Triple Rest with a simple example. You can directly download the existing sample project to get started quickly. Assume you have Java, Maven, and Git installed. + +### Download and Run the Example + +```bash +# Get the sample code +git clone --depth=1 https://github.com/apache/dubbo-samples.git +cd dubbo-samples/2-advanced/dubbo-samples-triple-rest/dubbo-samples-triple-rest-basic +# Run directly +mvn spring-boot:run +# Or package and run +mvn clean package -DskipTests +java -jar target/dubbo-samples-triple-rest-basic-1.0.0-SNAPSHOT.jar +``` + +Alternatively, you can import the project into your IDE and directly execute `org.apache.dubbo.rest.demo.BasicRestApplication#main` to run it. You can also debug by setting +breakpoints to deeply understand the principles. + +### Example Code + +```java +// Service Interface +package org.apache.dubbo.rest.demo; + +import org.apache.dubbo.remoting.http12.rest.Mapping; +import org.apache.dubbo.remoting.http12.rest.Param; + +public interface DemoService { + String hello(String name); + + @Mapping(path = "/hi", method = HttpMethods.POST) + String hello(User user, @Param(value = "c", type = ParamType.Header) int count); +} + +// Service Implementation +@DubboService +public class DemoServiceImpl implements DemoService { + @Override + public String hello(String name) { + return "Hello " + name; + } + + @Override + public String hello(User user, int count) { + return "Hello " + user.getTitle() + ". " + user.getName() + ", " + count; + } +} + +// Model +@Data +public class User { + private String title; + private String name; +} +``` + + + +### Test the Basic Service + +```bash +curl -v "http://127.0.0.1:8081/org.apache.dubbo.rest.demo.DemoService/hello?name=world" +# Output: +#> GET /org.apache.dubbo.rest.demo.DemoService/hello?name=world HTTP/1.1 +#> Host: 127.0.0.1:8081 +#> User-Agent: curl/8.7.1 +#> Accept: */* +#> +#* Request completely sent off +#< HTTP/1.1 200 OK +#< content-type: application/json +#< alt-svc: h2=":8081" +#< content-length: 13 +#< +#"Hello world" +``` + +Explanation:
请通过以下任一或多个渠道关注社区动态，与社区开发者保持密切沟通.
- - -
+
+在该示例中定义并发布了一个 `org.apache.dubbo.samples.gateway.apisix.DemoService` 的 triple 服务，接口定义为：
+
+```java
+public interface DemoService {
+ String sayHello(String name);
+}
+```
+
+接口实现如下：
+
+```java
+@DubboService
+public class DemoServiceImpl implements DemoService {
+ @Override
+ public String sayHello(String name) {
+ return "Hello " + name;
+ }
+}
+```
+
+Dubbo服务相关配置：
+
+```yaml
+dubbo:
+ application:
+ name: gateway-apisix-triple
+ registry:
+ address: nacos://${nacos.address:127.0.0.1}:8848
+ username: nacos
+ password: nacos
+ protocol:
+ name: tri
+ port: 50052
+```
+
+## 部署应用
+
+1. 在 [本地下载并启动 Nacos](/zh-cn/overview/reference/integrations/nacos/#本地下载)
+
+2. 运行以下命令，启动 Dubbo 应用。
+
+下载源码：
+
+```shell
+$ git clone -b main --depth 1 https://github.com/apache/dubbo-samples
+$ cd dubbo-samples/2-advanced/dubbo-samples-gateway/dubbo-samples-gateway-apisix/dubbo-samples-gateway-apisix-triple
+```
+
+在 `dubbo-samples-gateway-apisix-triple` 目录，运行以下命令启动应用：
+
+```shell
+$ mvn compile exec:java -Dexec.mainClass="org.apache.dubbo.samples.gateway.apisix.ProviderApplication"
+```
+
+运行以下命令，测试服务已经正常启动：
+
+```shell
+curl \
+ --header "Content-Type: application/json" \
+ --data '["dubbo"]' \
+ http://localhost:50052/org.apache.dubbo.samples.gateway.apisix.DemoService/sayHello/
+```
+
+## 接入 APISIX 网关
+
+本文档使用 Docker 安装 APISIX。确保本地先安装 [Docker](https://www.docker.com/) 和 [Docker Compose](https://docs.docker.com/compose/)。
+
+首先，下载 [apisix-docker](https://github.com/apache/apisix-docker) 仓库。
+
+```shell
+$ git clone https://github.com/apache/apisix-docker.git
+$ cd apisix-docker/example
+```
+
+由于本示例要接入到 Nacos 注册中心，因此需要修改 `apisix-docker/example` 目录下安装用的 `docker-compose.yaml`，添加如下 docker compose 配置内容：
+
+```yaml
+ nacos:
+ image: nacos/nacos-server:v2.1.1
+ container_name: nacos-standalone
+ environment:
+ - PREFER_HOST_MODE=hostname
+ - MODE=standalone
+ ports:
+ - "8848:8848"
+ - "9848:9848"
+ networks:
+ apisix:
+```
+
+启动 APISIX 前，在 `conf/config.yaml` 文件中增加如下配置，[让 APISIX 连接到 Nacos 注册中心](https://apisix.apache.org/docs/apisix/discovery/nacos/#service-discovery-via-nacos)：
+
+```yaml
+discovery:
+ nacos:
+ host:
+ - "http://192.168.33.1:8848"
+```
+
+最后使用 `docker-compose` 启用 APISIX：`docker-compose -p docker-apisix up -d`。
+
+### 配置服务源与路由
+
+在 APISIX 中配置 Nacos upstream 及路由，即可实现后端实例地址自动发现（假设 APISIX 端口是 9080）：
+
+```shell
+curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -i -d '
+{
+ "uri": "/org.apache.dubbo.samples.gateway.apisix.DemoService/sayHello/",
+ "upstream": {
+ "service_name": "gateway-apisix-triple",
+ "type": "roundrobin",
+ "discovery_type": "nacos"
+ }
+}'
+```
+
+> 在上述命令中，请求头 X-API-KEY 是 Admin API 的访问 token，可以在 conf/config.yaml 文件中的 apisix.admin_key.key 查看。
+
+### 验证服务调用
+
+使用以下命令发送请求至需要配置的路由：
+
+```shell
+curl -i http://127.0.0.1:9080/org.apache.dubbo.samples.gateway.apisix.DemoService/sayHello/
+```
+
+### REST 模式
+
+如果您觉得 `/org.apache.dubbo.samples.gateway.apisix.DemoService/sayHello/` 这样的 http 端口对于网关访问不够友好，可参考 [为 triple 协议发布 rest 风格 http 接口](/zh-cn/overview/mannual/java-sdk/tasks/gateway/triple/#rest-风格接口)。
+
+
+
+
diff --git a/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-apache-apisix.md b/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-apache-apisix.md
index d624aba7ec1a..b715b624b50f 100644
--- a/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-apache-apisix.md
+++ b/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-apache-apisix.md
@@ -1,7 +1,7 @@
---
-title: "从原理到操作，让你在 Apache APISIX 中代理 Dubbo 服务更便捷"
+title: "使用 Apache APISIX 代理 Dubbo 服务 (dubbo 协议)"
linkTitle: "从原理到操作，让你在 Apache APISIX 中代理 Dubbo 服务更便捷"
-date: 2022-01-18
+date: 2024-04-25
tags: ["网关", "生态", "Java"]
description: >
本文为大家介绍了如何借助 Apache APISIX 实现 Dubbo Service 的代理，通过引入 dubbo-proxy 插件便可为 Dubbo 框架的后端系统构建更简单更高效的流量链路
@@ -10,32 +10,79 @@ aliases:
- /zh/overview/what/gateway/higress/
---
-## 背景
+{{% alert title="注意" color="warning" %}}
+本文仅适用于 dubbo 协议通信场景。如果您是 Dubbo3 用户，建议您使用 triple 协议，可参见 [使用 Apache APISIX 代理 Dubbo 服务（triple协议）](/zh-cn/blog/2024/04/22/使用-apache-apisix-代理-dubbo-服务triple协议/) 学习具体示例。
+{{% /alert %}}
-[Apache Dubbo](/zh-cn/) 是由阿里巴巴开源并捐赠给 Apache 的微服务开发框架，它提供了 RPC 通信与微服务治理两大关键能力。不仅经过了阿里电商场景中海量流量的验证，也在国内的技术公司中被广泛落地。
-
-在实际应用场景中，Apache Dubbo 一般会作为后端系统间 RPC 调用的实现框架，当需要提供 HTTP 接口给到前端时，会通过一个「胶水层」将 Dubbo Service 包装成 HTTP 接口，再交付到前端系统。
[Apache APISIX](https://apisix.apache.org/) 是 Apache 软件基金会的顶级开源项目，也是当前最活跃的开源网关项目。作为一个动态、实时、高性能的开源 API 网关，Apache APISIX 提供了负载均衡、动态上游、灰度发布、服务熔断、身份认证、可观测性等丰富的流量管理功能。
-得益于 Apache Dubbo 的应用场景优势，Apache APISIX 基于开源项目 tengine/mod_dubbo 模块为 Apache Dubbo 服务配备了HTTP 网关能力。通过 dubbo-proxy 插件，可以轻松地将 Dubbo Service 发布为 HTTP 服务。
+Apache APISIX 基于开源项目 tengine/mod_dubbo 模块为 Apache Dubbo 服务配备了HTTP 网关能力。通过 dubbo-proxy 插件，可以轻松地将 Dubbo Service 发布为 HTTP 服务。
-## 如何使用
-### 入门篇：安装使用
+## 入门篇
+
+### 安装 APISIX
+
+本文档使用 Docker 安装 APISIX。确保本地先安装 [Docker](https://www.docker.com/) 和 [Docker Compose](https://docs.docker.com/compose/)。
+
+首先，下载 [apisix-docker](https://github.com/apache/apisix-docker) 仓库。
+
+```shell
+$ git clone https://github.com/apache/apisix-docker.git
+$ cd apisix-docker/example
+```
+
+由于本示例要接入到 Nacos 注册中心，因此 `apisix-docker/example` 目录下安装用的 `docker-compose.yaml`，添加如下内容：
+
+```yaml
+ nacos:
+ image: nacos/nacos-server:v2.1.1
+ container_name: nacos-standalone
+ environment:
+ - PREFER_HOST_MODE=hostname
+ - MODE=standalone
+ ports:
+ - "8848:8848"
+ - "9848:9848"
+ networks:
+ apisix:
+```
+
+在 config.yaml 文件中增加 nacos 注册中心配置：
+
+```yaml
+discovery:
+ nacos:
+ host:
+ - "http://192.168.33.1:8848"
+```
+
+在 config.yaml 文件中进行 dubbo-proxy 插件启用：
+
+```yaml
+# Add this in config.yaml
+plugins:
+ - ... # plugin you need
+ - dubbo-proxy
+```
->这里我们建议使用 Apache APISIX 2.11 版本镜像进行安装。该版本的 APISIX-Base 中已默认编译了 Dubbo 模块，可直接使用 `dubbo-proxy` 插件。
+> 如果你使用了 Apache APISIX 2.11 版本镜像，则可以省去 `dubbo-proxy` 配置环节，该版本的 APISIX-Base 中已默认编译了 Dubbo 模块，可直接使用。
-在接下来的操作中，我们将使用 [`dubbo-samples`](https://github.com/apache/dubbo-samples) 项目进行部分展示。该项目是一些使用 Apache Dubbo 实现的 Demo 应用，本文中我们采用其中的一个子模块作为 Dubbo Provider。
+最后，使用 `docker-compose` 启用 APISIX：`docker-compose -p docker-apisix up -d`
+
+### 示例说明
+
+在接下来的操作中，我们将使用 [dubbo-samples-gateway-triple-apisix](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-gateway/dubbo-samples-gateway-apisix/dubbo-samples-gateway-apisix-dubbo) 项目进行部分展示。
在进入正式操作前，我们先简单看下 Dubbo 接口的定义、配置以及相关实现。
#### 接口实现一览
```java
-public interface DemoService {
+public interface ApisixService {
/**
* standard samples dubbo infterace demo
@@ -48,20 +95,10 @@ public interface DemoService {
如上所示，Dubbo 接口的定义是固定的。即方法参数中 `Map` 表示 APISIX 传递给 Dubbo Provider 关于 HTTP request 的一些信息（如：header、body...)。而方法返回值的 `Map` 表示 Dubbo Provider 传递给 APISIX 要如何返回 HTTP response 的一些信息。
-接口信息配置好之后可通过 XML 配置方式发布 DemoService。
-
-```xml
-
-
+
+以下是一个使用 `Higress + dubbo协议 + Nacos注册中心` 的完整示例：[dubbo-samples-gateway-higress-dubbo](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-gateway/dubbo-samples-gateway-higress/dubbo-samples-gateway-higress-dubbo)。
+
## 前提条件
-1. Higress目前支持的Dubbo框架的版本为2.x。若您使用Dubbo3.0，要求使用dubbo协议（目前暂不支持Triple协议）。
-2. 已安装Higress，并开启了对Istio CRD的支持，参考[Higress安装部署文档](https://higress.io/zh-cn/docs/ops/deploy-by-helm)。
+1. 已安装Higress，并开启了对Istio CRD的支持，参考[Higress安装部署文档](https://higress.io/zh-cn/docs/ops/deploy-by-helm)。
## 部署Nacos和Dubbo服务
@@ -65,7 +70,7 @@ spec:
app: nacos-server
type: ClusterIP
```
-在K8s集群中apply以下资源，以部署一个Dubbo服务，该Dubbo服务将注册到上述的Naocs中。
+在 K8s 集群中 apply 以下资源，以部署一个Dubbo服务，该 Dubbo 服务将注册到上述的 Naocs 中（你可以选择重新打包，我们接下来直接使用社区提前准备好的镜像包）。
```yaml
apiVersion: apps/v1
kind: Deployment
@@ -91,59 +96,44 @@ spec:
- name: DUBBO_REGISTRY_ADDRESS
value: nacos-server.default.svc.cluster.local
```
-该Dubbo服务的代码可以在Nacos的[示例代码](https://github.com/nacos-group/nacos-examples/tree/master/nacos-dubbo-example)仓库中找到，其接口定义为：
+该Dubbo服务的代码可以在 [dubbo-samples-gateway-higress-dubbo](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-gateway/dubbo-samples-gateway-higress/dubbo-samples-gateway-higress-dubbo) 仓库中找到，其接口定义为：
```java
-package com.alibaba.nacos.example.dubbo.service;
+package org.apache.dubbo.samples.gateway.api;
public interface DemoService {
- String sayName(String name);
+ String sayHello(String name);
}
```
接口实现如下：
```java
-package com.alibaba.nacos.example.dubbo.service;
-
-import com.alibaba.dubbo.config.annotation.Service;
-import com.alibaba.dubbo.rpc.RpcContext;
-import org.springframework.beans.factory.annotation.Value;
-
-/**
- * Default {@link DemoService}
- * https://nacos.io/zh-cn/docs/use-nacos-with-dubbo.html
- * @since 2.6.5
- */
@Service(version = "${demo.service.version}", group = "${demo.service.group}")
-public class DefaultService implements DemoService {
-
- @Value("${demo.service.name}")
- private String serviceName;
-
- public String sayName(String name) {
- RpcContext rpcContext = RpcContext.getContext();
- return String.format("Service [name :%s , port : %d] %s(\"%s\") : Hello,%s",
- serviceName,
- rpcContext.getLocalPort(),
- rpcContext.getMethodName(),
- name,
- name);
+public class DemoServiceImpl implements DemoService {
+ @Override
+ public String sayHello(String name) {
+ return "Hello " + name;
}
}
```
-在本示例中，该Dubbo服务的服务名为com.alibaba.nacos.example.dubbo.service.DemoService，服务版本为1.0.0，服务分组为dev。
+在本示例中，该Dubbo服务的服务名为 `org.apache.dubbo.samples.gateway.api.DemoService`，服务版本为 `1.0.0`，服务分组为 `dev`。
+
+为了测试方便，我们可以通过运行以下命令来将我们部署在 K8S 集群中的 Naocs 服务映射到本地端口：
-为了测试方便，我们可以通过运行以下命令来将我们部署在K8s集群中的Naocs服务映射到本地端口：
```bash
kubectl port-forward svc/nacos-server 8848:8848 --address='0.0.0.0'
```
+
然后请求Nacos的服务发现接口，可以查看到我们Dubbo服务的元数据信息，从而对以上部署进行验证。
+
```bash
-$curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=providers:com.alibaba.nacos.example.dubbo.service.DemoService:1.0.0:dev'
+$ curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=providers:com.alibaba.nacos.example.dubbo.service.DemoService:1.0.0:dev'
+
{"name":"DEFAULT_GROUP@@providers:com.alibaba.nacos.example.dubbo.service.DemoService:1.0.0:dev","groupName":"DEFAULT_GROUP","clusters":"","cacheMillis":10000,"hosts":[{"ip":"10.244.0.58","port":20880,"weight":1.0,"healthy":true,"enabled":true,"ephemeral":true,"clusterName":"DEFAULT","serviceName":"DEFAULT_GROUP@@providers:com.alibaba.nacos.example.dubbo.service.DemoService:1.0.0:dev","metadata":{"side":"provider","release":"dubbo_demo","methods":"sayName","deprecated":"false","dubbo":"2.0.2","pid":"3034042","interface":"com.alibaba.nacos.example.dubbo.service.DemoService","service-name-mapping":"true","version":"1.0.0","generic":"false","revision":"dubbo_demo","path":"com.alibaba.nacos.example.dubbo.service.DemoService","protocol":"dubbo","metadata-type":"remote","application":"dubbo-provider-demo","background":"false","dynamic":"true","category":"providers","group":"dev","anyhost":"true","timestamp":"1680176973875"},"ipDeleteTimeout":30000,"instanceHeartBeatInterval":5000,"instanceHeartBeatTimeOut":15000}],"lastRefTime":1680178336936,"checksum":"","allIPs":false,"reachProtectionThreshold":false,"valid":true}%
```
## 通过Ingress转发请求到Dubbo服务
-Higress可以通过McpBridge来对接Nacos作为服务来源，在K8s集群中apply以下资源来配置McpBridge
+Higress 可以通过 McpBridge 来对接 Nacos 作为服务来源，在 K8s 集群中 apply 以下资源来配置 McpBridge
+
```yaml
apiVersion: networking.higress.io/v1
kind: McpBridge
@@ -159,15 +149,17 @@ spec:
port: 8848
type: nacos2
```
+
通过McpBridge，我们可以直接从Nacos中发现Dubbo服务，并为其创建路由，而无需为每一个Dubbo服务创建service资源。
接下来我们创建如下Ingress，从而创建一条指向Dubbo服务的HTTP路由：
+
```yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
- higress.io/destination: providers:com.alibaba.nacos.example.dubbo.service.DemoService:1.0.0:dev.DEFAULT-GROUP.public.nacos
+ higress.io/destination: gateway-higress-dubbo-provider.DEFAULT-GROUP.public.nacos
name: demo
namespace: higress-system
spec:
@@ -183,12 +175,24 @@ spec:
path: /dubbo
pathType: Prefix
```
-这样，path前缀为/dubbo的请求就会被路由到我们刚刚创建的Dubbo服务上。
+
+这样，path前缀为 `/dubbo` 的请求就会被路由到我们刚刚创建的 Dubbo 服务上。
+
+
+{{% alert title="注意" color="info" %}}
+以上 `higress.io/destination` 用来指定本路由的地址来源，它使用 `服务名称.服务分组.命名空间ID.nacos` 的固定格式，其中，
+* `服务名称` 可以是应用名或者接口名，Dubbo3 建议直接配置应用名，只有使用接口级服务发现时配置接口名，其格式为完整 `nacos dataid`，如 `providers:{service-name}:{version}:{group}`
+* `服务分组`，nacos 分组，未明确设置时，使用 `DEFAULT-GROUP` 即可。注意这里需要遵循 DNS 域名格式，因此服务分组中的下划线'_'被转换成了横杠'-'
+* `命名空间ID`，nacos 命空间，未明确设置时，使用 `public` 即可
+* `nacos`，使用固定值 `nacos` 代表数据来源
+{{% /alert %}}
## 通过EnvoyFilter配置HTTP到Dubbo的协议转换规则
+
经过上述步骤，我们已经在K8s环境下部署了一套Naocs和Dubbo，并通过Ingress将path前缀为/dubbo的请求路由到我们配好的Dubbo服务上。但光是这样是无法正常通信的，因为Dubbo服务使用的是定制的Dubbo协议，无法天然与HTTP协议进行兼容。因此接下来我们将通过EnvoyFilter来配置HTTP到Dubbo的协议转换规则，从而实现用HTTP请求来调用Dubbo服务。
在K8s集群中apply以下资源，要注意的是，EnvoyFilter是属于Istio的CRD，因此需要参照前提条件中的第2点来开启Higress对Istio CRD的支持。
+
```yaml
apiVersion: networking.istio.io/v1alpha3
kind: EnvoyFilter
@@ -249,13 +253,13 @@ spec:
path_matcher:
match_http_method_spec: ALL_GET
match_pattern: /dubbo/hello
- name: com.alibaba.nacos.example.dubbo.service.DemoService
+ name: org.apache.dubbo.samples.gateway.api.DemoService
version: 1.0.0
url_unescape_spec: ALL_CHARACTERS_EXCEPT_RESERVED
- applyTo: CLUSTER
match:
cluster:
- service: providers:com.alibaba.nacos.example.dubbo.service.DemoService:1.0.0:dev.DEFAULT-GROUP.public.nacos
+ service: gateway-higress-dubbo.DEFAULT-GROUP.public.nacos
context: GATEWAY
patch:
operation: MERGE
@@ -269,11 +273,14 @@ spec:
在以上EnvoyFilter中，我们配置了将path为/dubbo/hello的HTTP请求转发到Dubbo服务com.alibaba.nacos.example.dubbo.service.DemoService:1.0.0:dev中，并调用其sayName方法，而该方法的参数则通过HTTP url中的的query参数p来指定。
## 请求验证
+
通过以上配置，我们就可以执行以下curl命令来调用这个dubbo服务了：
```bash
$curl "localhost/dubbo/hello?p=abc"
{"result":"Service [name :demoService , port : 20880] sayName(\"abc\") : Hello,abc"}
```
-## 配置参考
-EnvoyFilter的相关配置项参考[HTTP转Dubbo配置说明](https://higress.io/zh-cn/docs/user/dubbo-envoyfilter)
\ No newline at end of file
+## 参考资料
+
+* EnvoyFilter的相关配置项参考[HTTP转Dubbo配置说明](https://higress.io/zh-cn/docs/user/dubbo-envoyfilter)
+* 完整示例源码 [dubbo-samples-gateway-higress-dubbo](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-gateway/dubbo-samples-gateway-higress/dubbo-samples-gateway-higress-dubbo)
\ No newline at end of file
diff --git a/content/zh-cn/blog/java/codeanalysis/multiple-protocols-on-one-port.md b/content/zh-cn/blog/java/codeanalysis/multiple-protocols-on-one-port.md
new file mode 100644
index 000000000000..0e7e83f2503b
--- /dev/null
+++ b/content/zh-cn/blog/java/codeanalysis/multiple-protocols-on-one-port.md
@@ -0,0 +1,135 @@
+---
+aliases:
+ - /zh/overview/tasks/protocols/multi-protocols/
+ - /zh-cn/overview/tasks/protocols/multi-protocols/
+description: ""
+linkTitle: 单端口多协议
+title: 发布使用不同协议的多个服务，通过单端口监听
+date: 2024-3-19
+author: 陈景明
+tags: ["源码解析", "协议"]
+description: >
+ Dubbo3 框架支持在单个端口发布多个不同的协议，比如可以同时发布 dubbo、triple 协议，本文介绍 Dubbo 是如何实现单端口多协议发布的。
+---
+
+
+通过对protocol进行配置，dubbo3可以支持端口的协议复用。
+比如使用Triple协议启动端口复用后，可以在相同的端口上为服务增加
+Dubbo协议支持，以及Qos协议支持。这些协议的识别都是由一个统一的端口复用
+服务器进行处理的，可以用于服务的协议迁移，并且可以节约端口以及相关的资源，减少运维的复杂性。
+
+
+
+- 在服务的创建阶段，通过从Config层获取到服务导出的协议配置从而创建不同的Protocol对象进行导出。在导出的过程
+中，如果不是第一次创建端口复用的Server，那么Exchanger会将Protcol层传递的数据保存到Server，用于后续处理该协议类型的消息。
+
+- 当客户端的消息传递过来后，首先会通过Server传递给ProtocolDetector，如果完成了识别，那么就会标记该客户端为对应的协议。并通过WireProtocol配置对应的处理逻辑，最后交给ChannelOperator完成底层的IO框架和对应的Dubbo框架的处理逻辑的绑定。
+
+- 以上的协议识别完成之后，Channel已经确定了如何处理远程的客户端消息，通过对应的ServerPipeline进行处理即可（在处理的过程中也会根据配置信息决定消息的处理线程）。
+
+## 使用方式
+在同一主机上部署多个服务或需要通过负载均衡器访问多个服务。
+
+## 参考用例
+[https://github.com/apache/dubbo-samples/tree/master/dubbo-samples-port-unification](https://github.com/apache/dubbo-samples/tree/master/3-extensions/protocol/dubbo-samples-port-unification)
+
+
+## 配置方式
+
+关于Dubbo支持的配置方式，可以参考[配置说明](/zh-cn/overview/mannual/java-sdk/reference-manual/config/)
+
+### 服务多协议导出
+
+ext-protocol参数支持配置多个不同的协议，协议之间通过","进行分隔。
+
+#### xml 配置
+
+```xml
++1. 示例提供了运行以下命令部署到本地Kubernetes集群： + + ```shell + kubectl apply -f xxx/kubernetes-manifests.yaml + ``` + +2. 示例提供了 Java 和 Go 语言实现，点击链接查看源码。 +
+ +
+
+-
Dubbo Golang SDK 手册
Rust SDK 手册
+Dubbo Rust SDK 手册
-更多关于 Nacos、Zookeeper 等服务发现的使用方式，负载均衡策略配置等。
+学习如何实现按比例流量分配、金丝雀发布、调整超时时间、流量灰度、服务降级等流量管控。
+开启 Metrics 采集，通过 Prometheus、Grafana 可视化查看应用、服务、示例状态。
+开启 OpenTelemetry 全链路追踪。
+如何使用 Higress、Nginx 等网关产品，将前端 http 流量（北向流量）接入后端 dubbo-go 微服务集群。
+使用 Apache Seata 作为分布式事务解决方案，解决分布式数据一致性问题。
+学习 Streaming 通信模型、配置超时时间、传递headers等更多框架配置。
+学习如何使用 dubbo-go 开发微服务，引入服务发现、可观测性、流量管控等服务治理能力。
+- * Sends a greeting - *- */ - User sayHello(HelloRequest request); - } - ``` - - Go client (由protoc-gen-go-triple 根据 proto 文件自动生成) - - ```go - type GreeterClientImpl struct { - // Sends a greeting - SayHello func(ctx context.Context, in *HelloRequest) (*User, error) - } - ``` - - Go server (由开发者定义) - - ```go - type GreeterProvider struct { - api.GreeterProviderBase - } - - func (s *GreeterProvider) SayHello(ctx context.Context, in *api.HelloRequest) (*api.User, error) { - logger.Infof("Dubbo3 GreeterProvider get user name = %s\n", in.Name) - return &api.User{Name: "Hello " + in.Name, Id: "12345", Age: 21}, nil - } - ``` - - Go 方法需要遵守 [Dubbogo 3.0 用户服务接口定义规范](https://www.yuque.com/docs/share/eff9c51f-a7f4-47d6-87ff-11a2152bdffe?) - - - -- Java 的三元组与Go service/reference 配置的 interface 一致 - - 三元组，即为接口级别配置的：interface, group, version。**其中需要注意，group 和 version 的概念为 dubbo 接口的 group 和vesion，在启动 dubbo-java 服务时配置于 spring cloud 的 properties 文件中，并非pom.xml 中 mvn 依赖的version。** group 和version 默认为空，在 dubbo-go 框架中，可以在service/reference 的对应位置指定 group 和 version。 - - 例如： - - Java 的接口全名：com.apache.dubbo.sample.basic.IGreeter，接口 version 为v1.0.1, group 为 - - Go-client: - - ```yaml - references: - GreeterClientImpl: - protocol: tri - interface: com.apache.dubbo.sample.basic.IGreeter # must be compatible with grpc or dubbo-java - group: dubbogo # 需要与服务端对应 默认为空 - version: v1.0.1 # 需要与服务端对应 默认为空 - ``` - - Go-server: - - ```yaml - services: - GreeterProvider: - protocol-ids: tripleProtocol - interface: com.apache.dubbo.sample.basic.IGreeter # must be compatible with grpc or dubbo-java - group: dubbogo # 需要与服务端对应 默认为空 - version: v1.0.1 # 需要与服务端对应 默认为空 - ``` - - - -## 1. 基于 Triple 协议互通 (PB序列化) - -参考 [dubbo-go-samples/helloworld](https://github.com/apache/dubbo-go-samples/tree/f7febed9d686cb940ea55d34b5baa567d7574a44/helloworld) - -### 1.1 Go-Client -> Java-Server - -#### Java-Server 启动 - -1. 定义 Java 的 PB 文件，可参考 [Dubbo 快速开始](/zh-cn/docs/quick-start/) - -```protobuf -syntax = "proto3"; - -option java_package = "org.apache.dubbo.sample.hello"; - -package helloworld; - -// The request message containing the user's name. -message HelloRequest { - string name = 1; -} - -// The response message containing the greetings -message User { - string name = 1; - string id = 2; - int32 age = 3; -} -``` - -该接口描述文件定义了将会生成的 Java 类 org.apache.dubbo.sample.hello.Helloworld，以及类中包含的传输结构 HelloRequest 和 User 类。 - -2. 定义服务接口: - - com.apache.dubbo.sample.basic.IGreeter - -```java -package com.apache.dubbo.sample.basic; - -// 引入根据 PB 生成的类 -import org.apache.dubbo.sample.hello.Helloworld.User; -import org.apache.dubbo.sample.hello.Helloworld.HelloRequest; - -public interface IGreeter { - /** - *
- * Sends a greeting - *- */ - // 定义接口 - User sayHello(HelloRequest request); -} -``` - -3. 实现服务接口: - - IGreeter1Impl.java - -```java -package com.apache.dubbo.sample.basic; - -import org.apache.dubbo.sample.hello.Helloworld.User; -import org.apache.dubbo.sample.hello.Helloworld.HelloRequest; - -public class IGreeter1Impl implements IGreeter { - @Override - public User sayHello(HelloRequest request) { - System.out.println("receiv: " + request); - User usr = User.newBuilder() - .setName("hello " + request.getName()) - .setAge(18) - .setId("12345").build(); - return usr; - } -} -``` - -4. 使用 Dubbo3 框架启动服务 - - ApiProvider.java - -```java -package com.apache.dubbo.sample.basic; - -import org.apache.dubbo.common.constants.CommonConstants; -import org.apache.dubbo.config.ApplicationConfig; -import org.apache.dubbo.config.ProtocolConfig; -import org.apache.dubbo.config.RegistryConfig; -import org.apache.dubbo.config.ServiceConfig; -import java.util.concurrent.CountDownLatch; - -public class ApiProvider { - public static void main(String[] args) throws InterruptedException { - ServiceConfig
+
+
+## 使用方式
+### 1. Filter 拦截器概念
+
+Filter 定义如下：
+
+```go
+// Filter interface defines the functions of a filter
+// Extension - Filter
+type Filter interface {
+ // Invoke is the core function of a filter, it determines the process of the filter
+ Invoke(context.Context, protocol.Invoker, protocol.Invocation) protocol.Result
+ // OnResponse updates the results from Invoke and then returns the modified results.
+ OnResponse(context.Context, protocol.Result, protocol.Invoker, protocol.Invocation) protocol.Result
+}
+```
+
+Filter 可以加载在 Consumer 端或者 Provider端。当加载在 Consumer 端，其Invoke函数调用的下游为网络层，OnResponse 为请求结束从网络层获取到返回结果后被调用。当加载在 Provider 端，其 Invoke 函数调用的下游为用户代码，OnResponse 为用户代码执行结束后向下传递至网络层前被调用。
+
+Filter 采用面向切面设计的思路，通过对 Filter 的合理扩展，可以记录日志、设置数据打点，记录 invoker 所对应服务端性能，限流等等工作。
+
+### 2. 框架预定义 Filter
+
+框架预定义了一系列filter，可以在配置中直接使用，其代码实现位于 [filter](https://github.com/apache/dubbo-go/tree/main/filter)
+
+- accesslog
+- active
+- sign: AuthConsumerFilter
+- auth: AuthProviderFilter
+- echo
+- execute: ExecuteLimitFilter
+- generic: GenericFilter
+- generic_service: GenericServiceFilter
+- pshutdown: GracefulShutdownProviderFilter
+- cshutdown: GracefulShutdownConsumerFilter
+- hystrix_consumer: HystrixConsumerFilter
+- hystrix_provider: HystrixProviderFilter
+- metrics
+- seata
+- sentinel-provider
+- sentinel-consumer
+- token
+- tps
+- tracing
+
+### 3. 默认加载Filter
+
+用户在配置文件中配置了自定义 Filter 加载策略时，框架将同时加载用户配置的 filters 和默认 filters，否则仅加载默认 filters。当前版本默认激活的 filter 列表如下：
+
+- Consumer: cshutdown
+- Provider: echo, metrics, token, accesslog, tps, generic_service, executivete, pshutdown
+
+### 4. 自定义Filter
+
+用户可在代码中自定义 Filter，注册到框架上，并在配置中选择使用。
+
+```go
+func init() {
+ extension.SetFilter("myCustomFilter", NewMyClientFilter)
+}
+
+func NewMyClientFilter() filter.Filter {
+ return &MyClientFilter{}
+}
+
+type MyClientFilter struct {
+}
+
+func (f *MyClientFilter) Invoke(ctx context.Context, invoker protocol.Invoker, invocation protocol.Invocation) protocol.Result {
+ fmt.Println("MyClientFilter Invoke is called, method Name = ", invocation.MethodName())
+ return invoker.Invoke(ctx, invocation)
+}
+func (f *MyClientFilter) OnResponse(ctx context.Context, result protocol.Result, invoker protocol.Invoker, protocol protocol.Invocation) protocol.Result {
+ fmt.Println("MyClientFilter OnResponse is called")
+ return result
+}
+```
+
+## 完整示例
+可通过以下链接学习如何使用 API 配置和启用 Filter 的 完整示例源码地址
+
+
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/healthcheck.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/healthcheck.md
new file mode 100644
index 000000000000..ec9b82a65f1f
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/healthcheck.md
@@ -0,0 +1,95 @@
+---
+description: 健康检查
+title: 健康检查
+type: docs
+weight: 3
+---
+
+## 背景
+
+Dubbo-go 内置了基于 triple 协议的健康检查服务，帮助用户管理和监测服务健康状态，可在此查看 完整示例源码。
+
+## 使用方法
+
+- 框架在通过 `instance` 启动后会自动向框架中注册健康检查服务 `grpc.health.v1.Health`，用于记录并对外暴露每个triple服务的健康状态。
+- 健康检查服务可以通过发起 http 请求检查框架中服务的状态，也可以通过客户端调用该健康检查服务，调用的接口为`grpc.health.v1.Health`，方法为 `check`。
+
+## 1、通过客户端调用健康检查服务
+
+启动 dubbo-go-samples/healthcheck/go-server 中的服务，通过下方客户端即可查看 `greet.GreetService` 的状态。
+
+```go
+package main
+
+import (
+ "context"
+ "dubbo.apache.org/dubbo-go/v3/client"
+ _ "dubbo.apache.org/dubbo-go/v3/imports"
+ health "dubbo.apache.org/dubbo-go/v3/protocol/triple/health/triple_health"
+ "github.com/dubbogo/gost/log/logger"
+)
+
+func main() {
+ cli, err := client.NewClient(
+ client.WithClientURL("tri://127.0.0.1:20000"),
+ )
+ if err != nil {
+ panic(err)
+ }
+ svc, err := health.NewHealth(cli)
+ if err != nil {
+ panic(err)
+ }
+ check, err := svc.Check(context.Background(), &health.HealthCheckRequest{Service: "greet.GreetService"})
+ if err != nil {
+ logger.Error(err)
+ } else {
+ logger.Info("greet.GreetService's health", check.String())
+ }
+ watch, err := svc.Watch(context.Background(), &health.HealthCheckRequest{Service: "greet.GreetService"})
+ if err != nil {
+ logger.Error(err)
+ } else {
+ if watch.Recv() {
+ logger.Info("greet.GreetService's health", watch.Msg().String())
+ }
+ }
+}
+```
+
+启动后会有以下输出
+
+```sh
+[greet.GreetService's health status:SERVING]
+[greet.GreetService's health status:SERVING]
+```
+
+## 2.通过发起http请求检查服务健康状态
+
+启动 dubbo-go-samples/healthcheck/go-server 中的服务，发起下方http请求即可查看 `greet.GreetService` 的状态：
+
+```http
+POST /grpc.health.v1.Health/Check
+Host: 127.0.0.1:20000
+Content-Type: application/json
+
+{"service":"greet.GreetService"}
+```
+
+将会有以下输出
+
+```http
+{
+ "status": "SERVING"
+}
+```
+
+
+## 更多内容
+值得注意的是，当前框架中尚未建立完整的服务状态管理机制，dubbo-go 框架会将所有加载的服务设置为 `SERVING` 状态，但尚没有 `NOT SERVING` 设置机制（在满足某个特定条件的情况下将服务状态设置为 NOT SERVING）。
+
+如果有需要，用户可通过扩展 dubbo-go 框架的方式，提供完整的服务状态管理能力，这样就可以查询到实时更新的服务状态，并根据服务状态进行流量转发。
+
+部分参考资料：
++ https://github.com/grpc/grpc/blob/master/doc/health-checking.md
++ https://github.com/grpc/grpc-go/tree/master/health
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/protocol.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/protocol.md
new file mode 100644
index 000000000000..d45d451e844b
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/protocol.md
@@ -0,0 +1,143 @@
+---
+description: 配置通信协议
+title: 通信协议
+linkTitle: 通信协议
+type: docs
+weight: 3
+---
+
+Dubbo-go 框架内置提供了两款协议：triple、dubbo，除此之外，框架还提供了多种协议扩展接入方式。
+* triple，基于 HTTP/1、HTTP/2 的高性能通信协议，100% 兼容 gRPC，支持 Unary、Streming 等通信模式；支持发布 REST 风格的 HTTP 服务。
+ * dubbo，基于 TCP 的高性能私有通信协议，缺点是通用性较差，更适合在 Dubbo SDK 间使用；
+ * 任意协议扩展，通过扩展 protocol 可以之前任意 RPC 协议，官方生态库提供 JsonRPC、thrift 等支持。
+
+本篇文档中，我们将介绍关于 triple 协议的使用方式、如何实现与已有 dubbo2 系统的互相调用、扩展更多协议支持等。更多原理性介绍请参考 [协议规范](/zh-cn/overview/reference/protocols/triple-spec/) 或者 [dubbo java 中相关描述文档](/zh-cn/overview/mannual/java-sdk/tasks/protocols/protocol/)。
+
+## triple 协议
+triple 协议支持使用 protobuf 和 non-protobuf 两种开发模式，我们 **推荐使用 protobuf 模式开发服务**。
+
+目前我们大部分示例都是使用这个模式开发，可查看 [快速开始](/zh-cn/overview/mannual/golang-sdk/quickstart/rpc/) 学习完整开发示例，以下是基本步骤：
+
+1. 先使用 protobuf 定义服务
+
+```protobuf
+syntax = "proto3";
+package greet;
+option go_package = "github.com/apache/dubbo-go-samples/helloworld/proto;greet";
+
+message GreetRequest {
+ string name = 1;
+}
+
+message GreetResponse {
+ string greeting = 1;
+}
+
+service GreetService {
+ rpc Greet(GreetRequest) returns (GreetResponse) {}
+}
+```
+
+2. [安装 protoc 插件](/zh-cn/overview/mannual/golang-sdk/quickstart/rpc/#前置条件)，编译生成代码：
+```shell
+protoc --go_out=. --go_opt=paths=source_relative \
+ --go-triple_out=. --go-triple_opt=paths=source_relative \
+ proto/greet.proto
+```
+
+3. server 端发布服务
+```go
+srv, err := server.NewServer(
+ server.WithServerProtocol(
+ protocol.WithPort(20000),
+ protocol.WithTriple(),
+ ),
+)
+
+greet.RegisterGreetServiceHandler(srv, &GreetTripleServer{})
+```
+
+4. client 端调用服务
+```go
+cli, err := client.NewClient(
+ client.WithClientURL("127.0.0.1:20000"),
+)
+
+svc, err := greet.NewGreetService(cli)
+resp, err := svc.Greet(context.Background(), &greet.GreetRequest{Name: "hello world"})
+```
+
+## dubbo-java 体系互调
+
+如果 java 和 go 都使用 triple+protobuf 模式，很明显他们是可以直接互调通信的。
+
+但问题是很多 java 用户是使用的 triple non-protobuf 模式，还有一些老版本用户是使用的 dubbo tcp 协议。对于这部分业务，我们要可以使用 dubbo-go 框架的以下编码模式实现协议互调：
+
+1. 定义服务
+
+直接使用 struct 定义服务：
+
+```go
+type GreetProvider struct {
+}
+
+func (*GreetProvider) SayHello(req string, req1 string, req2 string) (string, error) {
+ return req + req1 + req2, nil
+}
+```
+
+2. server 发布服务
+
+指定要发布的协议，可以是 dubbo、triple 或其他协议，请注意 `WithInterface("GreetProvider")` 要保持和 dubbo-java 侧的服务名一致（如保持 java 全路径名）：
+
+```go
+ins, err := dubbo.NewInstance(
+ dubbo.WithName("dubbo_server"),
+ dubbo.WithProtocol(
+ protocol.WithTriple(),
+ protocol.WithPort(20001)),
+)
+
+srvDubbo, err := ins.NewServer()
+if err != nil {
+ panic(err)
+}
+if err = srvDubbo.Register(&GreetProvider{}, nil, server.WithInterface("GreetProvider")); err != nil {
+ panic(err)
+}
+if err = srvDubbo.Serve(); err != nil {
+ logger.Error(err)
+}
+```
+
+3. client 调用服务
+
+指定要调用的协议，可以是 dubbo、triple 或其他协议，请注意 `WithInterface("GreetProvider")` 要保持和 dubbo-java 侧的服务名一致（如保持 java 全路径名）：
+
+```go
+cliDubbo, _ := client.NewClient(
+ client.WithClientProtocolTriple(),
+ client.WithClientSerialization(constant.Hessian2Serialization),
+)
+
+connDubbo, _ := cliDubbo.Dial("GreetProvider")
+ipanic(err)
+}
+var respDubbo string
+if err = connDubbo.CallUnary(context.Background(), []interface{}{"hello", "new", "dubbo"}, &respDubbo, "SayHello"); err != nil {
+ logger.Errorf("GreetProvider.Greet err: %s", err)
+ return
+}
+```
+
+## 协议扩展
+
+Dubbo 框架支持协议扩展，目前官方生态支持的协议包括：
+* triple
+* dubbo
+* jsonrpc
+
+
+在一些场景下，你可以在一个应用内同时发布多个协议的服务，或者同时以不同的协议调用服务，这里有一个 [多协议发布的使用示例](https://github.com/apache/dubbo-go-samples/tree/main/multirpc) 供参考。
+
+
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/retry.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/retry.md
new file mode 100644
index 000000000000..f8d37d326dce
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/retry.md
@@ -0,0 +1,185 @@
+---
+description: 请求重试
+title: 请求重试
+type: docs
+weight: 3
+---
+
+当一次服务调用失败时，我们可以让框架选择自动重试几次，这样能提高用户侧看到的请求成功率。在 failover cluster 模式下 dubbo-go 支持自动重试。
+
+## 1.介绍
+
+本示例演示如何在 client 端调用失败时配置重试功能，完整示例源码地址
+
+## 2.如何使用重试功能
+
+在使用 `client.NewClient()` 创建客户端时，可以使用 `client.WithClientRetries()` 方法设置重试次数。
+
+```go
+cli, err := client.NewClient(
+ client.WithClientURL("tri://127.0.0.1:20000"),
+ client.WithClientRetries(3),
+)
+```
+
+或者，可以使用 `client.WithRequestTimeout()` 设置服务粒度的超时时间（以下配置对服务 `svc` 起作用）。
+
+```go
+svc, err := greet.NewGreetService(cli, client.WithClientRetries(5))
+```
+
+也可以在调用发起时，使用 `client.WithCallRetries()` 指定重试次数
+
+```go
+resp, err := svc.Greet(context.Background(), &greet.GreetRequest{Name: "hello world"}, client.WithCallRetries(6))
+```
+
+从上往下，以上三种方式的优先级逐步提高，`client.WithCallRetries()` 指定的重试次数优先级最高。
+
+
+## 3.示例解读
+
+### 3.1服务端介绍
+
+#### 服务端proto文件
+
+源文件路径：dubbo-go-sample/retry/proto/greet.proto
+
+```protobuf
+syntax = "proto3";
+
+package greet;
+
+option go_package = "github.com/apache/dubbo-go-samples/retry/proto;greet";
+
+message GreetRequest {
+ string name = 1;
+}
+
+message GreetResponse {
+ string greeting = 1;
+}
+
+service GreetService {
+ rpc Greet(GreetRequest) returns (GreetResponse) {}
+ rpc GreetTimeout(GreetRequest) returns (GreetResponse) {}
+}
+```
+
+#### 服务端handler文件
+
+`Greet`方法直接响应，`GreetRetry`方法用于模拟重试。
+```go
+package main
+
+import (
+ "context"
+ "github.com/pkg/errors"
+
+ _ "dubbo.apache.org/dubbo-go/v3/imports"
+ "dubbo.apache.org/dubbo-go/v3/protocol"
+ "dubbo.apache.org/dubbo-go/v3/server"
+ greet "github.com/apache/dubbo-go-samples/retry/proto"
+ "github.com/dubbogo/gost/log/logger"
+)
+
+type GreetTripleServer struct {
+ requestTime int
+}
+
+func (srv *GreetTripleServer) Greet(ctx context.Context, req *greet.GreetRequest) (*greet.GreetResponse, error) {
+ resp := &greet.GreetResponse{Greeting: req.Name}
+ logger.Info("Not need retry, request success")
+ return resp, nil
+}
+
+func (srv *GreetTripleServer) GreetRetry(ctx context.Context, req *greet.GreetRequest) (*greet.GreetResponse, error) {
+ if srv.requestTime < 3 {
+ srv.requestTime++
+ logger.Infof("retry %d times", srv.requestTime)
+ return nil, errors.New("retry")
+ }
+ resp := &greet.GreetResponse{Greeting: req.Name}
+ logger.Infof("retry success, current request time is %d", srv.requestTime)
+ srv.requestTime = 0
+ return resp, nil
+}
+
+func main() {
+ srv, err := server.NewServer(
+ server.WithServerProtocol(
+ protocol.WithPort(20000),
+ ),
+ )
+ if err != nil {
+ panic(err)
+ }
+ if err := greet.RegisterGreetServiceHandler(srv, &GreetTripleServer{
+ requestTime: 0,
+ }); err != nil {
+ panic(err)
+ }
+ if err := srv.Serve(); err != nil {
+ logger.Error(err)
+ }
+}
+
+```
+
+### 3.2客户端介绍
+
+客户端client文件，创建客户端，设置重试次数为3，分别请求`Greet`和`GreetRetry`，观察服务端日志输出。
+
+```go
+package main
+
+import (
+ "context"
+
+ "dubbo.apache.org/dubbo-go/v3/client"
+ _ "dubbo.apache.org/dubbo-go/v3/imports"
+ greet "github.com/apache/dubbo-go-samples/retry/proto"
+ "github.com/dubbogo/gost/log/logger"
+)
+
+func main() {
+ cli, err := client.NewClient(
+ client.WithClientURL("tri://127.0.0.1:20000"),
+ client.WithClientRetries(3),
+ )
+ if err != nil {
+ panic(err)
+ }
+
+ svc, err := greet.NewGreetService(cli)
+ if err != nil {
+ panic(err)
+ }
+
+ // request normal
+ resp, err := svc.Greet(context.Background(), &greet.GreetRequest{Name: "hello world"})
+ if err != nil {
+ logger.Error(err)
+ }
+ logger.Infof("Greet response: %s", resp.Greeting)
+
+ // request need retry
+ resp, err = svc.GreetRetry(context.Background(), &greet.GreetRequest{Name: "hello world"})
+ if err != nil {
+ logger.Error(err)
+ }
+ logger.Infof("Greet response: %s", resp.Greeting)
+}
+```
+
+### 3.3案例效果
+
+先启动服务端，再启动客户端，访问`GreetRetry`时观察到服务端日志输出了重试次数。
+
+```
+2024-01-23 22:39:11 INFO logger/logging.go:22 [Not need retry, request success]
+2024-01-23 22:39:11 INFO logger/logging.go:42 retry [1] times
+2024-01-23 22:39:11 INFO logger/logging.go:42 retry [2] times
+2024-01-23 22:39:11 INFO logger/logging.go:42 retry [3] times
+2024-01-23 22:39:11 INFO logger/logging.go:42 retry success, current request time is [3]
+```
\ No newline at end of file
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/start-check.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/start-check.md
new file mode 100644
index 000000000000..3925a17a2b63
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/start-check.md
@@ -0,0 +1,43 @@
+---
+aliases:
+ - /zh/docs3-v2/golang-sdk/tutorial/governance/health/start-check/
+ - /zh-cn/docs3-v2/golang-sdk/tutorial/governance/health/start-check/
+ - /zh-cn/overview/mannual/golang-sdk/tutorial/governance/health/start-check/
+description: "缺省会在启动时检查依赖的服务是否可用（注册中心是否有可用地址），不可用时会抛出异常，阻止应用初始化完成。"
+keywords: 启动时检查
+title: 启动时检查
+type: docs
+weight: 4
+---
+
+Dubbo 框架缺省会在启动时检查依赖的服务是否可用（注册中心是否有可用地址），不可用时会抛出异常，阻止应用初始化完成，以便上线时，能及早发现问题，默认 check="true"，并等待3s。
+
+可以通过 check="false" 关闭检查，比如，测试时，有些服务不关心，或者出现了循环依赖，必须有一方先启动。
+
+关闭 check 后，请注意 provider数量比较多时， consumer 订阅 provider 生成服务地址可能会有一定延迟，如果 consumer 一启动就对外提供服务，可能会造成"冷启动"。所以在这个时候，请对服务进行预热。
+
+示例：
+
+```yaml
+dubbo:
+ consumer:
+ check : false
+ reference:
+ myserivce:
+ check: true
+```
+
+或者
+
+```go
+cli, err := client.NewClient(
+ client.WithClientCheck(false),
+)
+```
+
+或者
+
+```go
+svc, err := health.NewHealth(cli)
+svc.Check(context.Background(), &health.HealthCheckRequest{Service: "greet.GreetService"}, client.WithCheck(false))
+```
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/streaming.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/streaming.md
new file mode 100644
index 000000000000..54d704db18d5
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/streaming.md
@@ -0,0 +1,216 @@
+---
+description: 流式通信 streaming
+title: 流式通信
+type: docs
+weight: 1
+---
+Streaming 流式通信是 Dubbo3 新提供的一种 RPC 数据传输模式，适用于以下场景:
+
+- 接口需要发送大量数据，这些数据无法被放在一个 RPC 的请求或响应中，需要分批发送，但应用层如果按照传统的多次 RPC 方式无法解决顺序和性能的问题，如果需要保证有序，则只能串行发送
+- 流式场景，数据需要按照发送顺序处理, 数据本身是没有确定边界的
+- 推送类场景，多个消息在同一个调用的上下文中被发送和处理
+
+Streaming 流式通信类型分为以下三种:
+- SERVER_STREAM(服务端流)
+- CLIENT_STREAM(客户端流)
+- BIDIRECTIONAL_STREAM(双向流)
+
+## 1.介绍
+
+本文档演示如何在 Dubbo-go 中使用流式通信，可在此查看 完整示例源码地址。
+
+## 2.如何使用Dubbo-go流式通信
+
+在proto文件中需要流式通信的方法的参数前面添加stream，使用proto-gen-triple生成相应文件
+
+```protobuf
+service GreetService {
+ rpc Greet(GreetRequest) returns (GreetResponse) {}
+ rpc GreetStream(stream GreetStreamRequest) returns (stream GreetStreamResponse) {}
+ rpc GreetClientStream(stream GreetClientStreamRequest) returns (GreetClientStreamResponse) {}
+ rpc GreetServerStream(GreetServerStreamRequest) returns (stream GreetServerStreamResponse) {}
+}
+```
+
+编写服务端handler文件
+
+源文件路径: dubbo-go-sample/streaming/go-server/cmd/server.go
+
+```go
+type GreetTripleServer struct {
+}
+
+func (srv *GreetTripleServer) Greet(ctx context.Context, req *greet.GreetRequest) (*greet.GreetResponse, error) {
+ resp := &greet.GreetResponse{Greeting: req.Name}
+ return resp, nil
+}
+
+func (srv *GreetTripleServer) GreetStream(ctx context.Context, stream greet.GreetService_GreetStreamServer) error {
+ for {
+ req, err := stream.Recv()
+ if err != nil {
+ if triple.IsEnded(err) {
+ break
+ }
+ return fmt.Errorf("triple BidiStream recv error: %s", err)
+ }
+ if err := stream.Send(&greet.GreetStreamResponse{Greeting: req.Name}); err != nil {
+ return fmt.Errorf("triple BidiStream send error: %s", err)
+ }
+ }
+ return nil
+}
+
+func (srv *GreetTripleServer) GreetClientStream(ctx context.Context, stream greet.GreetService_GreetClientStreamServer) (*greet.GreetClientStreamResponse, error) {
+ var reqs []string
+ for stream.Recv() {
+ reqs = append(reqs, stream.Msg().Name)
+ }
+ if stream.Err() != nil && !triple.IsEnded(stream.Err()) {
+ return nil, fmt.Errorf("triple ClientStream recv err: %s", stream.Err())
+ }
+ resp := &greet.GreetClientStreamResponse{
+ Greeting: strings.Join(reqs, ","),
+ }
+
+ return resp, nil
+}
+
+func (srv *GreetTripleServer) GreetServerStream(ctx context.Context, req *greet.GreetServerStreamRequest, stream greet.GreetService_GreetServerStreamServer) error {
+ for i := 0; i < 5; i++ {
+ if err := stream.Send(&greet.GreetServerStreamResponse{Greeting: req.Name}); err != nil {
+ return fmt.Errorf("triple ServerStream send err: %s", err)
+ }
+ }
+ return nil
+}
+```
+
+编写客户端client文件
+
+源文件路径: dubbo-go-sample/streaming/go-client/cmd/client.go
+
+```go
+func main() {
+ cli, err := client.NewClient(
+ client.WithClientURL("tri://127.0.0.1:20000"),
+ )
+ if err != nil {
+ panic(err)
+ }
+
+ svc, err := greet.NewGreetService(cli)
+ if err != nil {
+ panic(err)
+ }
+ TestClient(svc)
+}
+
+func TestClient(cli greet.GreetService) {
+ if err := testUnary(cli); err != nil {
+ logger.Error(err)
+ }
+
+ if err := testBidiStream(cli); err != nil {
+ logger.Error(err)
+ }
+
+ if err := testClientStream(cli); err != nil {
+ logger.Error(err)
+ }
+
+ if err := testServerStream(cli); err != nil {
+ logger.Error(err)
+ }
+}
+
+func testUnary(cli greet.GreetService) error {
+ logger.Info("start to test TRIPLE unary call")
+ resp, err := cli.Greet(context.Background(), &greet.GreetRequest{Name: "triple"})
+ if err != nil {
+ return err
+ }
+ logger.Infof("TRIPLE unary call resp: %s", resp.Greeting)
+ return nil
+}
+
+func testBidiStream(cli greet.GreetService) error {
+ logger.Info("start to test TRIPLE bidi stream")
+ stream, err := cli.GreetStream(context.Background())
+ if err != nil {
+ return err
+ }
+ if sendErr := stream.Send(&greet.GreetStreamRequest{Name: "triple"}); sendErr != nil {
+ return err
+ }
+ resp, err := stream.Recv()
+ if err != nil {
+ return err
+ }
+ logger.Infof("TRIPLE bidi stream resp: %s", resp.Greeting)
+ if err := stream.CloseRequest(); err != nil {
+ return err
+ }
+ if err := stream.CloseResponse(); err != nil {
+ return err
+ }
+ return nil
+}
+
+func testClientStream(cli greet.GreetService) error {
+ logger.Info("start to test TRIPLE client stream")
+ stream, err := cli.GreetClientStream(context.Background())
+ if err != nil {
+ return err
+ }
+ for i := 0; i < 5; i++ {
+ if sendErr := stream.Send(&greet.GreetClientStreamRequest{Name: "triple"}); sendErr != nil {
+ return err
+ }
+ }
+ resp, err := stream.CloseAndRecv()
+ if err != nil {
+ return err
+ }
+ logger.Infof("TRIPLE client stream resp: %s", resp.Greeting)
+ return nil
+}
+
+func testServerStream(cli greet.GreetService) error {
+ logger.Info("start to test TRIPLE server stream")
+ stream, err := cli.GreetServerStream(context.Background(), &greet.GreetServerStreamRequest{Name: "triple"})
+ if err != nil {
+ return err
+ }
+ for stream.Recv() {
+ logger.Infof("TRIPLE server stream resp: %s", stream.Msg().Greeting)
+ }
+ if stream.Err() != nil {
+ return err
+ }
+ if err := stream.Close(); err != nil {
+ return err
+ }
+ return nil
+}
+```
+
+## 3.运行效果
+
+运行服务端和客户端，可以看到请求正常返回
+
+```
+[start to test TRIPLE unary call]
+TRIPLE unary call resp: [triple]
+[start to test TRIPLE bidi stream]
+TRIPLE bidi stream resp: [triple]
+[start to test TRIPLE client stream]
+TRIPLE client stream resp: [triple,triple,triple,triple,triple]
+[start to test TRIPLE server stream]
+TRIPLE server stream resp: [triple]
+TRIPLE server stream resp: [triple]
+TRIPLE server stream resp: [triple]
+TRIPLE server stream resp: [triple]
+TRIPLE server stream resp: [triple]
+```
+
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/timeout.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/timeout.md
new file mode 100644
index 000000000000..2b709287ffb1
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/rpc/timeout.md
@@ -0,0 +1,155 @@
+---
+description: 配置超时时间
+title: 超时时间
+type: docs
+weight: 2
+---
+
+## 1.介绍
+
+本示例演示如何在 Dubbo-go 客户端发起调用时设置请求超时时间。可在此查看 完整示例源码地址
+
+## 2.如何设置请求超时时间
+
+在创建客户端时，可以使用 `client.WithRequestTimeout()` 方法设置全局超时时间（所有使用改 client 的服务代理共享）。
+
+```go
+ cli, err := client.NewClient(
+ client.WithClientURL("tri://127.0.0.1:20000"),
+ client.WithClientRequestTimeout(3 * time.Second),
+ )
+```
+
+可以使用 `client.WithRequestTimeout()` 创建服务粒度的超时时间（以下服务代理 `svc` 发起的方法调用都使用这个时间）。
+
+```go
+ svc, err := greet.NewGreetService(cli, client.WithRequestTimeout(5 * time.Second))
+```
+
+也可以在调用发起时，使用 `client.WithCallRequestTimeout()` 指定一个超时时间
+
+```go
+resp, err := svc.GreetTimeout(context.Background(), &greet.GreetRequest{Name: "hello world"}, client.WithCallRequestTimeout(10 * time.Second))
+```
+
+从上往下，以上三种方式的优先级逐步提高，`client.WithCallRequestTimeout()` 指定的超时时间优先级最高。
+
+## 3.示例详解
+
+### 3.1服务端介绍
+
+#### 服务端proto文件
+
+源文件路径：dubbo-go-sample/timeout/proto/greet.proto
+
+```protobuf
+syntax = "proto3";
+
+package greet;
+
+option go_package = "github.com/apache/dubbo-go-samples/timeout/proto;greet";
+
+message GreetRequest {
+ string name = 1;
+}
+
+message GreetResponse {
+ string greeting = 1;
+}
+
+service GreetService {
+ rpc Greet(GreetRequest) returns (GreetResponse) {}
+ rpc GreetTimeout(GreetRequest) returns (GreetResponse) {}
+}
+```
+
+#### 服务端handler文件
+
+`Greet`方法直接响应，`GreetTimeout`方法等待五秒后响应（模拟超时）。
+
+源文件路径：dubbo-go-sample/timeout/go-server/handler.go
+
+```go
+package main
+
+import (
+ "context"
+ "time"
+
+ greet "github.com/apache/dubbo-go-samples/timeout/proto"
+)
+
+type GreetTripleServer struct {
+}
+
+func (srv *GreetTripleServer) Greet(ctx context.Context, req *greet.GreetRequest) (*greet.GreetResponse, error) {
+ resp := &greet.GreetResponse{Greeting: req.Name}
+ return resp, nil
+}
+
+func (srv *GreetTripleServer) GreetTimeout(ctx context.Context, req *greet.GreetRequest) (*greet.GreetResponse, error) {
+ time.Sleep(5 * time.Second)
+ resp := &greet.GreetResponse{Greeting: req.Name}
+ return resp, nil
+}
+```
+
+### 3.2客户端介绍
+
+客户端client文件，创建客户端，设置超时时间为3s，分别请求`Greet`和`GreetTimeout`，输出响应结果。
+
+源文件路径：dubbo-go-sample/timeout/go-client/client.go
+
+```go
+package main
+
+import (
+ "context"
+ "time"
+
+ "dubbo.apache.org/dubbo-go/v3/client"
+ _ "dubbo.apache.org/dubbo-go/v3/imports"
+ greet "github.com/apache/dubbo-go-samples/timeout/proto"
+ "github.com/dubbogo/gost/log/logger"
+)
+
+func main() {
+ cli, err := client.NewClient(
+ client.WithClientURL("tri://127.0.0.1:20000"),
+ client.WithClientRequestTimeout(3*time.Second),
+ )
+ if err != nil {
+ panic(err)
+ }
+
+ svc, err := greet.NewGreetService(cli)
+ if err != nil {
+ panic(err)
+ }
+
+ // test timeout
+ resp, err := svc.GreetTimeout(context.Background(), &greet.GreetRequest{Name: "hello world"})
+ if err != nil {
+ logger.Error("call [greet.GreetService.GreetTimeout] service timeout")
+ logger.Error(err)
+ } else {
+ logger.Infof("Greet response: %s", resp.Greeting)
+ }
+
+ // test normal
+ resp, err = svc.Greet(context.Background(), &greet.GreetRequest{Name: "hello world"})
+ if err != nil {
+ logger.Error(err)
+ }
+ logger.Infof("Greet response: %s", resp.Greeting)
+}
+```
+
+### 3.3案例效果
+
+先启动服务端，再启动客户端，可以观察到`GreetTimeout`请求响应超时，`Greet`请求响应正常
+
+```
+[call [greet.GreetService.GreetTimeout] service timeout]
+Greet response: [hello world]
+```
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/service-discovery/_index.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/service-discovery/_index.md
new file mode 100755
index 000000000000..ebd30961f991
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/service-discovery/_index.md
@@ -0,0 +1,11 @@
+---
+aliases:
+ - /zh/docs3-v2/golang-sdk/tutorial/debugging/
+ - /zh-cn/docs3-v2/golang-sdk/tutorial/debugging/
+ - /zh-cn/overview/mannual/golang-sdk/tutorial/develop/registry/
+ - /zh-cn/overview/mannual/golang-sdk/tutorial/develop/registry/service-discovery/
+description: "使用 Nacos、Zookeeper 等作为注册中心，实现地址变更的自动发现。"
+title: 地址发现
+type: docs
+weight: 20
+---
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/service-discovery/multi_registry.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/service-discovery/multi_registry.md
new file mode 100644
index 000000000000..33e7090a585c
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/service-discovery/multi_registry.md
@@ -0,0 +1,86 @@
+---
+aliases:
+ - /zh/docs3-v2/golang-sdk/tutorial/develop/registry/multi_registry/
+ - /zh-cn/docs3-v2/golang-sdk/tutorial/develop/registry/multi_registry/
+description: 多注册中心
+title: 多注册中心
+type: docs
+weight: 100
+---
+
+一个 Dubbo 应用可以配置的多个接口维度的注册中心，多注册中心可用于集群隔离、迁移等多种场景，关于这部分更详细的说明可参考 Dubbo Java 多注册中心说明。
+
+## API配置方式
+
+```go
+ins, _ := dubbo.NewInstance(
+ dubbo.WithRegistry(
+ registryWithID("nacos"),
+ registry.WithNacos(),
+ registry.WithAddress("127.0.0.1:8848"),
+ ),
+ dubbo.WithRegistry(
+ registryWithID("zookeeper"),
+ registry.WithZookeeper(),
+ registry.WithAddress("127.0.0.1:2181"),
+ ),
+)
+
+```
+
+指定某个 server 下的服务注册到哪个注册中心：
+```go
+// 指定 server 下的服务注册到 zookeeper 注册中心
+srv, _ := ins.NewServer(server.WithServerRegistryIDs([]string{"zookeeper"}))
+
+// 指定 server 下的服务注册到 nacos 注册中心
+srv2, _ := ins.NewServer(server.WithServerRegistryIDs([]string{"nacos"}))
+```
+
+指定某个特定服务注册到哪个注册中心：
+```go
+srv, _ := ins.NewServer()
+
+greet.RegisterGreetServiceHandler(srv, &GreetTripleServer{}, server.WithRegistryIDs([]string{"zookeeper"}))
+```
+
+以上使用方式对 client 侧类似。
+
+## YAML配置方式
+
+修改服务端配置 go-server/conf/dubbogo.yaml， 同时将服务注册在两个注册中心上。
+
+```yaml
+dubbo:
+ registries:
+ zookeeper: # 指定 zookeeper 注册中心
+ protocol: zookeeper
+ address: 127.0.0.1:2181
+ nacos: # 指定 nacos 注册中心
+ protocol: nacos
+ address: 127.0.0.1:8848
+ protocols:
+ triple:
+ name: tri
+ port: 20000
+```
+
+## 支持的注册中心
+* Nacos
+* Zookeeper
+* Polaris
+* Kubernetes
+
+比如使用 Polaris 作为注册中心时，你需要指定以下内容，使用 API 或 YAML 配置文件均可以：
+
+```yaml
+dubbo:
+ registries:
+ polarisMesh:
+ protocol: polaris
+ address: ${北极星服务端IP}:8091
+ namespace: ${北极星命名空间信息}
+ token: ${北极星资源鉴权 token} # 如果北极星服务端开启了针对客户端的鉴权，则需要配置该参数
+```
+
+对于 Kubernetes 注册中心的使用方式，请参考 [控制面](/zh-cn/overview/mannual/control-plane/) 文档。
\ No newline at end of file
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/service-discovery/nacos.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/service-discovery/nacos.md
new file mode 100644
index 000000000000..f5369961011d
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/service-discovery/nacos.md
@@ -0,0 +1,58 @@
+---
+aliases:
+ - /zh/docs3-v2/golang-sdk/tutorial/develop/registry/nacos-2/
+ - /zh-cn/docs3-v2/golang-sdk/tutorial/develop/registry/nacos-2/
+description: 使用 Nacos 作为注册中心
+title: 使用 Nacos 作为注册中心
+type: docs
+weight: 10
+---
+
+
+This example shows dubbo-go's service discovery feature with Nacos as registry.
+
+## 使用方式
+
+通过以下方式指定注册中心地址：
+
+```go
+ins, _ := dubbo.NewInstance(
+ dubbo.WithName("dubbo_registry_nacos_server"),
+ dubbo.WithRegistry(
+ registry.WithNacos(),
+ registry.WithAddress("127.0.0.1:8848"),
+ ),
+ dubbo.WithProtocol(
+ protocol.WithTriple(),
+ protocol.WithPort(20000),
+ ),
+)
+
+srv, err := ins.NewServer()
+```
+
+## How to run
+
+### Start Nacos server
+Follow this instruction to [install and start Nacos server](/zh-cn/overview/reference/integrations/nacos/).
+
+### Run server
+```shell
+$ go run ./go-server/cmd/server.go
+```
+
+test rpc server work as expected:
+```shell
+$ curl \
+ --header "Content-Type: application/json" \
+ --data '{"name": "Dubbo"}' \
+ http://localhost:20000/greet.GreetService/Greet
+```
+
+Open `https://localhost:8848/nacos/` with browser, check url address successfully registered into Nacos.
+
+### Run client
+```shell
+$ go run ./go-client/cmd/client.go
+hello world
+```
\ No newline at end of file
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/service-discovery/zookeeper.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/service-discovery/zookeeper.md
new file mode 100644
index 000000000000..257c969da340
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/service-discovery/zookeeper.md
@@ -0,0 +1,68 @@
+---
+aliases:
+ - /zh/docs3-v2/golang-sdk/tutorial/develop/registry/zookeeper/
+ - /zh-cn/docs3-v2/golang-sdk/tutorial/develop/registry/zookeeper/
+description: 使用 Zookeeper 作为注册中心
+title: 使用 Zookeeper 作为注册中心
+type: docs
+weight: 11
+---
+
+
+This example shows dubbo-go's service discovery feature with Zookeeper as registry.
+
+## 使用方式
+
+通过以下方式指定注册中心地址：
+
+```go
+ins, _ := dubbo.NewInstance(
+ dubbo.WithName("dubbo_registry_nacos_server"),
+ dubbo.WithRegistry(
+ registry.WithZookeeper(),
+ registry.WithAddress("127.0.0.1:2181"),
+ ),
+ dubbo.WithProtocol(
+ protocol.WithTriple(),
+ protocol.WithPort(20000),
+ ),
+)
+
+srv, err := ins.NewServer()
+```
+
+## How to run
+
+### Start Zookeeper server
+This example relies on zookeeper as registry, follow the steps below to start a zookeeper server first.
+
+1. Start zookeeper with docker, run `docker run --rm -p 2181:2181 zookeeper` or `make -f $DUBBO_GO_SAMPLES_ROOT_PATH/build/Makefile docker-up`.
+2. [Download and start zookeeper](https://zookeeper.apache.org/releases.html#download) locally on your machine.
+
+### Run server
+```shell
+$ go run ./go-server/cmd/server.go
+```
+
+test rpc server work as expected:
+```shell
+$ curl \
+ --header "Content-Type: application/json" \
+ --data '{"name": "Dubbo"}' \
+ http://localhost:20000/greet.GreetService/Greet
+```
+
+check url address successfully registered into zookeeper:
+```shell
+# enter zookeeper bin directory, for example '$HOST_PATH/apache-zookeeper-3.5.9-bin/bin'
+$ ./zkCli.sh
+[zk: localhost:2181(CONNECTED) 0] ls /services/dubbo_registry_zookeeper_server
+[30.221.147.198:20000]
+```
+
+### Run client
+```shell
+$ go run ./go-client/cmd/client.go
+hello world
+```
+
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/traffic/_index.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/traffic/_index.md
new file mode 100755
index 000000000000..7556e4519c4d
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/traffic/_index.md
@@ -0,0 +1,9 @@
+---
+aliases:
+ - /zh/docs3-v2/golang-sdk/tutorial/debugging/
+ - /zh-cn/docs3-v2/golang-sdk/tutorial/debugging/
+description: "通过下发路由规则实现流量管控，包括按比例流量转发、参数路由、灰度发布、动态调整超时时间等。"
+title: 流量管控
+type: docs
+weight: 60
+---
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/traffic/router.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/traffic/router.md
new file mode 100644
index 000000000000..31b2e5b3190f
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/traffic/router.md
@@ -0,0 +1,11 @@
+---
+aliases:
+ - /zh/docs3-v2/golang-sdk/tutorial/governance/traffic/mesh_router/
+ - /zh-cn/docs3-v2/golang-sdk/tutorial/governance/traffic/mesh_router/
+ - /zh-cn/overview/mannual/golang-sdk/tutorial/governance/traffic/mesh_router/
+description: 路由规则
+title: 路由规则
+type: docs
+weight: 1
+---
+
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/traffic/sentinel.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/traffic/sentinel.md
new file mode 100644
index 000000000000..852b183f0ef5
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/traffic/sentinel.md
@@ -0,0 +1,35 @@
+---
+description: "基于 Sentinel 的流量"
+title: Sentinel限流降级
+type: docs
+weight: 3
+---
+
+Dubbo-go 中提供了内置的限流组件，用户可根据自己的业务场景调整限流值、限流后的行为等，具体可 [TpsLimiter](https://github.com/apache/dubbo-go/blob/main/filter/tps_limiter.go#L52) 定义与具体实现。用户可通过类似以下方式在服务端设置简单的限流策略：
+
+```go
+server.WithTpsLimiter("method-service") // 目前支持 method-service、polaris 等几个实现
+server.WithTpsLimiterXxx() // 设置限流相关阈值，请根据具体方法填写
+//tps.limit.strategy: "slidingWindow"
+//tps.limit.rejected.handler: "default"
+//tps.limit.interval: 1000
+//tps.limit.rate: 3
+```
+
+Dubbo-go 内置限流策略相对简单，对于一些更复杂的场景，我们建议通过使用 Sentinel 等专业的第三方框架可以实现更丰富、更灵活的限流策略。
+
+可在此查看 [本示例完整源码](https://github.com/apache/dubbo-go-samples/tree/main/filter/sentinel)，也可以参考 [Dubbo+Sentinel 的 Java 示例](/zh-cn/overview/mannual/java-sdk/tasks/rate-limit/sentinel/) 获得更多灵感。
+
+## Provider 限流
+
+### 基于 QpS 限流
+
+### 基于并发任务数限流(当前在运行任务数)
+
+## Consumer 限流
+
+### 熔断策略
+
+
+
+### 基于并发请求数限流(未收到响应的请求数)
\ No newline at end of file
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/transaction/_index.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/transaction/_index.md
new file mode 100755
index 000000000000..618f9655b669
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/transaction/_index.md
@@ -0,0 +1,7 @@
+---
+description: "Dubbo 分布式事务解决方案。"
+title: 分布式事务
+type: docs
+weight: 62
+---
+
diff --git a/content/zh-cn/overview/mannual/golang-sdk/tutorial/transaction/seata.md b/content/zh-cn/overview/mannual/golang-sdk/tutorial/transaction/seata.md
new file mode 100644
index 000000000000..63fb1bfc8792
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/tutorial/transaction/seata.md
@@ -0,0 +1,18 @@
+---
+description: "使用 Seata 分布式事务解决方案解决 Dubbo 数据一致性问题。"
+title: Seata分布式事务
+type: docs
+weight: 1
+---
+
+1. 先执行以下命令，启动 seata-server。
+
+ ```shell
+ cd ../dockercompose
+ docker-compose -f docker-compose.yml up -d seata-server
+ ```
+
+2. 再执行 triple/client/cmd 和 triple/server/cmd 目录下的 main()方法。
+
+
+完整示例源码地址
\ No newline at end of file
diff --git a/content/zh-cn/overview/mannual/golang-sdk/versions.md b/content/zh-cn/overview/mannual/golang-sdk/versions.md
new file mode 100644
index 000000000000..e5e5c394f6bd
--- /dev/null
+++ b/content/zh-cn/overview/mannual/golang-sdk/versions.md
@@ -0,0 +1,41 @@
+---
+aliases:
+ - /zh/docs3-v2/golang-sdk/refer/compatible_version/
+ - /zh-cn/docs3-v2/golang-sdk/refer/compatible_version/
+ - /zh-cn/overview/mannual/golang-sdk/preface/refer/compatible_version/
+description: 依赖适配版本号
+title: 版本信息
+type: docs
+weight: 1
+---
+
+## 推荐版本
+当前网站文档适用于以下版本，如果您正使用 dubbo-go 其他版本，请参考对应历史版本文档。
+
+| Go | Dubbo-go | protoc-gen-go-triple | 说明 |
+| :--: | ------------ | -------------------- | -------------------- |
+| 1.20 | v3.2.0-rc1（当前文档） | v3.0.0 | 当前最新稳定版本，推荐使用 |
+
+## 历史版本
+
+### 3.x
+查看 3.1.x 及之前版本文档：
+
+| Go | Dubbo-go | protoc-gen-go-triple | 说明 |
+| :--: | ------------ | -------------------- | -------------------- |
+| 1.16 | v3.1.1 | v3.0.0 | 请参考 README 说明，了解如何生成老版本兼容的服务 stub 代码 |
+| 1.16 | v3.1.0 | v3.0.0 | 请参考 README 说明，了解如何生成老版本兼容的服务 stub 代码 |
+| 1.16 | v3.0.4 | v3.0.0 | 请参考 README 说明，了解如何生成老版本兼容的服务 stub 代码 |
+| 1.16 | v3.0.3 | v3.0.0 | 请参考 README 说明，了解如何生成老版本兼容的服务 stub 代码 |
+| 1.16 | v3.0.2 | v3.0.0 | 请参考 README 说明，了解如何生成老版本兼容的服务 stub 代码 |
+| 1.16 | v3.0.1 | v3.0.0 | 请参考 README 说明，了解如何生成老版本兼容的服务 stub 代码 |
+| 1.16 | v3.0.0 | v1.0.5 | |
+| 1.16 | v3.0.0-rc4-1 | v1.0.2 | |
+| 1.16 | v3.0.0-rc3 | v1.0.0 | |
+
+### 1.x
+
+| Go | Dubbo-go | Triple | protoc-gen-go-triple | 说明 |
+| :--: | ------------ | ------ | -------------------- | -------------------- |
+| | v1.5.0 | v1.1.8 | v1.0.8 | 停止维护，请升级到最新 3.x 版本 |
+
diff --git a/content/zh-cn/overview/mannual/java-sdk/_index.md b/content/zh-cn/overview/mannual/java-sdk/_index.md
index 3d8c8d8b90a4..a2b522b0789d 100755
--- a/content/zh-cn/overview/mannual/java-sdk/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/_index.md
@@ -5,7 +5,7 @@ aliases:
content:
- 快速开始:
- description: 快速体验 Dubbo Java 微服务开发
- name: '[Spring Boot 快速开发 Dubbo 服务](quick-start/spring-boot/)'
+ name: '[Spring Boot 快速开发 Dubbo 服务](quick-start/starter/)'
- description: 配置参考手册
name: '[配置参考手册](reference-manual/config/)'
- 高级特性:
@@ -15,8 +15,8 @@ content:
- description: 注册中心配置指南
name: '[注册中心配置指南](reference-manual/registry/)'
- 升级与兼容性:
- - description: 3.0 迁移指南
- name: '[3.0 迁移指南](upgrades-and-compatibility/)'
+ - description: 版本迁移指南
+ name: '[版本迁移指南](reference-manual/upgrades-and-compatibility/)'
- 历史版本文档:
- description: 历史版本文档
name: '[2.x 及早期版本文档](/zh-cn/docsv2.7/)'
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/_index.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/_index.md
deleted file mode 100755
index b8cb090f2cd9..000000000000
--- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/_index.md
+++ /dev/null
@@ -1,14 +0,0 @@
----
-aliases:
- - /zh/docs3-v2/java-sdk/advanced-features-and-usage/
- - /zh-cn/docs3-v2/java-sdk/advanced-features-and-usage/
-description: 以下是 Dubbo 支持的所有功能列表，在此页面直接浏览或通过左侧菜单分类查看。
-hide_summary: true
-linkTitle: 高级特性和用法
-no_list: true
-title: 高级特性和用法
-type: docs
-weight: 3
----
-
-{{% docs/section_list %}}
\ No newline at end of file
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/_index.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/_index.md
deleted file mode 100755
index 39655bf053d4..000000000000
--- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/_index.md
+++ /dev/null
@@ -1,26 +0,0 @@
----
-aliases:
- - /zh/docs3-v2/java-sdk/advanced-features-and-usage/observability/
- - /zh-cn/docs3-v2/java-sdk/advanced-features-and-usage/observability/
-description: 可观测性
-linkTitle: 可观测性
-title: 可观测性
-type: docs
-weight: 2
----
-
-
-
-
-
-
-## 什么是可观测性
-可观测性是从外部观察正在运行的系统的内部状态的能力。它由日志记录、指标和跟踪三大支柱组成。
-
-## Dubbo 可观测性
-为了深入观察Dubbo内部的运行状况，Dubbo可观测性包括许多附加功能，帮助您在将应用程序推向生产时监视和管理应用程序。您可以选择使用HTTP端点或JMX来管理和监视应用程序。审计、运行状况和度量收集也可以自动应用于应用程序。
-
-## Dubbo Java 可观测性实现
-- [如何开启指标采集](./meter/)
-- [如何开启链路追踪](./tracing/)
-- [日志管理](./logging/)
\ No newline at end of file
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/logging.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/logging.md
deleted file mode 100644
index a8aa882545da..000000000000
--- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/logging.md
+++ /dev/null
@@ -1,172 +0,0 @@
----
-aliases:
- - /zh/docs3-v2/java-sdk/advanced-features-and-usage/observability/logging/
- - /zh-cn/docs3-v2/java-sdk/advanced-features-and-usage/observability/logging/
-description: 日志管理
-hide_summary: true
-linkTitle: 日志管理
-no_list: true
-title: 日志管理
-type: docs
-weight: 3
----
-
-在 Dubbo 框架内所有的日志输出都是通过 LoggerFactory 这个静态工厂类来获得 Logger 的对象实体，并且抽离了一个 LoggerAdapter 用于对接第三方日志框架，所以就有了JDKLoggerAdapter, Log4jLoggerAdapter, SLF4JLoggerAdapter等一些实现子类，分别对接了不同 Log 第三方实现。既然 Dubbo 能够支持这么多log实现，那么这些实现在 Dubbo 中优先级是在呢么样的呢？这里的优先级是指未配置指定的 logger 提供方的情况下，由 Dubbo 框架自己选择。优先级如下：
-
-| 第三方日志框架 | 优先级 |
-| ------------------------------------- | ------------------------------------------ |
-| Log4j | 最高（默认就用这个） |
-| SLF4J | 次高（上面没有采用这个） |
-| Common Logging(jcl就是common logging) | 次低（Log4j和SLF4J在项目中均没有就用这个） |
-| JDK log | 最低（最后的选择） |
-
-Dubbo 日志的调用方式，针对不同的日志打印系统，采用统一的 API 调用及输出，如：
-
-```java
-/**
- * ChannelListenerDispatcher
- */
-public class ChannelHandlerDispatcher implements ChannelHandler {
-
- private static final ErrorTypeAwareLogger logger = LoggerFactory.getErrorTypeAwareLogger(ChannelHandlerDispatcher.class);
-```
-
-Dubbo 采用的日志输出方式是首先从 dubbo.application.logger 系统变量中获取属性值，来判断到底采用哪种日志输出方式，如果没设置则按照默认的加载顺序加载相应的日志输出类，直到成功加载：
-
-顺序为：log4jLogger > slf4jLogger > JclLogger > JdkLogger
-
-LoggerFactory 在类加载过程中变量的初始化过程：
-
-```java
-// search common-used logging frameworks
-static {
- String logger = System.getProperty("dubbo.application.logger", "");
- switch (logger) {
- case Slf4jLoggerAdapter.NAME:
- setLoggerAdapter(new Slf4jLoggerAdapter());
- break;
- case JclLoggerAdapter.NAME:
- setLoggerAdapter(new JclLoggerAdapter());
- break;
- case Log4jLoggerAdapter.NAME:
- setLoggerAdapter(new Log4jLoggerAdapter());
- break;
- case JdkLoggerAdapter.NAME:
- setLoggerAdapter(new JdkLoggerAdapter());
- break;
- case Log4j2LoggerAdapter.NAME:
- setLoggerAdapter(new Log4j2LoggerAdapter());
- break;
- default:
- List
-
-### **第六步**
-
-更改 server 中的 application.yml
-
-```yaml
-server:
- port: 7091
-
-spring:
- application:
- name: seata-server
-
-logging:
- config: classpath:logback-spring.xml
- file:
- path: ${user.home}/logs/seata
-
-console:
- user:
- username: seata
- password: seata
-
-seata:
- config:
- # support: nacos, consul, apollo, zk, etcd3
- type: nacos
- nacos:
- server-addr: 127.0.0.1:8848
- #namespace: 如果配置创建在非默认namespace,请在此处填写namespace的id
- group: SEATA_GROUP
- username:
- password:
- ##if use MSE Nacos with auth, mutex with username/password attribute
- #access-key: ""
- #secret-key: ""
- data-id: seata.properties
- registry:
- # support: nacos, eureka, redis, zk, consul, etcd3, sofa
- type: nacos
- nacos:
- application: seata-server
- server-addr: 127.0.0.1:8848
- group: SEATA_GROUP
- namespace:
- cluster: default
- #namespace: 如果配置创建在非默认namespace,请在此处填写namespace的id
- password:
- ##if use MSE Nacos with auth, mutex with username/password attribute
- #access-key: ""
- #secret-key: ""
-# server:
-# service-port: 8091 #If not configured, the default is '${server.port} + 1000'
- security:
- secretKey: SeataSecretKey0c382ef121d778043159209298fd40bf3850a017
- tokenValidityInMilliseconds: 1800000
- ignore:
- urls: /,/**/*.css,/**/*.js,/**/*.html,/**/*.map,/**/*.svg,/**/*.png,/**/*.ico,/console-fe/public/**,/api/v1/auth/login
-```
-
-### **第七步**
-
-在全局事务调用者(发起全局事务的服务)的接口上加入 @GlobalTransactional 示例如下:
-
-```java
-@GetMapping(value = "testCommit")
-@GlobalTransactional
-public Object testCommit(@RequestParam(name = "id",defaultValue = "1") Integer id,
- @RequestParam(name = "sum", defaultValue = "1") Integer sum) {
- Boolean ok = productService.reduceStock(id, sum);
- if (ok) {
- LocalDateTime now = LocalDateTime.now();
- Orders orders = new Orders();
- orders.setCreateTime(now);
- orders.setProductId(id);
- orders.setReplaceTime(now);
- orders.setSum(sum);
- orderService.save(orders);
- return "ok";
- } else {
- return "fail";
- }
-}
-```
-
-spring 应用在使用 AT 或 XA 模式下需手动代理数据源选择事务模式和初始化事务扫描器
-
-```java
-@Primary
-@Bean("dataSource")
-public DataSource dataSource(DataSource druidDataSource) {
- //AT 代理 二选一
- return new DataSourceProxy(druidDataSource);
- //XA 代理
- return new DataSourceProxyXA(druidDataSource)
-}
-```
-
-```java
- @Bean
- public GlobalTransactionScanner globalTransactionScanner() {
- return new GlobalTransactionScanner("应用名", "my_test_tx_group");
- }
-```
-
-如果使用 tcc 模式,需要额外在对应的 provider 的 serviceimpl 中定义两阶段的 try 和 confirm(commit) cancel(rollback)
-
-spring-boot 应用需关闭数据源代理
-
-```yaml
-seata:
- enable-auto-data-source-proxy: false
-```
-
-```java
-/**
- * 定义两阶段提交 name = 该tcc的bean名称,全局唯一 commitMethod = commit 为二阶段确认方法 rollbackMethod = rollback 为二阶段取消方法
- * useTCCFence=true 为开启防悬挂
- * BusinessActionContextParameter注解 传递参数到二阶段中
- *
- * @param params -入参
- * @return String
- */
-@TwoPhaseBusinessAction(name = "beanName", commitMethod = "commit", rollbackMethod = "rollback", useTCCFence = true)
-public void insert(@BusinessActionContextParameter(paramName = "params") Map- * Sends greeting by stream - *- */ - StreamObserver
\ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/16.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/16.md deleted file mode 100644 index 6e32a1051786..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/16.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/16/ - - /zh-cn/docs3-v2/java-sdk/faq/0/16/ -description: 0-16 - 没有可用的执行器 -linkTitle: 0-16 - 没有可用的执行器 -title: 0-16 - 没有可用的执行器 -type: docs -weight: 16 ---- - - - - - - - -### 可能的原因 - -内部执行器不可用，此时返回空。 - -### 排查和解决步骤 - -不需要进行干预，dubbo 内部会执行`createExecutorIfAbsent` 方法构建一个新的执行器。 - -
\ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/17.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/17.md deleted file mode 100644 index bf0d2de7924a..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/17.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/17/ - - /zh-cn/docs3-v2/java-sdk/faq/0/17/ -description: 0-17 - 执行器在关闭时发生未知异常 -linkTitle: 0-17 - 执行器在关闭时发生未知异常 -title: 0-17 - 执行器在关闭时发生未知异常 -type: docs -weight: 17 ---- - - - - - - - -### 可能的原因 - -可能使用了自定义的执行器，在编写销毁方法时，产生了异常。 - -### 排查和解决步骤 - -检查是否自定义实现 `org.apache.dubbo.common.threadpool.manager.ExecutorRepository`,检查自定义的 `shutdown` 方法。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/18.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/18.md deleted file mode 100644 index 6bf762c6d78d..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/18.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/18/ - - /zh-cn/docs3-v2/java-sdk/faq/0/18/ -description: 0-18 - 线程池执行器被错误使用 -linkTitle: 0-18 - 线程池执行器被错误使用 -title: 0-18 - 线程池执行器被错误使用 -type: docs -weight: 18 ---- - - - - - - - -### 可能的原因 - -自定义设置了线程数量，系统内部发生了未知异常。 - -### 排查和解决步骤 - -可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/19.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/19.md deleted file mode 100644 index 00ea8670fd9d..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/19.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/19/ - - /zh-cn/docs3-v2/java-sdk/faq/0/19/ -description: 0-19 - 处理任务时发生异常 -linkTitle: 0-19 - 处理任务时发生异常 -title: 0-19 - 处理任务时发生异常 -type: docs -weight: 19 ---- - - - - - - - -### 可能的原因 - -自定义业务类处理逻辑不当。 - -### 排查和解决步骤 - -可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/2.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/2.md deleted file mode 100644 index 8ebd9377dfeb..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/2.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/2/ - - /zh-cn/docs3-v2/java-sdk/faq/0/2/ -description: 0-2 - 非法属性值 -linkTitle: 0-2 - 非法属性值 -title: 0-2 - 非法属性值 -type: docs -weight: 2 ---- - - - - - - -### 可能的原因 -这个提示是指用户配置的值与属性本身所需的数据类型并不匹配。比如 `dubbo.comsumer.threads` 属性只能接受数值属性，但是用户所输入的值混入了字母。 - -### 排查和解决步骤 -根据[配置项参考手册](../../../reference-manual/config/properties)，查找出错的配置项，检查该项指定的类型，检查是否出现类型不一致的情况。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/20.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/20.md deleted file mode 100644 index c5a04f39f9e7..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/20.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/20/ - - /zh-cn/docs3-v2/java-sdk/faq/0/20/ -description: 0-20 - 存储堆栈信息时发生异常 -linkTitle: 0-20 - 存储堆栈信息时发生异常 -title: 0-20 - 存储堆栈信息时发生异常 -type: docs -weight: 20 ---- - - - - - - - -### 可能的原因 - -1. JVM设置了参数 `-XX:+DisableAttachMechanism` -2. 设置了系统不存在的堆栈转储路径，不存在情况，系统会尝试进行创建，创建时发生了 `SecurityException`, 可能是没有权限。 - -### 排查和解决步骤 - -1. 检查 JVM 是否设置了如上参数。 -2. 检查当前启动服务的账号，是否有权限进行创建文件夹。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/21.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/21.md deleted file mode 100644 index e898b669f030..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/21.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/21/ - - /zh-cn/docs3-v2/java-sdk/faq/0/21/ -description: 0-21 - 构建的实例过多 -linkTitle: 0-21 - 构建的实例过多 -title: 0-21 - 构建的实例过多 -type: docs -weight: 21 ---- - - - - - - -### 可能的原因 - -一般指 `org.apache.dubbo.common.timer.HashedWheelTimer` 创建的实例过多。 - -### 排查和解决步骤 - -不影响实例的构建，可能存在内存泄露的风险。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/22.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/22.md deleted file mode 100644 index c7c0b1072755..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/22.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/22/ - - /zh-cn/docs3-v2/java-sdk/faq/0/22/ -description: 0-22 - 输入输出流异常 -linkTitle: 0-22 - 输入输出流异常 -title: 0-22 - 输入输出流异常 -type: docs -weight: 22 ---- - - - - - - - -### 可能的原因 - -1. 读取不再可用的本地文件。 -2. 尝试读取/写入文件但没有权限。 -3. 尝试写入文件但磁盘空间不再可用。 - -### 排查和解决步骤 - -1. 检查本地文件是否存在。 -2. 检查文件权限。 -3. 检查磁盘空间。 - -可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/23.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/23.md deleted file mode 100644 index 4fe2df873131..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/23.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/23/ - - /zh-cn/docs3-v2/java-sdk/faq/0/23/ -description: 0-23 - 序列化数据转换异常 -linkTitle: 0-23 - 序列化数据转换异常 -title: 0-23 - 序列化数据转换异常 -type: docs -weight: 23 ---- - - - - - - - -### 可能的原因 - -1. 待序列化数据中存在循环引用，导致堆栈溢出。 -2. 引用的 jar 包版本低或存在兼容性问题。 - -### 排查和解决步骤 - -1. 如使用 FastJson，去掉 `SerializerFeature.DisableCircularReferenceDetec` -2. 检查下或升级版本进行尝试。 - -可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/24.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/24.md deleted file mode 100644 index d9a07e38a3ef..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/24.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/24/ - - /zh-cn/docs3-v2/java-sdk/faq/0/24/ -description: 0-24 - 覆盖字段值异常 -linkTitle: 0-24 - 覆盖字段值异常 -title: 0-24 - 覆盖字段值异常 -type: docs -weight: 24 ---- - - - - - - - -### 可能的原因 - -1. 实体类未设置 setter/getter 方法。 -2. 可能存在嵌套的属性。 - -### 排查和解决步骤 - -1. 检查实体类并设置 setter/getter 方法。 -2. 根据堆栈信息，检查是否使用嵌套注解。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/25.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/25.md deleted file mode 100644 index 4641d3b24980..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/25.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/25/ - - /zh-cn/docs3-v2/java-sdk/faq/0/25/ -description: 0-25 - 加载映射错误 -linkTitle: 0-25 - 加载映射错误 -title: 0-25 - 加载映射错误 -type: docs -weight: 25 ---- - - - - - - - -### 可能的原因 - -文件访问权限不足 - -### 排查和解决步骤 - -检查文件权限。 -可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/26.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/26.md deleted file mode 100644 index 4f6c42d0e955..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/26.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/26/ - - /zh-cn/docs3-v2/java-sdk/faq/0/26/ -description: 0-26 - 元数据发布服务时的警告信息 -linkTitle: 0-26 - 元数据发布服务时的警告信息 -title: 0-26 - 元数据发布服务时的警告信息 -type: docs -weight: 26 ---- - - - - - - -### 可能的原因 - -元数据在存储接口与应用的映射关系时，显示的提醒类消息。 - -### 排查和解决步骤 - -一般可根据堆栈信息进行分析，也可不处理。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/27.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/27.md deleted file mode 100644 index c59ece4d3da5..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/27.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/27/ - - /zh-cn/docs3-v2/java-sdk/faq/0/27/ -description: 0-27 - 线程池隔离配置异常 -linkTitle: 0-27 - 线程池隔离配置异常 -title: 0-27 - 线程池隔离配置异常 -type: docs -weight: 27 ---- - - - - - - -### 可能的原因 - -未开启应用的线程池隔离能力，但是却在 `ServiceConfig` 中配置了隔离的线程池信息。 - -### 排查和解决步骤 - -配置开启应用的线程池隔离能力：`dubbo.application.executor-management-mode=isolation` \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/28.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/28.md deleted file mode 100644 index ba2076233c99..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/28.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/28/ - - /zh-cn/docs3-v2/java-sdk/faq/0/28/ -description: 0-28 - 操作了可能会引起危险的行为 -linkTitle: 0-28 - 危险的行为 -title: 0-28 - 操作了可能会引起危险的行为 -type: docs -weight: 28 ---- - - - - - - -### 可能的原因 - -你执行了以下操作之一： -* 尝试或已经调整了 accesslog 的输出位置 - -### 排查和解决步骤 - -请检查应用配置中的 `accesslog.fixed.path=true` 开关是否处于开启状态，如未开启则可忽略；如果当前是开启状态，则请确认是否 acesslog 路径切换的行为是否为可信任的人所执行，以避免可能的安全风险。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/0/29.md b/content/zh-cn/overview/mannual/java-sdk/faq/0/29.md deleted file mode 100644 index 6fcf5d8c1e82..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/0/29.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/0/29/ - - /zh-cn/docs3-v2/java-sdk/faq/0/29/ -description: 0-29 - 未找到Tracer依赖 -linkTitle: 0-29 - 未找到Tracer依赖 -title: 0-29 - 未找到Tracer依赖 -type: docs -weight: 29 ---- - -### 可能的原因 - -你已在配置文件中开启了tracing，但未找到Tracer依赖。 - -目前Tracer支持两种，OpenTelemetry和Brave。 - -### 排查和解决步骤 - -选择一个Tracer依赖到你的项目中： - -```xml - -
| dubbo.mapping.cache.entrySize | -dubbo.meta.cache.entrySize | -
| 10000 | -100 | -
\ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/36.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/36.md deleted file mode 100644 index 392698b9e375..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/36.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/36/ - - /zh-cn/docs3-v2/java-sdk/faq/5/36/ -description: 5-36 - 过滤器校验时发生错误 -linkTitle: 5-36 - 过滤器校验时发生错误 -title: 5-36 - 过滤器校验时发生错误 -type: docs -weight: 36 ---- - - - - - - -### 可能的原因 - -自定义过滤器扩展类中重写的 `invoke` 方法，发生业务代码异常。 - -### 排查和解决步骤 -1. 使用 ps -eaf |grep <错误服务> -2. 可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/37.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/37.md deleted file mode 100644 index 5eafb4aea10f..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/37.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/37/ - - /zh-cn/docs3-v2/java-sdk/faq/5/37/ -description: 5-37 - 动态配置监听处理发生错误 -linkTitle: 5-37 - 动态配置监听处理发生错误 -title: 5-37 - 动态配置监听处理发生错误 -type: docs -weight: 37 ---- - - - - - -文件发生变化时，监听事件处理失败 - -### 可能的原因 - -文件权限发生变化或目录权限发生变化。 - -### 排查和解决步骤 - -可根据控制台的堆栈信息，进行代码定位。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/38.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/38.md deleted file mode 100644 index de9b02550952..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/38.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/38/ - - /zh-cn/docs3-v2/java-sdk/faq/5/38/ -description: 5-38 - 配置参数未定义 -linkTitle: 5-38 - 配置参数未定义 -title: 5-38 - 配置参数未定义 -type: docs -weight: 38 ---- - - - - - - -### 可能的原因 - -配置参数未定义 - -### 排查和解决步骤 - -多为测试用例中使用，可根据提示明细，进行参数的设置。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/39.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/39.md deleted file mode 100644 index 63563556664e..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/39.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/39/ - - /zh-cn/docs3-v2/java-sdk/faq/5/39/ -description: 5-39 - Dubbo配置bean初始化器发生错误 -linkTitle: 5-39 - Dubbo配置bean初始化器发生错误 -title: 5-39 - Dubbo配置bean初始化器发生错误 -type: docs -weight: 39 ---- - - - - - - -### 可能的原因 - -源代码或被修改 - -### 排查和解决步骤 - -检查业务代码未对核心类进行源码修改或加载的顺序修改。 -如：`org.apache.dubbo.config.spring.context.DubboConfigBeanInitializer` \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/4.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/4.md deleted file mode 100644 index b3e90dd23cae..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/4.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/4/ - - /zh-cn/docs3-v2/java-sdk/faq/5/4/ -description: 5-4 - 服务接口中找不到方法 -linkTitle: 5-4 - 服务接口中找不到方法 -title: 5-4 - 服务接口中找不到方法 -type: docs -weight: 4 ---- - - - - - - -### 可能的原因 - -1. 消费端调用的接口名#方法不存在。 -2. 服务端未正确的暴露当前接口。 - -### 排查和解决步骤 - -1. 检查消费端调用的接口名#方法是否存在。 -2. 检查服务端暴露的服务列表内是否存在。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/40.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/40.md deleted file mode 100644 index 5bb8bfa6c8fd..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/40.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/40/ - - /zh-cn/docs3-v2/java-sdk/faq/5/40/ -description: 5-40 - Dubbo配置bean未找到 -linkTitle: 5-40 - Dubbo配置bean未找到 -title: 5-40 - Dubbo配置bean未找到 -type: docs -weight: 40 ---- - - - - - - -### 可能的原因 - -源代码或被修改 - -### 排查和解决步骤 - -检查业务代码未对核心类进行源码修改或加载的顺序修改。 -如：`org.apache.dubbo.config.spring.context.DubboConfigBeanInitializer` \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/41.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/41.md deleted file mode 100644 index dfd2dd826133..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/41.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/41/ - - /zh-cn/docs3-v2/java-sdk/faq/5/41/ -description: 5-41 - SSL证书读取失败 -linkTitle: 5-41 - SSL证书读取失败 -title: 5-41 - SSL证书读取失败 -type: docs -weight: 41 ---- - - - - - - -### 可能的原因 - -SSL 证书配置异常 - -### 排查和解决步骤 - -检查 SSL 证书的配置，查看对应文件是否存在 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/42.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/42.md deleted file mode 100644 index 1ae4e75fd16b..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/42.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/42/ - - /zh-cn/docs3-v2/java-sdk/faq/5/42/ -description: 5-42 - Dubbo 证书签发失败 -linkTitle: 5-42 - Dubbo 证书签发失败 -title: 5-42 - Dubbo 证书签发失败 -type: docs -weight: 42 ---- - - - - - - -### 可能的原因 - -Dubbo 请求远程 CA 签发证书失败 - -### 排查和解决步骤 - -- 检查 CA 连接配置 -- 检查 CA 运行状态 -- 检查 CA 日志 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/43.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/43.md deleted file mode 100644 index 6cab512292e1..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/43.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/43/ - - /zh-cn/docs3-v2/java-sdk/faq/5/43/ -description: 5-43 - Dubbo 证书签发连接不安全 -linkTitle: 5-43 - Dubbo 证书签发连接不安全 -title: 5-43 - Dubbo 证书签发连接不安全 -type: docs -weight: 43 ---- - - - - - - -### 可能的原因 - -Dubbo 与远程 CA 的连接不安全 - -### 排查和解决步骤 - -- 检查 Dubbo 进程是否已经正确配置了 CA 证书信息以及 OIDC（OpenID Connect）的 Token 获取方式 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/5.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/5.md deleted file mode 100644 index 2f48fa867b8a..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/5.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/5/ - - /zh-cn/docs3-v2/java-sdk/faq/5/5/ -description: 5-5 - 无法获得env变量 -linkTitle: 5-5 - 无法获得env变量 -title: 5-5 - 无法获得env变量 -type: docs -weight: 5 ---- - - - - - - -### 可能的原因 - -环境变量无法获取。 - -### 排查和解决步骤 - -检查提示的变量名，是否配置并可以正常读取加载。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/6.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/6.md deleted file mode 100644 index 1218b22d9a23..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/6.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/6/ - - /zh-cn/docs3-v2/java-sdk/faq/5/6/ -description: 5-6 - 接口类型的属性冲突 -linkTitle: 5-6 - 接口类型的属性冲突 -title: 5-6 - 接口类型的属性冲突 -type: docs -weight: 6 ---- - - - - - - -### 可能的原因 - -泛化定义配置不正确。 - -### 排查和解决步骤 - -检查泛化定义是否正确。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/7.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/7.md deleted file mode 100644 index 6f91dab68b62..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/7.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/7/ - - /zh-cn/docs3-v2/java-sdk/faq/5/7/ -description: 5-7 - 取消导出时发生意外错误 -linkTitle: 5-7 - 取消导出时发生意外错误 -title: 5-7 - 取消导出时发生意外错误 -type: docs -weight: 7 ---- - - - - - - -### 可能的原因 - -1. 配置中心的服务无法连接。 -2. 配置的协议、IP、端口不正确。 -3. 使用配置中心客户端版本与服务端版本冲突，无法建立有效连接。 - -### 排查和解决步骤 - -1. 检查配置中心的服务状态是否正常。 -2. 检查配置的协议、IP、端口不正确。 -3. 检查使用的配置中心客户端版本与服务端版本是否兼容。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/8.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/8.md deleted file mode 100644 index 06de1d49f1fd..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/8.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/8/ - - /zh-cn/docs3-v2/java-sdk/faq/5/8/ -description: 5-8 - 协议将使用随机可用端口 -linkTitle: 5-8 - 协议将使用随机可用端口 -title: 5-8 - 协议将使用随机可用端口 -type: docs -weight: 8 ---- - - - - - - -### 可能的原因 - -协议指定的端口被占用，随机选择端口进行启动。 - -### 排查和解决步骤 - -检查当前配置端口是否被其它应用程序占用。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/9.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/9.md deleted file mode 100644 index 43c2fb69ea7c..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/9.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/9/ - - /zh-cn/docs3-v2/java-sdk/faq/5/9/ -description: 5-9 - 服务配置导出失败 -linkTitle: 5-9 - 服务配置导出失败 -title: 5-9 - 服务配置导出失败 -type: docs -weight: 9 ---- - - - - - - -### 可能的原因 - -1. 配置中心的服务无法连接。 -2. 配置的协议、IP、端口不正确。 -3. 使用配置中心客户端版本与服务端版本冲突，无法建立有效连接。 - -### 排查和解决步骤 - -1. 检查配置中心的服务状态是否正常。 -2. 检查配置的协议、IP、端口不正确。 -3. 检查使用的配置中心客户端版本与服务端版本是否兼容。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/5/_index.md b/content/zh-cn/overview/mannual/java-sdk/faq/5/_index.md deleted file mode 100644 index 0cbeaaa4eaf6..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/5/_index.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/5/ - - /zh-cn/docs3-v2/java-sdk/faq/5/ -description: 5 - 配置（中心）层 -linkTitle: 5 - 配置（中心）层 -title: 5 - 配置（中心）层 -type: docs -weight: 5 ---- diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/1.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/1.md deleted file mode 100644 index a5e20d76faf9..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/1.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/1/ - - /zh-cn/docs3-v2/java-sdk/faq/6/1/ -description: 6-1 - 服务端连接失败 -linkTitle: 6-1 - 服务端连接失败 -title: 6-1 - 服务端连接失败 -type: docs -weight: 1 ---- - - - - - -网络通信层，在连接服务提供者服务时失败 - -### 可能的原因 - -服务提供者的网络异常断开或受防火墙及第三方工具的拦截，无法对外提供服务。 - -### 排查和解决步骤 - -1. 如果为 rest 连接，检查请求的服务端配置是否正确。 -2. 检查网络通信是否正常，可使用一些简单的 cmd 命令进行检测，如 `ping` 等。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/10.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/10.md deleted file mode 100644 index cd8014ecee82..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/10.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/10/ - - /zh-cn/docs3-v2/java-sdk/faq/6/10/ -description: 6-10 - 超过有效载荷限制异常 -linkTitle: 6-10 - 超过有效载荷限制异常 -title: 6-10 - 超过有效载荷限制异常 -type: docs -weight: 10 ---- - - - - - - -### 可能的原因 - -> 默认 `payload=8M`,请检查各项配置 - -### 排查和解决步骤 - -各组件支持的具体配置项及含义请参考 [配置项手册](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/11.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/11.md deleted file mode 100644 index 05a27d4d079f..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/11.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/11/ - - /zh-cn/docs3-v2/java-sdk/faq/6/11/ -description: 6-11 - 字符集不被支持 -linkTitle: 6-11 - 字符集不被支持 -title: 6-11 - 字符集不被支持 -type: docs -weight: 11 ---- - - - - - - -## 可能的原因 - -> 默认 `UTF-8` 字符集 - -## 排查和解决步骤 - -结果会最终以 `UTF-8` 字符集进行处理。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/12.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/12.md deleted file mode 100644 index 1c8744c76166..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/12.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/12/ - - /zh-cn/docs3-v2/java-sdk/faq/6/12/ -description: 6-12 - ZK客户端销毁时发生错误 -linkTitle: 6-12 - ZK客户端销毁时发生错误 -title: 6-12 - ZK客户端销毁时发生错误 -type: docs -weight: 12 ---- - - - - - - - -### 可能的原因 - -客户端与服务端连接已被拒绝 -客户端在销毁时，可能服务端正在进行选举或者其他操作，导致发生的异常。 - -### 排查和解决步骤 - -关闭方法，可针对堆栈信息进行查询。一般可不处理。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/13.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/13.md deleted file mode 100644 index 1771fd395f1b..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/13.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/13/ - - /zh-cn/docs3-v2/java-sdk/faq/6/13/ -description: 6-13 - 流关闭异常 -linkTitle: 6-13 - 流关闭异常 -title: 6-13 - 流关闭异常 -type: docs -weight: 13 ---- - - - - - - - -### 可能的原因 - -当前流已关闭 `Stream is closed` 或流关闭时，其他线程正在读取。 - -### 排查和解决步骤 - -一般为代码关闭流的顺序上发生了颠倒。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/14.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/14.md deleted file mode 100644 index f33f8c488035..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/14.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/14/ - - /zh-cn/docs3-v2/java-sdk/faq/6/14/ -description: 6-14 - 服务端响应失败 -linkTitle: 6-14 - 服务端响应失败 -title: 6-14 - 服务端响应失败 -type: docs -weight: 14 ---- - - - - - - -### 可能的原因 - -在服务端与客户端交互发生数据时，客户端异常关闭。 - -### 排查和解决步骤 - -客户端异常终止或服务器宕机。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/15.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/15.md deleted file mode 100644 index 2a5d0e531fa6..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/15.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/15/ - - /zh-cn/docs3-v2/java-sdk/faq/6/15/ -description: 6-15 - 跳过未读完的流数据 -linkTitle: 6-15 - 跳过未读完的流数据 -title: 6-15 - 跳过未读完的流数据 -type: docs -weight: 15 ---- - - - - - - -### 可能的原因 - -解码时，如流中还有未读数据时会跳过未读完的流 - -### 排查和解决步骤 - -解码时会把数据全部一次性读取 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/16.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/16.md deleted file mode 100644 index aa1abed1307e..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/16.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/16/ - - /zh-cn/docs3-v2/java-sdk/faq/6/16/ -description: 6-16 - 重连时发生异常 -linkTitle: 6-16 - 重连时发生异常 -title: 6-16 - 重连时发生异常 -type: docs -weight: 16 ---- - - - - - - -### 可能的原因 - -每次发生重连时提示，网络不稳定造成的延迟重连。 - -### 排查和解决步骤 - -检查是否有网络丢包情况。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/2.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/2.md deleted file mode 100644 index f939796c7bc6..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/2.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/2/ - - /zh-cn/docs3-v2/java-sdk/faq/6/2/ -description: 6-2 - 客户端超时 -linkTitle: 6-2 - 客户端超时 -title: 6-2 - 客户端超时 -type: docs -weight: 2 ---- - - - - - -超时是调用端发生在请求发出后，无法在指定的时间内获得对应的响应。 - -### 可能的原因 -1. 服务端确实处理比较慢，无法在指定的时间返回结果，调用端就自动返回一个超时的异常响应来结束此次调用。 -2. 服务端如果响应的比较快，但当客户端 Load 很高，负载压力很大的时候，会因为客户端请求发不出去、响应卡在 TCP Buffer 等问题，造成超时。因为客户端接收到服务端发来的数据或者请求服务端的数据，都会在系统层面排队，如果系统负载比较高，在内核态的时间占比就会加长，从而造成客户端获取到值时已经超时。 -3. 通常是业务处理太慢，可在服务提供方机器上执行：`jstack [PID] > jstack.log` 分析线程都卡在哪个方法调用上，这里就是慢的原因。如果不能调优性能，请调高 timeout 阈值。 - - -### 排查和解决步骤 - -1. 两边可能有 GC，检查服务端和客户端 GC 日志，耗时很长的 GC，会导致超时。超时的发生很可能意味着调用端或者服务端的资源（CPU，内存或者网络）出现了瓶颈，需要检查服务端的问题还是调用端的问题来排除 GC 抖动等嫌疑。 -2. 检查服务端的网络质量，比如重传率来排除网络嫌疑。 -3. 借助链路跟踪的分析服务（比如阿里的 [ARMS](https://help.aliyun.com/document_detail/63796.html) ，开源的 [OpenTracing](https://github.com/opentracing/opentracing-java) -系的实现 [Zipkin](https://github.com/openzipkin/zipkin) 、[SkyWalking](https://github.com/apache/skywalking) 等）来分析下各个点的耗时情况。 - - -> 这个错误码的 FAQ 页面参考了空冥同学的 [《Dubbo 常见错误及解决方法》](https://github.com/StabilityMan/StabilityGuide/blob/master/docs/diagnosis/plugin/rpc/%E7%B3%BB%E7%BB%9F%E7%A8%B3%E5%AE%9A%E6%80%A7%E2%80%94%E2%80%94Dubbo%E5%B8%B8%E8%A7%81%E9%94%99%E8%AF%AF%E5%8F%8A%E8%A7%A3%E5%86%B3%E6%96%B9%E6%B3%95.md) 。 -所引文章通过 [CC-BY-4.0](http://creativecommons.org/licenses/by/4.0/) 协议赋予了汇编的权利。在此向原作者表示感谢。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/3.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/3.md deleted file mode 100644 index 60730203dc2e..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/3.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/3/ - - /zh-cn/docs3-v2/java-sdk/faq/6/3/ -description: 6-3 - 网络连接关闭失败 -linkTitle: 6-3 - 网络连接关闭失败 -title: 6-3 - 网络连接关闭失败 -type: docs -weight: 3 ---- - - - - - - -### 可能的原因 - -非优雅关闭服务，此时服务端可能在对外输出流未完成。 - -### 排查和解决步骤 - -一般为提示类警告信息，不影响后续的程序执行。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/4.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/4.md deleted file mode 100644 index 01044b0fa057..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/4.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/4/ - - /zh-cn/docs3-v2/java-sdk/faq/6/4/ -description: 6-4 - 网络通讯层未知异常 -linkTitle: 6-4 - 网络通讯层未知异常 -title: 6-4 - 网络通讯层未知异常 -type: docs -weight: 4 ---- - - - - - - -### 可能的原因 -> 该错误码的意义已经调整。对于 Dubbo 3.1.4、3.2.0-beta.3 及其之前的版本的该错误码的出错，请参考错误码 [99-0](/zh-cn/overview/mannual/java-sdk/faq/99/0/)。 - -### 排查和解决步骤 -（该错误码目前空缺） \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/5.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/5.md deleted file mode 100644 index b207b5cf71db..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/5.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/5/ - - /zh-cn/docs3-v2/java-sdk/faq/6/5/ -description: 6-5 - 网络连接断开失败 -linkTitle: 6-5 - 网络连接断开失败 -title: 6-5 - 网络连接断开失败 -type: docs -weight: 5 ---- - - - - - - - -### 可能的原因 - -超时是调用端发生在请求发出后，无法在指定的时间内获得对应的响应，出现客户端主动断开连接 - -### 排查和解决步骤 - -一般为提示类警告信息，不影响后续的程序执行。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/6.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/6.md deleted file mode 100644 index f0f7fe42f150..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/6.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/6/ - - /zh-cn/docs3-v2/java-sdk/faq/6/6/ -description: 6-6 - 不支持的消息 -linkTitle: 6-6 - 不支持的消息 -title: 6-6 - 不支持的消息 -type: docs -weight: 6 ---- - - - - - - - -### 可能的原因 - -返回的数据序列化错误，或超出序列化最大值 - -### 排查和解决步骤 - -可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 - -各组件支持的具体配置项及含义请参考 [配置项手册](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/7.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/7.md deleted file mode 100644 index cca4df2d1a5c..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/7.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/7/ - - /zh-cn/docs3-v2/java-sdk/faq/6/7/ -description: 6-7 - 线程连接数超限警告 -linkTitle: 6-7 - 服务端连接失败 -title: 6-7 - 线程连接数超限警告 -type: docs -weight: 7 ---- - - - - - - -### 可能的原因 - -连接数超过限制时的提醒消息,配置或连接数超过配置数的警告提醒。 - -### 排查和解决步骤 - -默认配置项 `connect.queue.warning.size=1000`,可通过配置进行调整。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/8.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/8.md deleted file mode 100644 index 18887f69f222..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/8.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/8/ - - /zh-cn/docs3-v2/java-sdk/faq/6/8/ -description: 6-8 - 返回数据解码失败 -linkTitle: 6-8 - 返回数据解码失败 -title: 6-8 - 返回数据解码失败 -type: docs -weight: 8 ---- - - - - - - - -### 可能的原因 - -返回数据格式错误或解码失败 - -### 排查和解决步骤 - -可通过 debug/warn 日志模式，输出具体服务类名称和返回的消息及堆栈信息。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/9.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/9.md deleted file mode 100644 index 9ef4669ad7d7..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/9.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/9/ - - /zh-cn/docs3-v2/java-sdk/faq/6/9/ -description: 6-9 - 序列号ID存在重复 -linkTitle: 6-9 - 服务端连接失败 -title: 6-9 - 序列号ID存在重复 -type: docs -weight: 9 ---- - - - - - - - -### 可能的原因 - -1. 返回了一个空对象。 -2. 自定义序列号类，`org.apache.dubbo.common.serialize.Serialization#getContentTypeId` 与系统内置存在重复， -此时在加载时，以首个加载到的 SPI 实例为准。其他项将跳过。 - -### 排查和解决步骤 - -1. 检查返回结果。 -2. 内置值可参考类 `org.apache.dubbo.common.serialize.Constants` \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/6/_index.md b/content/zh-cn/overview/mannual/java-sdk/faq/6/_index.md deleted file mode 100644 index 7f6733d5078d..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/6/_index.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/6/ - - /zh-cn/docs3-v2/java-sdk/faq/6/ -description: 6 - 网络传输层 -linkTitle: 6 - 网络传输层 -title: 6 - 网络传输层 -type: docs -weight: 6 ---- diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/7/1.md b/content/zh-cn/overview/mannual/java-sdk/faq/7/1.md deleted file mode 100644 index 260ace9a9e13..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/7/1.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/7/1/ - - /zh-cn/docs3-v2/java-sdk/faq/7/1/ -description: 7-1 - QOS 已关闭 -linkTitle: 7-1 - QOS 已关闭 -title: 7-1 - QOS 已关闭 -type: docs -weight: 1 ---- - - - - - - -### 可能的原因 - -QOS 已关闭 - -### 排查和解决步骤 - - -> 请参考[QOS 操作手册](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/)。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/7/2.md b/content/zh-cn/overview/mannual/java-sdk/faq/7/2.md deleted file mode 100644 index cc9b5db7bedc..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/7/2.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/7/2/ - - /zh-cn/docs3-v2/java-sdk/faq/7/2/ -description: 7-2 - QOS 已开启 -linkTitle: 7-2 - QOS 已开启 -title: 7-2 - QOS 已开启 -type: docs -weight: 2 ---- - - - - - - -### 可能的原因 - -QOS 已开启，默认为开启状态。 - -### 排查和解决步骤 - - -> 请参考[QOS 操作手册](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/)。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/7/3.md b/content/zh-cn/overview/mannual/java-sdk/faq/7/3.md deleted file mode 100644 index 489fca34c168..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/7/3.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/7/3/ - - /zh-cn/docs3-v2/java-sdk/faq/7/3/ -description: 7-3 - 设置超时时间的警告百分比值 -linkTitle: 7-3 - 设置超时时间的警告百分比值 -title: 7-3 - 设置超时时间的警告百分比值 -type: docs -weight: 3 ---- - - - - - - -## 可能的原因 - -QOS 设置超时时间的警告百分比值, 默认为0.75。修改后，控制台会打印此消息。 - -## 排查和解决步骤 - - -请参考 QOS 操作手册[性能采样命令](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/profiler/)。 -
\ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/7/4.md b/content/zh-cn/overview/mannual/java-sdk/faq/7/4.md deleted file mode 100644 index 22f25956b930..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/7/4.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/7/4/ - - /zh-cn/docs3-v2/java-sdk/faq/7/4/ -description: 7-4 - QOS 服务启动失败 -linkTitle: 7-4 - QOS 服务启动失败 -title: 7-4 - QOS 服务启动失败 -type: docs -weight: 4 ---- - - - - - - -### 可能的原因 - -QOS 参数值未正确设置。主要参数有 `qos.host` 和 `qos.port` - -### 排查和解决步骤 - - -> 请参考QOS 操作手册[QOS 概述](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/overview/)。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/7/5.md b/content/zh-cn/overview/mannual/java-sdk/faq/7/5.md deleted file mode 100644 index f95f2946f258..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/7/5.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/7/5/ - - /zh-cn/docs3-v2/java-sdk/faq/7/5/ -description: 7-5 - QOS 命令未找到 -linkTitle: 7-5 - QOS 命令未找到 -title: 7-5 - QOS 命令未找到 -type: docs -weight: 5 ---- - - - - - - -### 可能的原因 - -QOS 命令拼写错误。 - -## 排查和解决步骤 - -QOS 命令不存在。 - -> 请参考 QOS 操作手册[基础命令手册](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/command/)。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/7/6.md b/content/zh-cn/overview/mannual/java-sdk/faq/7/6.md deleted file mode 100644 index d0771f377e42..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/7/6.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/7/6/ - - /zh-cn/docs3-v2/java-sdk/faq/7/6/ -description: 7-6 - QOS 发生未知异常 -linkTitle: 7-6 - QOS 发生未知异常 -title: 7-6 - QOS 发生未知异常 -type: docs -weight: 6 ---- - - - - - - -### 可能的原因 - -QOS 发生未知异常 - -### 排查和解决步骤 - -1. 检查当前请求的服务是否可正常访问。 -2. 可能由于某些原因，未能正确加载或返回 `CommandContext` 实例。可根据控制台的错误提醒信息，进行排查定位。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/7/7.md b/content/zh-cn/overview/mannual/java-sdk/faq/7/7.md deleted file mode 100644 index 837b3c00e31d..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/7/7.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/7/7/ - - /zh-cn/docs3-v2/java-sdk/faq/7/7/ -description: 7-7 - QOS 无权限访问 -linkTitle: 7-7 - QOS 无权限访问 -title: 7-7 - QOS 无权限访问 -type: docs -weight: 7 ---- - - - - - - -### 可能的原因 - -本次 QoS 请求无权限访问对应的资源，通常出现在有恶意攻击的场景下 - -### 排查和解决步骤 - -检查请求是否是预期发生的，如果非预期请检查是否有恶意攻击源。 -> 如果是预期的，请参考 [QoS 安全](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/overview/#%E5%AE%89%E5%85%A8) 一文配置对应的权限信息。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/7/_index.md b/content/zh-cn/overview/mannual/java-sdk/faq/7/_index.md deleted file mode 100644 index decf987dbebb..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/7/_index.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/7/ - - /zh-cn/docs3-v2/java-sdk/faq/7/ -description: 7 - QoS 插件模块 -linkTitle: 7 - QoS 插件模块 -title: 7 - QoS 插件模块 -type: docs -weight: 7 ---- diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/81/1.md b/content/zh-cn/overview/mannual/java-sdk/faq/81/1.md deleted file mode 100644 index 81c2858f8833..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/81/1.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/81/1/ - - /zh-cn/docs3-v2/java-sdk/faq/81/1/ -description: 81-1 - ZK 启动异常 -linkTitle: 81-1 - ZK 启动异常 -title: 81-1 - ZK 启动异常 -type: docs -weight: 1 ---- - - - - - - -### 可能的原因 - -1. zk 的服务端版本与客户端版本存在不兼容问题，无法进行连接。 -2. zk 服务未正常启动或防火墙等原因不能对外提供服务。 - -### 排查和解决步骤 - -1. 确认客户端版本与服务端版本一致。 -2. zk 能够正常启动或对外能够提供正常服务。 - -可通过一些第三方的工具或者`jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/81/2.md b/content/zh-cn/overview/mannual/java-sdk/faq/81/2.md deleted file mode 100644 index 1d9f641fb83c..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/81/2.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/81/2/ - - /zh-cn/docs3-v2/java-sdk/faq/81/2/ -description: 81-2 - ZK 销毁异常 -linkTitle: 81-2 - ZK 销毁异常 -title: 81-2 - ZK 销毁异常 -type: docs -weight: 2 ---- - - - - - - -### 可能的原因 - -当前实例已销毁完成。 -网络或已断开。 - -### 排查和解决步骤 - -可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/81/3.md b/content/zh-cn/overview/mannual/java-sdk/faq/81/3.md deleted file mode 100644 index 9965bf51954d..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/81/3.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/81/3/ - - /zh-cn/docs3-v2/java-sdk/faq/81/3/ -description: 81-3 - 通过url无法下载文件 -linkTitle: 81-3 - 通过url无法下载文件 -title: 81-3 - 通过url无法下载文件 -type: docs -weight: 3 ---- - - - - - - -### 可能的原因 - -1. url 映射文件不存在。 -2. url 无法连接。 - -### 排查和解决步骤 - -1. 检查 url 映射文件是否存在。 -2. 通过浏览器或其他工具，能否正常访问。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/81/4.md b/content/zh-cn/overview/mannual/java-sdk/faq/81/4.md deleted file mode 100644 index e4410955707e..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/81/4.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/81/4/ - - /zh-cn/docs3-v2/java-sdk/faq/81/4/ -description: 81-4 - 嵌入式ZooKeeper运行异常 -linkTitle: 81-4 - 嵌入式ZooKeeper运行异常 -title: 81-4 - 嵌入式ZooKeeper运行异常 -type: docs -weight: 4 ---- - - - - - - -### 可能的原因 - -1. ZooKeeper 服务运行异常或宕机。 -2. Zookeeper 客户端版本与服务端启动版本不兼容，无法连接。 -3. 应用服务器与 ZooKeeper 服务连接中断。 -4. 受限防火墙或第三方防护工具。 - -### 排查和解决步骤 - -1. 检查 ZooKeeper 服务及所在服务器健康状态。 -2. 检查 Zookeeper 客户端版本与服务端启动版本是否存在兼容问题，保持版本一致。 -3. 检查应用服务器与 ZooKeeper 服务端口是否通畅。 -4. 检查防火墙或第三方防护工具设置，是否已禁止。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/81/_index.md b/content/zh-cn/overview/mannual/java-sdk/faq/81/_index.md deleted file mode 100644 index a165a18b4845..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/81/_index.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/81/ - - /zh-cn/docs3-v2/java-sdk/faq/81/ -description: 81 - 单元测试辅助模块（注册中心） -linkTitle: 81 - 单元测试辅助模块（注册中心） -title: 81 - 单元测试辅助模块（注册中心） -type: docs -weight: 81 ---- - - - - - - -这里主要是 `dubbo-test` 模块中用于测试注册中心模块的代码的相关错误码。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/99/1.md b/content/zh-cn/overview/mannual/java-sdk/faq/99/1.md deleted file mode 100644 index 7a897c613d5c..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/99/1.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/99/1/ - - /zh-cn/docs3-v2/java-sdk/faq/99/1/ -description: 99-1 - 程序被打断 -linkTitle: 99-1 - 程序被打断 -title: 99-1 - 程序被打断 -type: docs -weight: 2 ---- - - - - - -Dubbo 内部的未知错误。 - -### 可能的原因 - -程序收到来自 JVM 层面的打断通知，被迫停止阻塞等待 - -### 排查和解决步骤 - -此异常通常发生在线程池关闭或者应用关闭的过程中。 -请检查是否影响业务正常使用，如无影响可以忽略，如果有影响请参照对应的排查手册。 -更多的排查思路可以参考 [99-0](../0/) 一文。 \ No newline at end of file diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/99/_index.md b/content/zh-cn/overview/mannual/java-sdk/faq/99/_index.md deleted file mode 100644 index a34155a24a0b..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/99/_index.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/99/ - - /zh-cn/docs3-v2/java-sdk/faq/99/ -description: 99 - 其它未知错误 -linkTitle: 99 - 其它未知错误 -title: 99 - 其它未知错误 -type: docs -weight: 99 ---- diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/_index.md b/content/zh-cn/overview/mannual/java-sdk/faq/_index.md deleted file mode 100755 index 9dfd2a783956..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/faq/_index.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/faq/ - - /zh-cn/docs3-v2/java-sdk/faq/ -description: 错误码 FAQ -linkTitle: 错误码 FAQ -title: 错误码 FAQ -type: docs -weight: 6 ---- - - - - - - -这里主要是提供 Java SDK 中各个错误码的可能原因和解决方法。 diff --git a/content/zh-cn/overview/mannual/java-sdk/quick-start/_index.md b/content/zh-cn/overview/mannual/java-sdk/quick-start/_index.md index 78185a2d9265..cea661e66260 100755 --- a/content/zh-cn/overview/mannual/java-sdk/quick-start/_index.md +++ b/content/zh-cn/overview/mannual/java-sdk/quick-start/_index.md @@ -2,9 +2,13 @@ aliases: - /zh/docs3-v2/java-sdk/quick-start/ - /zh-cn/docs3-v2/java-sdk/quick-start/ + - /zh/overview/quickstart/java/ + - /zh-cn/overview/quickstart/java/ + - /zh/overview/quickstart/ + - /zh-cn/overview/quickstart/ description: "" linkTitle: 快速入门 title: 快速入门 type: docs -weight: 1 +weight: 2 --- diff --git a/content/zh-cn/overview/mannual/java-sdk/quick-start/api.md b/content/zh-cn/overview/mannual/java-sdk/quick-start/api.md deleted file mode 100644 index 955470c5f4f9..000000000000 --- a/content/zh-cn/overview/mannual/java-sdk/quick-start/api.md +++ /dev/null @@ -1,287 +0,0 @@ ---- -aliases: - - /zh/docs3-v2/java-sdk/quick-start/api/ - - /zh-cn/docs3-v2/java-sdk/quick-start/api/ - - /zh/overview/quickstart/java/api/ - - /zh-cn/overview/quickstart/java/api/ -description: 本文将基于 Dubbo Samples 示例演示如何通过 Dubbo API 快速开发微服务应用。 -linkTitle: 基于 Dubbo API 开发微服务应用 -title: 2 - 基于 Dubbo API 开发微服务应用 -type: docs -weight: 2 ---- - - - - - - -## 目标 - -从零上手开发基于 Dubbo 的微服务 - -## 难度 - -低 - -## 环境要求 - -- 系统：Windows、Linux、MacOS - -- JDK 8 及以上（推荐使用 JDK17） - -- Git - -- IntelliJ IDEA（可选） - -- Docker （可选） - -## 动手实践 - -本章将通过手把手的教程一步一步教你如何从零开发一个微服务应用。 - -### 1. 启动注册中心 - -对于一个微服务化的应用来说，注册中心是不可或缺的一个组件。只有通过注册中心，消费端才可以成功发现服务端的地址信息，进而进行调用。 - -为了让本教程更易于上手，我们提供了一个基于 Apache Zookeeper 注册中心的简易启动器，如果您需要在生产环境部署注册中心，请参考[生产环境初始化](/)一文部署高可用的注册中心。 - -```bash -Windows: -git clone --depth=1 --branch master git@github.com:apache/dubbo-samples.git -cd dubbo-samples -./mvnw.cmd clean compile exec:java -pl tools/embedded-zookeeper - -Linux / MacOS: -git clone --depth=1 --branch master git@github.com:apache/dubbo-samples.git -cd dubbo-samples -./mvnw clean compile exec:java -pl tools/embedded-zookeeper - -Docker: -docker run --name some-zookeeper --restart always -d zookeeper -``` - -### 2. 初始化项目 - -从本小节开始，将基于 IntelliJ IDEA 进行工程的搭建以及测试。 - - - -如上图所示，可以建立一个基础的项目。 - - - -在初始化完项目之后，需要在 `src/main/java` 目录下创建 `org.apache.dubbo.samples.api` 、`org.apache.dubbo.samples.client` 和 `org.apache.dubbo.samples.provider` 三个 package。 - -后续我们将在 `api` 下创建对应的接口，在 `client` 下创建对应客户端订阅服务的功能，在 `provider` 下创建对应服务端的实现以及发布服务的功能。 - -上述三个 package 分别对应了应用共同依赖的 api、消费端应用的模块、服务端应用的模块。在实际部署中需要拆成三个工程，消费端和服务的共同依赖 api 模块。从简单出发，本教程将在同一个工程中进行开发，区分多个启动类。 - -### 3. 添加 Maven 依赖 - -在初始化完项目以后，我们需要先添加 Dubbo 相关的 maven 依赖。 - - - -编辑 `pom.xml` 这个文件，添加下列配置。 - -```xml -
+
+{{% alert title="直接使用官方准备好的示例" color="info" %}}
+您还可以直接下载官方预先准备好的示例项目：
+
+```shell
+$ git clone -b main --depth 1 https://github.com/apache/dubbo-samples
+$ cd dubbo-samples/11-quickstart
+````
+{{% /alert %}}
+
+## 本地启动应用
+接下来，让我们尝试在本地启动应用。运行以下命令启动应用：
+
+```shell
+./mvnw
+```
+
+{{% alert title="注意" color="warning" %}}
+由于配置文件中启用了注册中心，为了能够成功启动应用，您需要首先在本地启动 Nacos 或 Zookeeper 注册中心 server。
+{{% /alert %}}
+
+
+在应用启动成功后，本地进程使用 Triple 协议在指定端口发布了服务，可直接使用 cURL 测试服务是否已经正常运行：
+
+```shell
+curl \
+ --header "Content-Type: application/json" \
+ --data '["Dubbo"]' \
+ http://localhost:50051/com.example.demo.dubbo.api.DemoService/sayHello/
+```
+
+除了使用命令行之外，我们还可以在 IDE 中启动项目，调整示例或进行本地 debug。
+
+## 源码解析
+将以上准备好的示例项目导入最喜欢的 IDE 开发工具（以 IntelliJ IDEA 为例），项目结构如下：
+
+
+
+### Maven 依赖
+打开 pom.xml，可以看到示例项目中 Dubbo 相关核心依赖如下：
+
+```xml
+ 
- 
- 
- 
- 
- 
- 
- 
- 
- @Activate can be used to load certain Filter extension when there are
+ * multiple implementations.
+ *
+ * For example, given @Activate("cache, validation"), the current extension will be return only when
+ * there's either cache or validation key appeared in the URL's parameters.
+ *
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/16.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/16.md new file mode 100644 index 000000000000..3ac1e2167b59 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/16.md @@ -0,0 +1,27 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/16/ +- /zh-cn/docs3-v2/java-sdk/faq/0/16/ +- /zh-cn/overview/mannual/java-sdk/faq/0/16/ +description: 0-16 - 没有可用的执行器 +linkTitle: 0-16 - 没有可用的执行器 +title: 0-16 - 没有可用的执行器 +type: docs +weight: 16 +--- + + + + + + + +### 可能的原因 + +内部执行器不可用，此时返回空。 + +### 排查和解决步骤 + +不需要进行干预，dubbo 内部会执行`createExecutorIfAbsent` 方法构建一个新的执行器。 + +
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/17.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/17.md new file mode 100644 index 000000000000..8d4887f156e4 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/17.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/17/ +- /zh-cn/docs3-v2/java-sdk/faq/0/17/ +- /zh-cn/overview/mannual/java-sdk/faq/0/17/ +description: 0-17 - 执行器在关闭时发生未知异常 +linkTitle: 0-17 - 执行器在关闭时发生未知异常 +title: 0-17 - 执行器在关闭时发生未知异常 +type: docs +weight: 17 +--- + + + + + + + +### 可能的原因 + +可能使用了自定义的执行器，在编写销毁方法时，产生了异常。 + +### 排查和解决步骤 + +检查是否自定义实现 `org.apache.dubbo.common.threadpool.manager.ExecutorRepository`,检查自定义的 `shutdown` 方法。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/18.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/18.md new file mode 100644 index 000000000000..846e60e60923 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/18.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/18/ +- /zh-cn/docs3-v2/java-sdk/faq/0/18/ +- /zh-cn/overview/mannual/java-sdk/faq/0/18/ +description: 0-18 - 线程池执行器被错误使用 +linkTitle: 0-18 - 线程池执行器被错误使用 +title: 0-18 - 线程池执行器被错误使用 +type: docs +weight: 18 +--- + + + + + + + +### 可能的原因 + +自定义设置了线程数量，系统内部发生了未知异常。 + +### 排查和解决步骤 + +可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/19.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/19.md new file mode 100644 index 000000000000..aa8fe7ef0b1f --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/19.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/19/ +- /zh-cn/docs3-v2/java-sdk/faq/0/19/ +- /zh-cn/overview/mannual/java-sdk/faq/0/19/ +description: 0-19 - 处理任务时发生异常 +linkTitle: 0-19 - 处理任务时发生异常 +title: 0-19 - 处理任务时发生异常 +type: docs +weight: 19 +--- + + + + + + + +### 可能的原因 + +自定义业务类处理逻辑不当。 + +### 排查和解决步骤 + +可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/2.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/2.md new file mode 100644 index 000000000000..f3ce40d87e52 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/2.md @@ -0,0 +1,18 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/2/ +- /zh-cn/docs3-v2/java-sdk/faq/0/2/ +- /zh-cn/overview/mannual/java-sdk/faq/0/2/ +description: 0-2 - 非法属性值 +linkTitle: 0-2 - 非法属性值 +title: 0-2 - 非法属性值 +type: docs +weight: 2 +--- + + +### 可能的原因 +这个提示是指用户配置的值与属性本身所需的数据类型并不匹配。比如 `dubbo.comsumer.threads` 属性只能接受数值属性，但是用户所输入的值混入了字母。 + +### 排查和解决步骤 +根据[配置项参考手册](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/)，查找出错的配置项，检查该项指定的类型，检查是否出现类型不一致的情况。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/20.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/20.md new file mode 100644 index 000000000000..e9c985b73a82 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/20.md @@ -0,0 +1,27 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/20/ +- /zh-cn/docs3-v2/java-sdk/faq/0/20/ +- /zh-cn/overview/mannual/java-sdk/faq/0/20/ +description: 0-20 - 存储堆栈信息时发生异常 +linkTitle: 0-20 - 存储堆栈信息时发生异常 +title: 0-20 - 存储堆栈信息时发生异常 +type: docs +weight: 20 +--- + + + + + + + +### 可能的原因 + +1. JVM设置了参数 `-XX:+DisableAttachMechanism` +2. 设置了系统不存在的堆栈转储路径，不存在情况，系统会尝试进行创建，创建时发生了 `SecurityException`, 可能是没有权限。 + +### 排查和解决步骤 + +1. 检查 JVM 是否设置了如上参数。 +2. 检查当前启动服务的账号，是否有权限进行创建文件夹。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/21.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/21.md new file mode 100644 index 000000000000..918053167e85 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/21.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/21/ +- /zh-cn/docs3-v2/java-sdk/faq/0/21/ +- /zh-cn/overview/mannual/java-sdk/faq/0/21/ +description: 0-21 - 构建的实例过多 +linkTitle: 0-21 - 构建的实例过多 +title: 0-21 - 构建的实例过多 +type: docs +weight: 21 +--- + + + + + + +### 可能的原因 + +一般指 `org.apache.dubbo.common.timer.HashedWheelTimer` 创建的实例过多。 + +### 排查和解决步骤 + +不影响实例的构建，可能存在内存泄露的风险。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/22.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/22.md new file mode 100644 index 000000000000..5067b58c45b5 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/22.md @@ -0,0 +1,31 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/22/ +- /zh-cn/docs3-v2/java-sdk/faq/0/22/ +- /zh-cn/overview/mannual/java-sdk/faq/0/22/ +description: 0-22 - 输入输出流异常 +linkTitle: 0-22 - 输入输出流异常 +title: 0-22 - 输入输出流异常 +type: docs +weight: 22 +--- + + + + + + + +### 可能的原因 + +1. 读取不再可用的本地文件。 +2. 尝试读取/写入文件但没有权限。 +3. 尝试写入文件但磁盘空间不再可用。 + +### 排查和解决步骤 + +1. 检查本地文件是否存在。 +2. 检查文件权限。 +3. 检查磁盘空间。 + +可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/23.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/23.md new file mode 100644 index 000000000000..1f3ed674cbb5 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/23.md @@ -0,0 +1,29 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/23/ +- /zh-cn/docs3-v2/java-sdk/faq/0/23/ +- /zh-cn/overview/mannual/java-sdk/faq/0/23/ +description: 0-23 - 序列化数据转换异常 +linkTitle: 0-23 - 序列化数据转换异常 +title: 0-23 - 序列化数据转换异常 +type: docs +weight: 23 +--- + + + + + + + +### 可能的原因 + +1. 待序列化数据中存在循环引用，导致堆栈溢出。 +2. 引用的 jar 包版本低或存在兼容性问题。 + +### 排查和解决步骤 + +1. 如使用 FastJson，去掉 `SerializerFeature.DisableCircularReferenceDetec` +2. 检查下或升级版本进行尝试。 + +可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/24.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/24.md new file mode 100644 index 000000000000..95cbc29440cf --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/24.md @@ -0,0 +1,27 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/24/ +- /zh-cn/docs3-v2/java-sdk/faq/0/24/ +- /zh-cn/overview/mannual/java-sdk/faq/0/24/ +description: 0-24 - 覆盖字段值异常 +linkTitle: 0-24 - 覆盖字段值异常 +title: 0-24 - 覆盖字段值异常 +type: docs +weight: 24 +--- + + + + + + + +### 可能的原因 + +1. 实体类未设置 setter/getter 方法。 +2. 可能存在嵌套的属性。 + +### 排查和解决步骤 + +1. 检查实体类并设置 setter/getter 方法。 +2. 根据堆栈信息，检查是否使用嵌套注解。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/25.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/25.md new file mode 100644 index 000000000000..6c7fb5aa52da --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/25.md @@ -0,0 +1,26 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/25/ +- /zh-cn/docs3-v2/java-sdk/faq/0/25/ +- /zh-cn/overview/mannual/java-sdk/faq/0/25/ +description: 0-25 - 加载映射错误 +linkTitle: 0-25 - 加载映射错误 +title: 0-25 - 加载映射错误 +type: docs +weight: 25 +--- + + + + + + + +### 可能的原因 + +文件访问权限不足 + +### 排查和解决步骤 + +检查文件权限。 +可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/26.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/26.md new file mode 100644 index 000000000000..55d6d86991cd --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/26.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/26/ +- /zh-cn/docs3-v2/java-sdk/faq/0/26/ +- /zh-cn/overview/mannual/java-sdk/faq/0/26/ +description: 0-26 - 元数据发布服务时的警告信息 +linkTitle: 0-26 - 元数据发布服务时的警告信息 +title: 0-26 - 元数据发布服务时的警告信息 +type: docs +weight: 26 +--- + + + + + + +### 可能的原因 + +元数据在存储接口与应用的映射关系时，显示的提醒类消息。 + +### 排查和解决步骤 + +一般可根据堆栈信息进行分析，也可不处理。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/27.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/27.md new file mode 100644 index 000000000000..35e39155f99e --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/27.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/27/ +- /zh-cn/docs3-v2/java-sdk/faq/0/27/ +- /zh-cn/overview/mannual/java-sdk/faq/0/27/ +description: 0-27 - 线程池隔离配置异常 +linkTitle: 0-27 - 线程池隔离配置异常 +title: 0-27 - 线程池隔离配置异常 +type: docs +weight: 27 +--- + + + + + + +### 可能的原因 + +未开启应用的线程池隔离能力，但是却在 `ServiceConfig` 中配置了隔离的线程池信息。 + +### 排查和解决步骤 + +配置开启应用的线程池隔离能力：`dubbo.application.executor-management-mode=isolation` diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/28.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/28.md new file mode 100644 index 000000000000..1755794dd97e --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/28.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/28/ +- /zh-cn/docs3-v2/java-sdk/faq/0/28/ +- /zh-cn/overview/mannual/java-sdk/faq/0/28/ +description: 0-28 - 操作了可能会引起危险的行为 +linkTitle: 0-28 - 危险的行为 +title: 0-28 - 操作了可能会引起危险的行为 +type: docs +weight: 28 +--- + + + + + + +### 可能的原因 + +你执行了以下操作之一： +* 尝试或已经调整了 accesslog 的输出位置 + +### 排查和解决步骤 + +请检查应用配置中的 `accesslog.fixed.path=true` 开关是否处于开启状态，如未开启则可忽略；如果当前是开启状态，则请确认是否 acesslog 路径切换的行为是否为可信任的人所执行，以避免可能的安全风险。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/29.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/29.md new file mode 100644 index 000000000000..8ccd185b72a0 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/0/29.md @@ -0,0 +1,39 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/0/29/ +- /zh-cn/docs3-v2/java-sdk/faq/0/29/ +- /zh-cn/overview/mannual/java-sdk/faq/0/29/ +description: 0-29 - 未找到Tracer依赖 +linkTitle: 0-29 - 未找到Tracer依赖 +title: 0-29 - 未找到Tracer依赖 +type: docs +weight: 29 +--- + +### 可能的原因 + +你已在配置文件中开启了tracing，但未找到Tracer依赖。 + +目前Tracer支持两种，OpenTelemetry和Brave。 + +### 排查和解决步骤 + +选择一个Tracer依赖到你的项目中： + +```xml + +
| dubbo.mapping.cache.entrySize | +dubbo.meta.cache.entrySize | +
| 10000 | +100 | +
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/36.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/36.md new file mode 100644 index 000000000000..6b337d196bf0 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/36.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/36/ +- /zh-cn/docs3-v2/java-sdk/faq/5/36/ +- /zh-cn/overview/mannual/java-sdk/faq/5/36/ +description: 5-36 - 过滤器校验时发生错误 +linkTitle: 5-36 - 过滤器校验时发生错误 +title: 5-36 - 过滤器校验时发生错误 +type: docs +weight: 36 +--- + + + + + + +### 可能的原因 + +自定义过滤器扩展类中重写的 `invoke` 方法，发生业务代码异常。 + +### 排查和解决步骤 +1. 使用 ps -eaf |grep <错误服务> +2. 可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/37.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/37.md new file mode 100644 index 000000000000..e216f007259b --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/37.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/37/ +- /zh-cn/docs3-v2/java-sdk/faq/5/37/ +- /zh-cn/overview/mannual/java-sdk/faq/5/37/ +description: 5-37 - 动态配置监听处理发生错误 +linkTitle: 5-37 - 动态配置监听处理发生错误 +title: 5-37 - 动态配置监听处理发生错误 +type: docs +weight: 37 +--- + + + + + +文件发生变化时，监听事件处理失败 + +### 可能的原因 + +文件权限发生变化或目录权限发生变化。 + +### 排查和解决步骤 + +可根据控制台的堆栈信息，进行代码定位。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/38.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/38.md new file mode 100644 index 000000000000..e1a911575d5c --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/38.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/38/ +- /zh-cn/docs3-v2/java-sdk/faq/5/38/ +- /zh-cn/overview/mannual/java-sdk/faq/5/38/ +description: 5-38 - 配置参数未定义 +linkTitle: 5-38 - 配置参数未定义 +title: 5-38 - 配置参数未定义 +type: docs +weight: 38 +--- + + + + + + +### 可能的原因 + +配置参数未定义 + +### 排查和解决步骤 + +多为测试用例中使用，可根据提示明细，进行参数的设置。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/39.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/39.md new file mode 100644 index 000000000000..9ed6c90f3236 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/39.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/39/ +- /zh-cn/docs3-v2/java-sdk/faq/5/39/ +- /zh-cn/overview/mannual/java-sdk/faq/5/39/ +description: 5-39 - Dubbo配置bean初始化器发生错误 +linkTitle: 5-39 - Dubbo配置bean初始化器发生错误 +title: 5-39 - Dubbo配置bean初始化器发生错误 +type: docs +weight: 39 +--- + + + + + + +### 可能的原因 + +源代码或被修改 + +### 排查和解决步骤 + +检查业务代码未对核心类进行源码修改或加载的顺序修改。 +如：`org.apache.dubbo.config.spring.context.DubboConfigBeanInitializer` diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/4.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/4.md new file mode 100644 index 000000000000..f557175c9c96 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/4.md @@ -0,0 +1,26 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/4/ +- /zh-cn/docs3-v2/java-sdk/faq/5/4/ +- /zh-cn/overview/mannual/java-sdk/faq/5/4/ +description: 5-4 - 服务接口中找不到方法 +linkTitle: 5-4 - 服务接口中找不到方法 +title: 5-4 - 服务接口中找不到方法 +type: docs +weight: 4 +--- + + + + + + +### 可能的原因 + +1. 消费端调用的接口名#方法不存在。 +2. 服务端未正确的暴露当前接口。 + +### 排查和解决步骤 + +1. 检查消费端调用的接口名#方法是否存在。 +2. 检查服务端暴露的服务列表内是否存在。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/40.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/40.md new file mode 100644 index 000000000000..ca79402f4e1d --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/40.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/40/ +- /zh-cn/docs3-v2/java-sdk/faq/5/40/ +- /zh-cn/overview/mannual/java-sdk/faq/5/40/ +description: 5-40 - Dubbo配置bean未找到 +linkTitle: 5-40 - Dubbo配置bean未找到 +title: 5-40 - Dubbo配置bean未找到 +type: docs +weight: 40 +--- + + + + + + +### 可能的原因 + +源代码或被修改 + +### 排查和解决步骤 + +检查业务代码未对核心类进行源码修改或加载的顺序修改。 +如：`org.apache.dubbo.config.spring.context.DubboConfigBeanInitializer` diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/41.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/41.md new file mode 100644 index 000000000000..5167fc20cfed --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/41.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/41/ +- /zh-cn/docs3-v2/java-sdk/faq/5/41/ +- /zh-cn/overview/mannual/java-sdk/faq/5/41/ +description: 5-41 - SSL证书读取失败 +linkTitle: 5-41 - SSL证书读取失败 +title: 5-41 - SSL证书读取失败 +type: docs +weight: 41 +--- + + + + + + +### 可能的原因 + +SSL 证书配置异常 + +### 排查和解决步骤 + +检查 SSL 证书的配置，查看对应文件是否存在 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/42.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/42.md new file mode 100644 index 000000000000..e32b4a65ef2b --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/42.md @@ -0,0 +1,26 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/42/ +- /zh-cn/docs3-v2/java-sdk/faq/5/42/ +- /zh-cn/overview/mannual/java-sdk/faq/5/42/ +description: 5-42 - Dubbo 证书签发失败 +linkTitle: 5-42 - Dubbo 证书签发失败 +title: 5-42 - Dubbo 证书签发失败 +type: docs +weight: 42 +--- + + + + + + +### 可能的原因 + +Dubbo 请求远程 CA 签发证书失败 + +### 排查和解决步骤 + +- 检查 CA 连接配置 +- 检查 CA 运行状态 +- 检查 CA 日志 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/43.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/43.md new file mode 100644 index 000000000000..4ac65c40416f --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/43.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/43/ +- /zh-cn/docs3-v2/java-sdk/faq/5/43/ +- /zh-cn/overview/mannual/java-sdk/faq/5/43/ +description: 5-43 - Dubbo 证书签发连接不安全 +linkTitle: 5-43 - Dubbo 证书签发连接不安全 +title: 5-43 - Dubbo 证书签发连接不安全 +type: docs +weight: 43 +--- + + + + + + +### 可能的原因 + +Dubbo 与远程 CA 的连接不安全 + +### 排查和解决步骤 + +- 检查 Dubbo 进程是否已经正确配置了 CA 证书信息以及 OIDC（OpenID Connect）的 Token 获取方式 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/5.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/5.md new file mode 100644 index 000000000000..b1fc2889a647 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/5.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/5/ +- /zh-cn/docs3-v2/java-sdk/faq/5/5/ +- /zh-cn/overview/mannual/java-sdk/faq/5/5/ +description: 5-5 - 无法获得env变量 +linkTitle: 5-5 - 无法获得env变量 +title: 5-5 - 无法获得env变量 +type: docs +weight: 5 +--- + + + + + + +### 可能的原因 + +环境变量无法获取。 + +### 排查和解决步骤 + +检查提示的变量名，是否配置并可以正常读取加载。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/6.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/6.md new file mode 100644 index 000000000000..45dd63782dfe --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/6.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/6/ +- /zh-cn/docs3-v2/java-sdk/faq/5/6/ +- /zh-cn/overview/mannual/java-sdk/faq/5/6/ +description: 5-6 - 接口类型的属性冲突 +linkTitle: 5-6 - 接口类型的属性冲突 +title: 5-6 - 接口类型的属性冲突 +type: docs +weight: 6 +--- + + + + + + +### 可能的原因 + +泛化定义配置不正确。 + +### 排查和解决步骤 + +检查泛化定义是否正确。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/7.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/7.md new file mode 100644 index 000000000000..5041addb585f --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/7.md @@ -0,0 +1,28 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/7/ +- /zh-cn/docs3-v2/java-sdk/faq/5/7/ +- /zh-cn/overview/mannual/java-sdk/faq/5/7/ +description: 5-7 - 取消导出时发生意外错误 +linkTitle: 5-7 - 取消导出时发生意外错误 +title: 5-7 - 取消导出时发生意外错误 +type: docs +weight: 7 +--- + + + + + + +### 可能的原因 + +1. 配置中心的服务无法连接。 +2. 配置的协议、IP、端口不正确。 +3. 使用配置中心客户端版本与服务端版本冲突，无法建立有效连接。 + +### 排查和解决步骤 + +1. 检查配置中心的服务状态是否正常。 +2. 检查配置的协议、IP、端口不正确。 +3. 检查使用的配置中心客户端版本与服务端版本是否兼容。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/8.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/8.md new file mode 100644 index 000000000000..c0966beb4828 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/8.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/8/ +- /zh-cn/docs3-v2/java-sdk/faq/5/8/ +- /zh-cn/overview/mannual/java-sdk/faq/5/8/ +description: 5-8 - 协议将使用随机可用端口 +linkTitle: 5-8 - 协议将使用随机可用端口 +title: 5-8 - 协议将使用随机可用端口 +type: docs +weight: 8 +--- + + + + + + +### 可能的原因 + +协议指定的端口被占用，随机选择端口进行启动。 + +### 排查和解决步骤 + +检查当前配置端口是否被其它应用程序占用。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/9.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/9.md new file mode 100644 index 000000000000..57a333eb4a18 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/9.md @@ -0,0 +1,28 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/9/ +- /zh-cn/docs3-v2/java-sdk/faq/5/9/ +- /zh-cn/overview/mannual/java-sdk/faq/5/9/ +description: 5-9 - 服务配置导出失败 +linkTitle: 5-9 - 服务配置导出失败 +title: 5-9 - 服务配置导出失败 +type: docs +weight: 9 +--- + + + + + + +### 可能的原因 + +1. 配置中心的服务无法连接。 +2. 配置的协议、IP、端口不正确。 +3. 使用配置中心客户端版本与服务端版本冲突，无法建立有效连接。 + +### 排查和解决步骤 + +1. 检查配置中心的服务状态是否正常。 +2. 检查配置的协议、IP、端口不正确。 +3. 检查使用的配置中心客户端版本与服务端版本是否兼容。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/_index.md new file mode 100644 index 000000000000..26a7bcd20484 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/5/_index.md @@ -0,0 +1,11 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/5/ +- /zh-cn/docs3-v2/java-sdk/faq/5/ +- /zh-cn/overview/mannual/java-sdk/faq/5/_index/ +description: 5 - 配置（中心）层 +linkTitle: 5 - 配置（中心）层 +title: 5 - 配置（中心）层 +type: docs +weight: 5 +--- diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/1.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/1.md new file mode 100644 index 000000000000..96c7734da080 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/1.md @@ -0,0 +1,26 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/1/ +- /zh-cn/docs3-v2/java-sdk/faq/6/1/ +- /zh-cn/overview/mannual/java-sdk/faq/6/1/ +description: 6-1 - 服务端连接失败 +linkTitle: 6-1 - 服务端连接失败 +title: 6-1 - 服务端连接失败 +type: docs +weight: 1 +--- + + + + + +网络通信层，在连接服务提供者服务时失败 + +### 可能的原因 + +服务提供者的网络异常断开或受防火墙及第三方工具的拦截，无法对外提供服务。 + +### 排查和解决步骤 + +1. 如果为 rest 连接，检查请求的服务端配置是否正确。 +2. 检查网络通信是否正常，可使用一些简单的 cmd 命令进行检测，如 `ping` 等。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/10.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/10.md new file mode 100644 index 000000000000..ac18c5ea06d4 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/10.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/10/ +- /zh-cn/docs3-v2/java-sdk/faq/6/10/ +- /zh-cn/overview/mannual/java-sdk/faq/6/10/ +description: 6-10 - 超过有效载荷限制异常 +linkTitle: 6-10 - 超过有效载荷限制异常 +title: 6-10 - 超过有效载荷限制异常 +type: docs +weight: 10 +--- + + + + + + +### 可能的原因 + +> 默认 `payload=8M`,请检查各项配置 + +### 排查和解决步骤 + +各组件支持的具体配置项及含义请参考 [配置项手册](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/11.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/11.md new file mode 100644 index 000000000000..e8a385ec43eb --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/11.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/11/ +- /zh-cn/docs3-v2/java-sdk/faq/6/11/ +- /zh-cn/overview/mannual/java-sdk/faq/6/11/ +description: 6-11 - 字符集不被支持 +linkTitle: 6-11 - 字符集不被支持 +title: 6-11 - 字符集不被支持 +type: docs +weight: 11 +--- + + + + + + +## 可能的原因 + +> 默认 `UTF-8` 字符集 + +## 排查和解决步骤 + +结果会最终以 `UTF-8` 字符集进行处理。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/12.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/12.md new file mode 100644 index 000000000000..58b4d27d0b98 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/12.md @@ -0,0 +1,26 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/12/ +- /zh-cn/docs3-v2/java-sdk/faq/6/12/ +- /zh-cn/overview/mannual/java-sdk/faq/6/12/ +description: 6-12 - ZK客户端销毁时发生错误 +linkTitle: 6-12 - ZK客户端销毁时发生错误 +title: 6-12 - ZK客户端销毁时发生错误 +type: docs +weight: 12 +--- + + + + + + + +### 可能的原因 + +客户端与服务端连接已被拒绝 +客户端在销毁时，可能服务端正在进行选举或者其他操作，导致发生的异常。 + +### 排查和解决步骤 + +关闭方法，可针对堆栈信息进行查询。一般可不处理。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/13.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/13.md new file mode 100644 index 000000000000..76c1392b058f --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/13.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/13/ +- /zh-cn/docs3-v2/java-sdk/faq/6/13/ +- /zh-cn/overview/mannual/java-sdk/faq/6/13/ +description: 6-13 - 流关闭异常 +linkTitle: 6-13 - 流关闭异常 +title: 6-13 - 流关闭异常 +type: docs +weight: 13 +--- + + + + + + + +### 可能的原因 + +当前流已关闭 `Stream is closed` 或流关闭时，其他线程正在读取。 + +### 排查和解决步骤 + +一般为代码关闭流的顺序上发生了颠倒。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/14.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/14.md new file mode 100644 index 000000000000..07bd31411399 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/14.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/14/ +- /zh-cn/docs3-v2/java-sdk/faq/6/14/ +- /zh-cn/overview/mannual/java-sdk/faq/6/14/ +description: 6-14 - 服务端响应失败 +linkTitle: 6-14 - 服务端响应失败 +title: 6-14 - 服务端响应失败 +type: docs +weight: 14 +--- + + + + + + +### 可能的原因 + +在服务端与客户端交互发生数据时，客户端异常关闭。 + +### 排查和解决步骤 + +客户端异常终止或服务器宕机。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/15.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/15.md new file mode 100644 index 000000000000..565f47239166 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/15.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/15/ +- /zh-cn/docs3-v2/java-sdk/faq/6/15/ +- /zh-cn/overview/mannual/java-sdk/faq/6/15/ +description: 6-15 - 跳过未读完的流数据 +linkTitle: 6-15 - 跳过未读完的流数据 +title: 6-15 - 跳过未读完的流数据 +type: docs +weight: 15 +--- + + + + + + +### 可能的原因 + +解码时，如流中还有未读数据时会跳过未读完的流 + +### 排查和解决步骤 + +解码时会把数据全部一次性读取 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/16.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/16.md new file mode 100644 index 000000000000..4ed6d440761d --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/16.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/16/ +- /zh-cn/docs3-v2/java-sdk/faq/6/16/ +- /zh-cn/overview/mannual/java-sdk/faq/6/16/ +description: 6-16 - 重连时发生异常 +linkTitle: 6-16 - 重连时发生异常 +title: 6-16 - 重连时发生异常 +type: docs +weight: 16 +--- + + + + + + +### 可能的原因 + +每次发生重连时提示，网络不稳定造成的延迟重连。 + +### 排查和解决步骤 + +检查是否有网络丢包情况。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/2.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/2.md new file mode 100644 index 000000000000..425161657877 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/2.md @@ -0,0 +1,34 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/2/ +- /zh-cn/docs3-v2/java-sdk/faq/6/2/ +- /zh-cn/overview/mannual/java-sdk/faq/6/2/ +description: 6-2 - 客户端超时 +linkTitle: 6-2 - 客户端超时 +title: 6-2 - 客户端超时 +type: docs +weight: 2 +--- + + + + + +超时是调用端发生在请求发出后，无法在指定的时间内获得对应的响应。 + +### 可能的原因 +1. 服务端确实处理比较慢，无法在指定的时间返回结果，调用端就自动返回一个超时的异常响应来结束此次调用。 +2. 服务端如果响应的比较快，但当客户端 Load 很高，负载压力很大的时候，会因为客户端请求发不出去、响应卡在 TCP Buffer 等问题，造成超时。因为客户端接收到服务端发来的数据或者请求服务端的数据，都会在系统层面排队，如果系统负载比较高，在内核态的时间占比就会加长，从而造成客户端获取到值时已经超时。 +3. 通常是业务处理太慢，可在服务提供方机器上执行：`jstack [PID] > jstack.log` 分析线程都卡在哪个方法调用上，这里就是慢的原因。如果不能调优性能，请调高 timeout 阈值。 + + +### 排查和解决步骤 + +1. 两边可能有 GC，检查服务端和客户端 GC 日志，耗时很长的 GC，会导致超时。超时的发生很可能意味着调用端或者服务端的资源（CPU，内存或者网络）出现了瓶颈，需要检查服务端的问题还是调用端的问题来排除 GC 抖动等嫌疑。 +2. 检查服务端的网络质量，比如重传率来排除网络嫌疑。 +3. 借助链路跟踪的分析服务（比如阿里的 [ARMS](https://help.aliyun.com/document_detail/63796.html) ，开源的 [OpenTracing](https://github.com/opentracing/opentracing-java) +系的实现 [Zipkin](https://github.com/openzipkin/zipkin) 、[SkyWalking](https://github.com/apache/skywalking) 等）来分析下各个点的耗时情况。 + + +> 这个错误码的 FAQ 页面参考了空冥同学的 [《Dubbo 常见错误及解决方法》](https://github.com/StabilityMan/StabilityGuide/blob/master/docs/diagnosis/plugin/rpc/%E7%B3%BB%E7%BB%9F%E7%A8%B3%E5%AE%9A%E6%80%A7%E2%80%94%E2%80%94Dubbo%E5%B8%B8%E8%A7%81%E9%94%99%E8%AF%AF%E5%8F%8A%E8%A7%A3%E5%86%B3%E6%96%B9%E6%B3%95.md) 。 +所引文章通过 [CC-BY-4.0](http://creativecommons.org/licenses/by/4.0/) 协议赋予了汇编的权利。在此向原作者表示感谢。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/3.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/3.md new file mode 100644 index 000000000000..cc612f74e92d --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/3.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/3/ +- /zh-cn/docs3-v2/java-sdk/faq/6/3/ +- /zh-cn/overview/mannual/java-sdk/faq/6/3/ +description: 6-3 - 网络连接关闭失败 +linkTitle: 6-3 - 网络连接关闭失败 +title: 6-3 - 网络连接关闭失败 +type: docs +weight: 3 +--- + + + + + + +### 可能的原因 + +非优雅关闭服务，此时服务端可能在对外输出流未完成。 + +### 排查和解决步骤 + +一般为提示类警告信息，不影响后续的程序执行。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/4.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/4.md new file mode 100644 index 000000000000..40a49072c93a --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/4.md @@ -0,0 +1,22 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/4/ +- /zh-cn/docs3-v2/java-sdk/faq/6/4/ +- /zh-cn/overview/mannual/java-sdk/faq/6/4/ +description: 6-4 - 网络通讯层未知异常 +linkTitle: 6-4 - 网络通讯层未知异常 +title: 6-4 - 网络通讯层未知异常 +type: docs +weight: 4 +--- + + + + + + +### 可能的原因 +> 该错误码的意义已经调整。对于 Dubbo 3.1.4、3.2.0-beta.3 及其之前的版本的该错误码的出错，请参考错误码 [99-0](/zh-cn/overview/mannual/java-sdk/faq/99/0/)。 + +### 排查和解决步骤 +（该错误码目前空缺） diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/5.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/5.md new file mode 100644 index 000000000000..8cf5c6c41ed1 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/5.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/5/ +- /zh-cn/docs3-v2/java-sdk/faq/6/5/ +- /zh-cn/overview/mannual/java-sdk/faq/6/5/ +description: 6-5 - 网络连接断开失败 +linkTitle: 6-5 - 网络连接断开失败 +title: 6-5 - 网络连接断开失败 +type: docs +weight: 5 +--- + + + + + + + +### 可能的原因 + +超时是调用端发生在请求发出后，无法在指定的时间内获得对应的响应，出现客户端主动断开连接 + +### 排查和解决步骤 + +一般为提示类警告信息，不影响后续的程序执行。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/6.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/6.md new file mode 100644 index 000000000000..07f50c01f853 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/6.md @@ -0,0 +1,27 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/6/ +- /zh-cn/docs3-v2/java-sdk/faq/6/6/ +- /zh-cn/overview/mannual/java-sdk/faq/6/6/ +description: 6-6 - 不支持的消息 +linkTitle: 6-6 - 不支持的消息 +title: 6-6 - 不支持的消息 +type: docs +weight: 6 +--- + + + + + + + +### 可能的原因 + +返回的数据序列化错误，或超出序列化最大值 + +### 排查和解决步骤 + +可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 + +各组件支持的具体配置项及含义请参考 [配置项手册](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/7.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/7.md new file mode 100644 index 000000000000..137a8002f48c --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/7.md @@ -0,0 +1,24 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/7/ +- /zh-cn/docs3-v2/java-sdk/faq/6/7/ +- /zh-cn/overview/mannual/java-sdk/faq/6/7/ +description: 6-7 - 线程连接数超限警告 +linkTitle: 6-7 - 服务端连接失败 +title: 6-7 - 线程连接数超限警告 +type: docs +weight: 7 +--- + + + + + + +### 可能的原因 + +连接数超过限制时的提醒消息,配置或连接数超过配置数的警告提醒。 + +### 排查和解决步骤 + +默认配置项 `connect.queue.warning.size=1000`,可通过配置进行调整。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/8.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/8.md new file mode 100644 index 000000000000..cce08265ad13 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/8.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/8/ +- /zh-cn/docs3-v2/java-sdk/faq/6/8/ +- /zh-cn/overview/mannual/java-sdk/faq/6/8/ +description: 6-8 - 返回数据解码失败 +linkTitle: 6-8 - 返回数据解码失败 +title: 6-8 - 返回数据解码失败 +type: docs +weight: 8 +--- + + + + + + + +### 可能的原因 + +返回数据格式错误或解码失败 + +### 排查和解决步骤 + +可通过 debug/warn 日志模式，输出具体服务类名称和返回的消息及堆栈信息。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/9.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/9.md new file mode 100644 index 000000000000..9ad290c6237d --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/9.md @@ -0,0 +1,28 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/9/ +- /zh-cn/docs3-v2/java-sdk/faq/6/9/ +- /zh-cn/overview/mannual/java-sdk/faq/6/9/ +description: 6-9 - 序列号ID存在重复 +linkTitle: 6-9 - 服务端连接失败 +title: 6-9 - 序列号ID存在重复 +type: docs +weight: 9 +--- + + + + + + + +### 可能的原因 + +1. 返回了一个空对象。 +2. 自定义序列号类，`org.apache.dubbo.common.serialize.Serialization#getContentTypeId` 与系统内置存在重复， +此时在加载时，以首个加载到的 SPI 实例为准。其他项将跳过。 + +### 排查和解决步骤 + +1. 检查返回结果。 +2. 内置值可参考类 `org.apache.dubbo.common.serialize.Constants` diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/_index.md new file mode 100644 index 000000000000..c998a9712a62 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/6/_index.md @@ -0,0 +1,11 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/6/ +- /zh-cn/docs3-v2/java-sdk/faq/6/ +- /zh-cn/overview/mannual/java-sdk/faq/6/_index/ +description: 6 - 网络传输层 +linkTitle: 6 - 网络传输层 +title: 6 - 网络传输层 +type: docs +weight: 6 +--- diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/1.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/1.md new file mode 100644 index 000000000000..2757de9f90cb --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/1.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/7/1/ +- /zh-cn/docs3-v2/java-sdk/faq/7/1/ +- /zh-cn/overview/mannual/java-sdk/faq/7/1/ +description: 7-1 - QOS 已关闭 +linkTitle: 7-1 - QOS 已关闭 +title: 7-1 - QOS 已关闭 +type: docs +weight: 1 +--- + + + + + + +### 可能的原因 + +QOS 已关闭 + +### 排查和解决步骤 + + +> 请参考[QOS 操作手册](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/)。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/2.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/2.md new file mode 100644 index 000000000000..06dfa2b102ff --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/2.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/7/2/ +- /zh-cn/docs3-v2/java-sdk/faq/7/2/ +- /zh-cn/overview/mannual/java-sdk/faq/7/2/ +description: 7-2 - QOS 已开启 +linkTitle: 7-2 - QOS 已开启 +title: 7-2 - QOS 已开启 +type: docs +weight: 2 +--- + + + + + + +### 可能的原因 + +QOS 已开启，默认为开启状态。 + +### 排查和解决步骤 + + +> 请参考[QOS 操作手册](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/)。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/3.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/3.md new file mode 100644 index 000000000000..f9175cf1a4db --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/3.md @@ -0,0 +1,26 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/7/3/ +- /zh-cn/docs3-v2/java-sdk/faq/7/3/ +- /zh-cn/overview/mannual/java-sdk/faq/7/3/ +description: 7-3 - 设置超时时间的警告百分比值 +linkTitle: 7-3 - 设置超时时间的警告百分比值 +title: 7-3 - 设置超时时间的警告百分比值 +type: docs +weight: 3 +--- + + + + + + +## 可能的原因 + +QOS 设置超时时间的警告百分比值, 默认为0.75。修改后，控制台会打印此消息。 + +## 排查和解决步骤 + + +请参考 QOS 操作手册[性能采样命令](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/profiler/)。 +
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/4.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/4.md new file mode 100644 index 000000000000..fd8fc540bee9 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/4.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/7/4/ +- /zh-cn/docs3-v2/java-sdk/faq/7/4/ +- /zh-cn/overview/mannual/java-sdk/faq/7/4/ +description: 7-4 - QOS 服务启动失败 +linkTitle: 7-4 - QOS 服务启动失败 +title: 7-4 - QOS 服务启动失败 +type: docs +weight: 4 +--- + + + + + + +### 可能的原因 + +QOS 参数值未正确设置。主要参数有 `qos.host` 和 `qos.port` + +### 排查和解决步骤 + + +> 请参考QOS 操作手册[QOS 概述](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/overview/)。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/5.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/5.md new file mode 100644 index 000000000000..b9726dd07e8d --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/5.md @@ -0,0 +1,26 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/7/5/ +- /zh-cn/docs3-v2/java-sdk/faq/7/5/ +- /zh-cn/overview/mannual/java-sdk/faq/7/5/ +description: 7-5 - QOS 命令未找到 +linkTitle: 7-5 - QOS 命令未找到 +title: 7-5 - QOS 命令未找到 +type: docs +weight: 5 +--- + + + + + + +### 可能的原因 + +QOS 命令拼写错误。 + +## 排查和解决步骤 + +QOS 命令不存在。 + +> 请参考 QOS 操作手册[基础命令手册](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/command/)。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/6.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/6.md new file mode 100644 index 000000000000..83c49e4df379 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/6.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/7/6/ +- /zh-cn/docs3-v2/java-sdk/faq/7/6/ +- /zh-cn/overview/mannual/java-sdk/faq/7/6/ +description: 7-6 - QOS 发生未知异常 +linkTitle: 7-6 - QOS 发生未知异常 +title: 7-6 - QOS 发生未知异常 +type: docs +weight: 6 +--- + + + + + + +### 可能的原因 + +QOS 发生未知异常 + +### 排查和解决步骤 + +1. 检查当前请求的服务是否可正常访问。 +2. 可能由于某些原因，未能正确加载或返回 `CommandContext` 实例。可根据控制台的错误提醒信息，进行排查定位。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/7.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/7.md new file mode 100644 index 000000000000..5ac45a2ee3bb --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/7.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/7/7/ +- /zh-cn/docs3-v2/java-sdk/faq/7/7/ +- /zh-cn/overview/mannual/java-sdk/faq/7/7/ +description: 7-7 - QOS 无权限访问 +linkTitle: 7-7 - QOS 无权限访问 +title: 7-7 - QOS 无权限访问 +type: docs +weight: 7 +--- + + + + + + +### 可能的原因 + +本次 QoS 请求无权限访问对应的资源，通常出现在有恶意攻击的场景下 + +### 排查和解决步骤 + +检查请求是否是预期发生的，如果非预期请检查是否有恶意攻击源。 +> 如果是预期的，请参考 [QoS 安全](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/overview/#%E5%AE%89%E5%85%A8) 一文配置对应的权限信息。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/_index.md new file mode 100644 index 000000000000..6b3aef9e5110 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/7/_index.md @@ -0,0 +1,11 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/7/ +- /zh-cn/docs3-v2/java-sdk/faq/7/ +- /zh-cn/overview/mannual/java-sdk/faq/7/_index/ +description: 7 - QoS 插件模块 +linkTitle: 7 - QoS 插件模块 +title: 7 - QoS 插件模块 +type: docs +weight: 7 +--- diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/1.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/1.md new file mode 100644 index 000000000000..c57fa729d91b --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/1.md @@ -0,0 +1,28 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/81/1/ +- /zh-cn/docs3-v2/java-sdk/faq/81/1/ +- /zh-cn/overview/mannual/java-sdk/faq/81/1/ +description: 81-1 - ZK 启动异常 +linkTitle: 81-1 - ZK 启动异常 +title: 81-1 - ZK 启动异常 +type: docs +weight: 1 +--- + + + + + + +### 可能的原因 + +1. zk 的服务端版本与客户端版本存在不兼容问题，无法进行连接。 +2. zk 服务未正常启动或防火墙等原因不能对外提供服务。 + +### 排查和解决步骤 + +1. 确认客户端版本与服务端版本一致。 +2. zk 能够正常启动或对外能够提供正常服务。 + +可通过一些第三方的工具或者`jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/2.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/2.md new file mode 100644 index 000000000000..d6b530687d25 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/2.md @@ -0,0 +1,25 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/81/2/ +- /zh-cn/docs3-v2/java-sdk/faq/81/2/ +- /zh-cn/overview/mannual/java-sdk/faq/81/2/ +description: 81-2 - ZK 销毁异常 +linkTitle: 81-2 - ZK 销毁异常 +title: 81-2 - ZK 销毁异常 +type: docs +weight: 2 +--- + + + + + + +### 可能的原因 + +当前实例已销毁完成。 +网络或已断开。 + +### 排查和解决步骤 + +可通过一些第三方的工具或者 `jstack [PID] > jstack.log` 分析堆栈信息，进行定位。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/3.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/3.md new file mode 100644 index 000000000000..56acd1c8048a --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/3.md @@ -0,0 +1,26 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/81/3/ +- /zh-cn/docs3-v2/java-sdk/faq/81/3/ +- /zh-cn/overview/mannual/java-sdk/faq/81/3/ +description: 81-3 - 通过url无法下载文件 +linkTitle: 81-3 - 通过url无法下载文件 +title: 81-3 - 通过url无法下载文件 +type: docs +weight: 3 +--- + + + + + + +### 可能的原因 + +1. url 映射文件不存在。 +2. url 无法连接。 + +### 排查和解决步骤 + +1. 检查 url 映射文件是否存在。 +2. 通过浏览器或其他工具，能否正常访问。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/4.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/4.md new file mode 100644 index 000000000000..1fb0738db147 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/4.md @@ -0,0 +1,30 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/81/4/ +- /zh-cn/docs3-v2/java-sdk/faq/81/4/ +- /zh-cn/overview/mannual/java-sdk/faq/81/4/ +description: 81-4 - 嵌入式ZooKeeper运行异常 +linkTitle: 81-4 - 嵌入式ZooKeeper运行异常 +title: 81-4 - 嵌入式ZooKeeper运行异常 +type: docs +weight: 4 +--- + + + + + + +### 可能的原因 + +1. ZooKeeper 服务运行异常或宕机。 +2. Zookeeper 客户端版本与服务端启动版本不兼容，无法连接。 +3. 应用服务器与 ZooKeeper 服务连接中断。 +4. 受限防火墙或第三方防护工具。 + +### 排查和解决步骤 + +1. 检查 ZooKeeper 服务及所在服务器健康状态。 +2. 检查 Zookeeper 客户端版本与服务端启动版本是否存在兼容问题，保持版本一致。 +3. 检查应用服务器与 ZooKeeper 服务端口是否通畅。 +4. 检查防火墙或第三方防护工具设置，是否已禁止。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/_index.md new file mode 100644 index 000000000000..3afa03d52492 --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/81/_index.md @@ -0,0 +1,18 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/81/ +- /zh-cn/docs3-v2/java-sdk/faq/81/ +- /zh-cn/overview/mannual/java-sdk/faq/81/_index/ +description: 81 - 单元测试辅助模块（注册中心） +linkTitle: 81 - 单元测试辅助模块（注册中心） +title: 81 - 单元测试辅助模块（注册中心） +type: docs +weight: 81 +--- + + + + + + +这里主要是 `dubbo-test` 模块中用于测试注册中心模块的代码的相关错误码。 diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/99/0.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/99/0.md similarity index 87% rename from content/zh-cn/overview/mannual/java-sdk/faq/99/0.md rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/99/0.md index 3a5b968ed78c..fa86ec7a4f07 100644 --- a/content/zh-cn/overview/mannual/java-sdk/faq/99/0.md +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/99/0.md @@ -1,7 +1,8 @@ --- aliases: - - /zh/docs3-v2/java-sdk/faq/99/0/ - - /zh-cn/docs3-v2/java-sdk/faq/99/0/ +- /zh/docs3-v2/java-sdk/faq/99/0/ +- /zh-cn/docs3-v2/java-sdk/faq/99/0/ +- /zh-cn/overview/mannual/java-sdk/faq/99/0/ description: 99-0 - 内部未知错误 linkTitle: 99-0 - 内部未知错误 title: 99-0 - 内部未知错误 @@ -26,4 +27,4 @@ Dubbo 内部的未知错误。 5. 如果都没解决，请尽可能做出一个复现该问题的最小 Demo，之后到 [GitHub Issue Tracker](https://github.com/apache/dubbo/issues) 下发 Issue。 > 另请参阅 -[配置项手册](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) \ No newline at end of file +[配置项手册](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties/) diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/99/1.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/99/1.md new file mode 100644 index 000000000000..56fb31b83cea --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/99/1.md @@ -0,0 +1,27 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/99/1/ +- /zh-cn/docs3-v2/java-sdk/faq/99/1/ +- /zh-cn/overview/mannual/java-sdk/faq/99/1/ +description: 99-1 - 程序被打断 +linkTitle: 99-1 - 程序被打断 +title: 99-1 - 程序被打断 +type: docs +weight: 2 +--- + + + + + +Dubbo 内部的未知错误。 + +### 可能的原因 + +程序收到来自 JVM 层面的打断通知，被迫停止阻塞等待 + +### 排查和解决步骤 + +此异常通常发生在线程池关闭或者应用关闭的过程中。 +请检查是否影响业务正常使用，如无影响可以忽略，如果有影响请参照对应的排查手册。 +更多的排查思路可以参考 [99-0](../0/) 一文。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/99/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/99/_index.md new file mode 100644 index 000000000000..54769f408c6f --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/99/_index.md @@ -0,0 +1,11 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/99/ +- /zh-cn/docs3-v2/java-sdk/faq/99/ +- /zh-cn/overview/mannual/java-sdk/faq/99/_index/ +description: 99 - 其它未知错误 +linkTitle: 99 - 其它未知错误 +title: 99 - 其它未知错误 +type: docs +weight: 99 +--- diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/_index.md new file mode 100755 index 000000000000..d1a247a7db2b --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/_index.md @@ -0,0 +1,18 @@ +--- +aliases: +- /zh/docs3-v2/java-sdk/faq/ +- /zh-cn/docs3-v2/java-sdk/faq/ +- /zh-cn/overview/mannual/java-sdk/faq/_index/ +description: 错误码 FAQ +linkTitle: 错误码 FAQ +title: 错误码 FAQ +type: docs +weight: 199 +--- + + + + + + +这里主要是提供 Java SDK 中各个错误码的可能原因和解决方法。 diff --git a/content/zh-cn/overview/mannual/java-sdk/faq/intro.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/intro.md similarity index 90% rename from content/zh-cn/overview/mannual/java-sdk/faq/intro.md rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/intro.md index 9a68d87c8bc9..b6603302232c 100644 --- a/content/zh-cn/overview/mannual/java-sdk/faq/intro.md +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/faq/intro.md @@ -1,7 +1,9 @@ --- aliases: - - /zh/docs3-v2/java-sdk/faq/intro/ - - /zh-cn/docs3-v2/java-sdk/faq/intro/ +- /zh/docs3-v2/java-sdk/faq/intro/ +- /zh-cn/docs3-v2/java-sdk/faq/intro/ +- /zh-cn/overview/mannual/java-sdk/faq/intro/ +- /zh-cn/overview/java-sdk/reference-manual/faq/intro/ description: 错误码机制的介绍 linkTitle: 错误码机制的介绍 title: 错误码机制的介绍 @@ -48,4 +50,4 @@ void warn(String code, String cause, String extendedInformation, String msg, Thr 其中 code 指错误码，cause 指可能的原因（即 caused by... 后面所接的文字），extendedInformation 作为补充信息，直接附加在 caused by 这句话的后面。 -> 对于 error 级别也做了相同的扩展。 \ No newline at end of file +> 对于 error 级别也做了相同的扩展。 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/graalvm/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/graalvm/_index.md index 7d0272061f8a..035bda8d933b 100644 --- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/graalvm/_index.md +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/graalvm/_index.md @@ -4,9 +4,8 @@ aliases: - /zh-cn/docs3-v2/java-sdk/reference-manual/graalvm/ description: "" hide_summary: true -linkTitle: Dubbo 集成 Graalvm参考手册 +linkTitle: GraalVM title: Dubbo 集成 Graalvm参考手册 -toc_hide: true type: docs weight: 9 --- diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/support-graalvm.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/graalvm/support-graalvm.md similarity index 80% rename from content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/support-graalvm.md rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/graalvm/support-graalvm.md index 93cf7934cfe0..947998df91a5 100644 --- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/support-graalvm.md +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/graalvm/support-graalvm.md @@ -2,20 +2,23 @@ aliases: - /zh/docs3-v2/java-sdk/advanced-features-and-usage/performance/support-graalvm/ - /zh-cn/docs3-v2/java-sdk/advanced-features-and-usage/performance/support-graalvm/ -description: Dubbo 支持 GraalVM Native Image + - /zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/support-graalvm/ +description: "Dubbo AOT 技术详解，如何使用 GraalVM Native Image 实现 Dubbo 应用静态化。" linkTitle: 支持 GraalVM Native Image -title: 支持 Graal VM +title: "Dubbo AOT -- 如何使用 GraalVM Native Image 实现 Dubbo 应用静态化" type: docs weight: 40 --- +在 Dubbo 3.3.0 版本中，我们正式发布了 Dubbo AOT 静态化解决方案。本文档将介绍将介绍如何借助 Dubbo AOT 技术将应用接入 GraalVM Native Image，将应用编译为 Native 二进制包的流程以及目前支持的组件。 - - -## 功能说明 -Dubbo3.2 支持 Native-Image 文档, 本文档将介绍将 dubbo3.x 项目接入 GraalVM Native Image，进行 native-image 编译为二进制的流程以及目前支持的组件。 +{{% alert title="Dubbo GraalVM 适配文档可能更新滞后" color="warning" %}} +由于 Dubbo AOT 技术发展迅速，本文档内容可能无法总是保持及时更新，请结合以下内容了解最新内容与使用方式： +* 示例项目源码 +* 博客文章与演讲 关于 GraalVm 的更多信息可以阅读 https://www.graalvm.org/docs/getting-started/container-images/ 此文档。 +{{% /alert %}} ## 使用场景 - 本机映像编译：将应用程序预编译为本机映像，缩短启动时间并减少内存使用。 @@ -188,29 +191,29 @@ dubbo: ### 序列化组件 -| 组件名称 | 所需的插件 | 插件版本 | 备注 | -| ------------ | ------------------- | --------------------------------------- | ---------------------------- | -| FastJson2 | dubbo-maven-plugin | 3.3.0-beta.1-SNAPSHOT (Preview)及其以上 | | -| JDK | native-maven-plugin | 0.9.24 及其以上 | | -| Hessian-Lite | | | 对JDK 17支持不友好，暂不支持 | +| 组件名称 | 所需的插件 | 插件版本 | 备注 | +| ------------ | ------------------- |-------------| ---------------------------- | +| FastJson2 | dubbo-maven-plugin | 3.3.0 及其以上 | | +| JDK | native-maven-plugin | 0.9.24 及其以上 | | +| Hessian-Lite | | | 对JDK 17支持不友好，暂不支持 | ### 注册中心组件 | 组件名称 | 所需的插件 | 插件版本 | 备注 | | --------- | ------------------ | ------------------------------- | ------------------------ | -| Zookeeper | dubbo-maven-plugin | 3.3.0-beta.1-SNAPSHOT (Preview) | 仅支持Zookeeper Curator5 | +| Zookeeper | dubbo-maven-plugin | 3.3.0 | 仅支持Zookeeper Curator5 | ### 元数据中心组件 | 组件名称 | 所需的插件 | 插件版本 | 备注 | | --------- | ------------------ | ------------------------------- | ------------------------ | -| Zookeeper | dubbo-maven-plugin | 3.3.0-beta.1-SNAPSHOT (Preview) | 仅支持Zookeeper Curator5 | +| Zookeeper | dubbo-maven-plugin | 3.3.0 | 仅支持Zookeeper Curator5 | ### 配置中心组件 -| 组件名称 | 所需的插件 | 插件版本 | 备注 | -| --------- | ------------------ | ------------------------------- | ------------------------ | -| Zookeeper | dubbo-maven-plugin | 3.3.0-beta.1-SNAPSHOT (Preview) | 仅支持Zookeeper Curator5 | +| 组件名称 | 所需的插件 | 插件版本 | 备注 | +| --------- | ------------------ |-------| ------------------------ | +| Zookeeper | dubbo-maven-plugin | 3.3.0 | 仅支持Zookeeper Curator5 | ### 可观测性组件 diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/merics/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/merics/_index.md new file mode 100644 index 000000000000..40b7c93713bc --- /dev/null +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/merics/_index.md @@ -0,0 +1,11 @@ +--- +aliases: + - /zh/docs3-v2/java-sdk/reference-manual/mesh/ + - /zh-cn/docs3-v2/java-sdk/reference-manual/mesh/ +description: Dubbo Mesh 使用指南 +linkTitle: Mesh手册 +title: Mesh手册 +type: docs +weight: 98 +toc_hide: true +--- diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/meter.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/merics/meter.md similarity index 98% rename from content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/meter.md rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/merics/meter.md index 5c6f9c735327..efe8534aa980 100644 --- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/meter.md +++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/merics/meter.md @@ -31,7 +31,7 @@ Dubbo Metrics 的总体设计请参考 [可观测性 Metrics Proposal](/zh-cn/ov ``` * 完整示例请参见 dubbo-samples-metrics-spring-boot -* 完整配置参数请参见 [Metrics 配置项手册](../../../reference-manual/config/properties/#metrics) +* 完整配置参数请参见 [Metrics 配置项手册](/zh-cn/overview/mannual/java-sdk/reference-manual/config/properties//) ## 实现原理解析 @@ -328,4 +328,4 @@ public class TimeWindowQuantile { 其中，address、port、url 均是可选项，如不配置则 Admin 使用默认约定值。 -> 用户直接在Dubbo配置文件中配置Prometheus Pushgateway的地址即可，如
+
+1. 提供者实例同时监听两个端口 20880 和 50051
+2. 同一个实例，会在注册中心注册两条地址 url
+3. 不同的消费端可以选择以不同协议调用同一个提供者发布的服务
+
+对于消费端而言，如果用户没有明确配置，默认情况下框架会自动选择 `dubbo` 协议调用。Dubbo 框架支持配置通过哪个协议访问服务，如 `@DubboReference(protocol="tri")`，或者在 application.yml 配置文件中指定全局默认值：
+
+```yaml
+dubbo:
+ consumer:
+ protocol: tri
+```
+
+### 单端口多协议
+
+除了以上发布多个端口、注册多条 url 到注册中心的方式。对于 dubbo、triple 这两个内置协议，框架提供了在单个端口上同时发布 dubbo 和 triple 协议的能力。这对于老用户来说是一个非常重要的能力，因为它可以做到不增加任何负担的情况下，让使用 dubbo 协议的用户可以额外发布 triple 协议，这样当所有的应用都实现多协议发布之后，我们就可以设置消费端去通过 triple 协议发起调用了。
+
+
+
+单端口多协议的基本配置如下：
+
+ ```yaml
+ dubbo:
+ protocol:
+ name: dubbo
+ ext-protocol: tri
+ ```
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/others/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/others/_index.md
new file mode 100755
index 000000000000..ae16b6a99d5a
--- /dev/null
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/others/_index.md
@@ -0,0 +1,11 @@
+---
+aliases:
+ - /zh/docs3-v2/java-sdk/reference-manual/protocol/
+ - /zh-cn/docs3-v2/java-sdk/reference-manual/protocol/
+ - /zh/overview/what/ecosystem/protocol/
+description: Dubbo RPC 协议指南
+linkTitle: 扩展实现
+title: Dubbo 提供的更多 RPC 扩展协议实现
+type: docs
+weight: 100
+---
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/others/hessian.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/others/hessian.md
new file mode 100644
index 000000000000..e22981e1813b
--- /dev/null
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/others/hessian.md
@@ -0,0 +1,87 @@
+---
+aliases:
+ - /zh/docs3-v2/java-sdk/reference-manual/protocol/hessian/
+ - /zh-cn/docs3-v2/java-sdk/reference-manual/protocol/hessian/
+ - /zh-cn/overview/mannual/java-sdk/reference-manual/protocol/hessian/
+description: Hessian协议
+linkTitle: Hessian协议
+title: Hessian协议
+type: docs
+weight: 10
+---
+
+
+
+
+## 特性说明
+Hessian 协议用于集成 Hessian 的服务，Hessian 底层采用 Http 通讯，采用 Servlet 暴露服务，Dubbo 缺省内嵌 Jetty 作为服务器实现。
+
+[Hessian](http://hessian.caucho.com) 是 Caucho 开源的一个 RPC 框架，其通讯效率高于 WebService 和 Java 自带的序列化。
+
+* 连接个数：多连接
+* 连接方式：短连接
+* 传输协议：HTTP
+* 传输方式：同步传输
+* 序列化：Hessian二进制序列化
+* 适用范围：传入传出参数数据包较大，提供者比消费者个数多，提供者压力较大，可传文件。
+* 适用场景：页面传输，文件传输，或与原生hessian服务互操作。
+
+Dubbo 的 Hessian 协议可以和原生 Hessian 服务互操作，即：
+
+* 提供者用 Dubbo 的 Hessian 协议暴露服务，消费者直接用标准 Hessian 接口调用，
+* 或者提供方用标准 Hessian 暴露服务，消费方用 Dubbo 的 Hessian 协议调用。
+
+#### 约束
+* 参数及返回值需实现 `Serializable` 接口。
+* 参数及返回值不能自定义实现 `List`, `Map`, `Number`, `Date`, `Calendar` 等接口，只能用 JDK 自带的实现，因为 hessian 会做特殊处理，自定义实现类中的属性值都会丢失。
+
+## 使用场景
+hessian是一个轻量级的RPC服务，是基于Binary-RPC协议实现的，序列化与反序列化实例。
+
+
+## 使用方式
+
+### 依赖
+
+从 Dubbo 3 开始，Hessian 协议已经不再内嵌在 Dubbo 中，需要单独引入独立的[模块](/zh-cn/download/spi-extensions/#dubbo-rpc)。
+```xml
+
+
+##### CLIENT_STREAM(客户端流)
+客户端流式 RPC 类似于 Unary RPC，不同之处在于客户端向服务器发送消息流（通常包含多条消息）而不是单个消息。服务器以单个消息（以及其状态详细信息和可选的尾部元数据）进行响应 - 通常但不一定是在接收到所有客户端消息之后。
+
+
+
+##### BIDIRECTIONAL_STREAM(双向流)
+在双向流 RPC 中，客户端发起方法调用，服务端则接收客户端调用中的元数据、方法名称和截止日期，这样就启动了一次完整的双向流通道。服务器可以选择返回其初始元数据，或者等待客户端开始流式传输消息。
+
+客户端和服务器端的流处理是特定于应用程序的。由于这两个流是独立的，客户端和服务器可以按任何顺序读取和写入消息。例如，服务器可以等到收到客户端的所有消息后再写消息，或者服务器和客户端可以玩“乒乓球”——服务器收到一个请求，然后发回一个响应，然后客户端根据响应发送另一个请求等等。
+
+
+
+{{% alert title="流的语义保证" color="primary" %}}
+- 提供消息边界，可以方便地对消息单独处理
+- 严格有序，发送端的顺序和接收端顺序一致
+- 全双工，发送不需要等待
+- 支持取消和超时
+{{% /alert %}}
+
+关于 Streaming 的具体使用示例，请参见 [Streaming 流式通信](../triple/streaming/)。
+
+## REST 支持
+通过为 Java 接口增加注解，可以发布 rest 风格的 triple 服务，可在这里查看 具体代码示例
+
+{{% alert title="流的语义保证" color="info" %}}
+目前 rest 协议仅支持 `Java 接口` 服务定义模式，相比于 dubbo 和 triple 协议，rest 场景下我们需要为 Interface 增加注解，支持 Spring MVC、JAX_RS 两种注解。
+{{% /alert %}}
+
+如果你记得 triple 协议原生支持 cURL 访问，即类似 `org.apache.dubbo.springboot.demo.idl.Greeter/greet` 的访问模式。通过增加以上注解后，即可为 triple 服务额外增加 REST 风格访问支持，如 `demo/greet` 的 GET 请求。
+
+### Spring Web注解
+Spring MVC 服务定义范例：
+```java
+@RestController
+@RequestMapping("/demo")
+public interface DemoService {
+ @GetMapping(value = "/hello")
+ String sayHello();
+}
+```
+
+### JAX-RS注解
+JAX-RS 服务定义范例：
+```java
+@Path("/demo")
+public interface DemoService {
+ @GET
+ @Path("/hello")
+ String sayHello();
+}
+```
+
+## 异常类型传递
+Provider 端产生的业务异常需要作为响应值返回给 Consumer 客户端，消费端可以使用 `try catch` 捕获可能抛出的异常：
+
+```java
+try {
+ greeterProxy.echo(REQUEST_MSG);
+} catch (YourCustomizedException e) {
+ e.printStackTrace();
+ } catch (RpcException e) {
+ e.printStackTrace();
+}
+```
+
+Dubbo 框架会在 provider 侧根据如下流程发送异常类型响应，不是所有业务异常都能原样返回，对于无法处理的异常类型，都会被框架封装成 `RpcException` 类型返回：
+
+
+
+## 附录
+### Protobuf与Java原生数据类型对比
+
+对于计划从 Java 接口完全迁移到 Protobuf 的用户而言，这里的信息可供参考，用以了解类型迁移可能面临的限制，Protobuf 描述语言是否能完全描述 Java 数据类型。
+
+本文对比了Protobuf和Java Interface这2种IDL的差异，帮助Dubbo协议开发者了解Protobuf，为后续转到Triple协议和Grpc协议做铺垫。
+
+#### 1. 数据类型
+
+##### 1.1. 基本类型
+
+| ptoto类型 | java类型 |
+| ---- | ---- |
+double | double
+float | float
+int32 | int
+int64 | long
+uint32 | int[注]
+uint64 | long[注]
+sint32 | int
+sint64 | long
+fixed32 | int[注]
+fixed64 | long[注]
+sfixed32 | int
+sfixed64 | long
+bool | boolean
+string | String
+bytes | ByteString
+
+{{% alert title="注意" color="primary" %}}
+在Java中，无符号的32位和64位整数使用它们的有符号对数来表示，顶部位只存储在符号位中。
+{{% /alert %}}
+
+#### 2. 复合类型
+
+##### 2.1. 枚举
+
+* 原始pb代码
+
+```java.
+enum TrafficLightColor {
+ TRAFFIC_LIGHT_COLOR_INVALID = 0;
+ TRAFFIC_LIGHT_COLOR_UNSET = 1;
+ TRAFFIC_LIGHT_COLOR_GREEN = 2;
+ TRAFFIC_LIGHT_COLOR_YELLOW = 3;
+ TRAFFIC_LIGHT_COLOR_RED = 4;
+}
+```
+
+* 生成的java代码
+
+
+
+> 枚举是常量，因此采用大写
+##### 2.2. 数组
+
+* 原始pb代码
+
+```java
+message VipIDToRidReq {
+ repeated uint32 vipID = 1;
+}
+```
+
+* 生成的java代码
+
+
+
+> 底层实际上是1个ArrayList
+##### 2.3. 集合
+
+PB不支持无序、不重复的集合，只能 ``借用数组实现``，需要 ``自行去重``。
+
+##### 2.4. 字典
+
+* 原始pb代码
+
+```java
+message BatchOnlineRes {
+ map- * Sends a greeting - *- */ - HelloReply sayHello(HelloRequest request); - - } -``` - -5. 创建 Provider -```java - public static void main(String[] args) throws InterruptedException { - ServiceConfig
- * Sends greeting by stream - *- */ - StreamObserver
+
+应用级服务发现的地址结构比接口级更精简，它以应用名为粒度分发地址列表。服务提供者启动时，向 `/services/app` 目录下写入自己的 URL 地址，相比于接口级别的 URL，应用级别的 URL 更简单，只包含一些实例级别的参数，如 `tri://ip:port?region=hangzhou`。
+
+可通过 `registry.group` 设置 zookeeper 的根节点，如设置 `registry.group=dubbo` 后，地址根节点变为 `/dubbo`。不配置将使用默认的 `/services` 根节点。在与 Spring Cloud Gateway 共用情况下，使用 `/services` 根节点会导致 dubbo 地址被 gateway 消费，此时可考虑设置独立 group。
+
+{{% alert title="注意" color="info" %}}
+在应用级服务发现模型中，接口级别的配置信息由消费者与提供者之间自行协商同步，不再由注册中心负责同步，从而大大减少了注册中心地址同步压力。
+{{% /alert %}}
+
+#### 3.2.2 接口应用映射
+在应用级服务发现中，zookeeper 注册中心还会存储一份额外的元数据，用于解决 `接口名到应用名` 之间的映射关系，其存储结构如下：
+
+
+
+service1 节点的 value 值是应用列表，可通过 `get /dubbo/mapping/service1` 查看：app1,app2
+
+#### 3.2.3 元数据
+如果您用的是应用级服务发现的集中式元数据模式（默认是点对点的元数据模式，可通过 `dubbo.registry.metadata-type=remote` 开启）。在开启集中式元数据模式后，zookeeper 中还会发现以下节点内容：
+
+
+
+每个 revision 下是该应用的部署元数据信息，包含完整的接口服务列表及其配置信息。
+
+
+
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/zookeeper/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/zookeeper/_index.md
deleted file mode 100644
index e0ae4594904d..000000000000
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/zookeeper/_index.md
+++ /dev/null
@@ -1,142 +0,0 @@
----
-aliases:
- - /zh/docs3-v2/java-sdk/reference-manual/registry/zookeeper/
- - /zh-cn/docs3-v2/java-sdk/reference-manual/registry/zookeeper/
- - /zh-cn/overview/what/ecosystem/registry/zookeeper/
-description: Zookeeper 注册中心的基本使用和工作原理。
-linkTitle: Zookeeper
-title: Zookeeper
-type: docs
-weight: 2
----
-
-
-
-
-
-
-## 1 前置条件
-* 了解 [Dubbo 基本开发步骤](../../../quick-start/spring-boot/)
-* 安装并启动 [Zookeeper](https://zookeeper.apache.org/)
-
-## 2 使用说明
-在此查看[完整示例代码](https://github.com/apache/dubbo-samples/tree/master/3-extensions/registry/dubbo-samples-zookeeper)
-
-### 2.1 增加 Maven 依赖
-```xml
-