启动时检查
启动时检查依赖服务是否可用
功能描述
默认情况下,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)