启动时检查-依赖的服务是否可用

服务启动检查-特性说明

  1. Dubbo缺省会在启动时检查依赖的服务是否可用，不可用时会抛出异常，阻止Spring初始化完成，以便上线时，能及早发现问题，默认check=“true”。
  2. 通过check="false"关闭检查，比如，测试时，有些服务不关心，必须有一方先启动，或者针对于相关的dubbo3所对应的微服务利链路种形成了环路依赖或者相互引用关系。

注意：如果你的Spring容器是懒加载的，或者通过API编程延迟引用服务，请关闭check，否则服务临时不可用时，会抛出异常，拿到null引用，如果check=“false”，总是会返回引用，当服务恢复时，能自动连上。

服务启动检查-使用场景

  • 单向依赖：有依赖关系（建议默认设置）和无依赖关系（可以设置 check=false）
  • 相互依赖：即循环依赖，(不建议设置 check=false)
  • 延迟加载处理，check只用来启动时检查，运行时没有相应的依赖仍然会报错。

启动时检查-使用方式

通过spring配置文件

关闭某个服务的启动时检查
  • 默认情况下，当没有提供者时会发生报错，但是如果设置为false，则会忽略检查操作接口是否含有实现服务提供类。
<dubbo:reference interface="com.xxx.TestService" check="false" />
关闭所有服务的启动时检查
  • 默认情况下，针对于整个消费服务所有的接口当没有提供者时会发生报错，但是如果设置为false，则会忽略所有检查操作接口是否含有实现服务提供类。
<dubbo:consumer check="false" />
关闭注册中心启动时检查
  • 注册订阅失败时报错
<dubbo:registry check="false" />

通过dubbo.properties文件

dubbo.reference.com.xxx.TestService.check=false
dubbo.consumer.check=false
dubbo.registry.check=false

通过 -D 参数配置

java -Ddubbo.reference.com.foo.BarService.check=false
java -Ddubbo.consumer.check=false 
java -Ddubbo.registry.check=false

通过Yaml配置文件

dubbo:
	consumer:
		check: false
	registry:
		check: false
	reference:
		com.xxx.TestService
			check:false

配置的含义

  • dubbo.reference.com.foo.BarService.check，覆盖 com.xxx.TestService的 reference 的 check 值，就算配置中有声明，也会被覆盖。
  • dubbo.consumer.check=false，是设置reference的check 的缺省值，如果配置中有显式的声明，如：<dubbo:reference check=“true”/>，不会受影响。
  • dubbo.registry.check=false，前面两个都是指订阅成功，但提供者列表是否为空是否报错，如果注册订阅失败时，也允许启动，需使用此选项，将在后台定时重试。