启动时检查

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

功能描述

默认情况下,Dubbo 会在启动时检查依赖服务是否可用,并在不可用时抛出异常,阻止 Spring 初始化完成,以便在上线时尽早发现问题。默认 check="true"

可以通过 check="false" 关闭检查。例如,在测试时,某些服务并不关心,或者存在循环依赖,其中一个必须先启动。

此外,如果您的 Spring 容器是延迟加载的,或者您通过 API 编程延迟引用服务,请关闭检查,否则当服务暂时不可用时,会抛出异常并获取空引用。如果 check="false",始终会返回引用,当服务恢复时,可以自动连接。

使用场景

  • 单向依赖:有依赖(推荐默认设置)和无依赖(可以设置 check=false)
  • 相互依赖:即循环依赖,(不建议设置 check=false)
  • 延迟加载处理

check 仅用于启动时检查,如果运行时没有相应的依赖,仍然会报错。

使用方法

通过 spring 配置文件

关闭服务的启动时检查

<dubbo:reference interface="com.foo.BarService" check="false" />

关闭所有服务的启动时检查

<dubbo:consumer check="false" />

关闭启动时注册中心检查

<dubbo:registry check="false" />

通过 dubbo.properties

dubbo.reference.com.foo.BarService.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

配置含义

dubbo.reference.com.foo.BarService.check,覆盖 com.foo.BarService 引用的 check 值,即使配置中存在语句,也会被覆盖。

dubbo.consumer.check=false 是设置引用的 check 的默认值。如果配置中存在显式语句,例如:<dubbo:reference check="true"/>,则不会受到影响。

dubbo.registry.check=false,前两者表示订阅成功,但无论提供者列表是否为空或是否报错,如果注册订阅失败,也允许启动,需要使用此选项,并在后台定期重试。


上次修改时间:2023 年 1 月 2 日:增强 en 文档 (#1798) (95a9f4f6c1c)