配置属性

下面列出了配置属性。

名称 默认值 描述

spring.cloud.compatibility-verifier.compatible-boot-versions

Spring Boot 依赖项的默认接受版本。如果您不想指定具体值,可以为补丁版本设置 {@code x}。例如:{@code 3.4.x}

spring.cloud.compatibility-verifier.enabled

false

启用 Spring Cloud 兼容性验证的创建。

spring.cloud.config.allow-override

true

指示是否可以使用 {@link #isOverrideSystemProperties() systemPropertiesOverride} 的标志。设置为 false 以防止用户意外更改默认值。默认为 true。

spring.cloud.config.initialize-on-context-refresh

false

在上下文刷新事件中初始化引导配置的标志。默认为 false。

spring.cloud.config.override-none

false

指示当 {@link #setAllowOverride(boolean) allowOverride} 为 true 时,外部属性应具有最低优先级,并且不应覆盖任何现有属性源(包括本地配置文件)的标志。默认为 false。这仅在使用 config first bootstrap 时有效。

spring.cloud.config.override-system-properties

true

指示外部属性是否应覆盖系统属性的标志。默认为 true。

spring.cloud.decrypt-environment-post-processor.enabled

true

启用 DecryptEnvironmentPostProcessor。

spring.cloud.discovery.client.composite-indicator.enabled

true

启用发现客户端组合健康指标。

spring.cloud.discovery.client.health-indicator.enabled

true

spring.cloud.discovery.client.health-indicator.include-description

false

spring.cloud.discovery.client.health-indicator.use-services-query

true

指标是否应使用 {@link DiscoveryClient#getServices} 检查其健康状况。当设置为 {@code false} 时,指标改为使用较轻的 {@link DiscoveryClient#probe()}。这在服务数量众多的大型部署中非常有用,因为返回的服务数量会使操作变得不必要地繁重。

spring.cloud.discovery.client.simple.instances

spring.cloud.discovery.client.simple.local.host

spring.cloud.discovery.client.simple.local.instance-id

spring.cloud.discovery.client.simple.local.metadata

spring.cloud.discovery.client.simple.local.port

0

spring.cloud.discovery.client.simple.local.secure

false

spring.cloud.discovery.client.simple.local.service-id

spring.cloud.discovery.client.simple.local.uri

spring.cloud.discovery.client.simple.order

spring.cloud.discovery.enabled

true

启用发现客户端健康指标。

spring.cloud.features.enabled

true

启用特性端点。

spring.cloud.httpclientfactories.apache.enabled

true

启用 Apache Http Client 工厂 Bean 的创建。

spring.cloud.httpclientfactories.ok.enabled

true

启用 OK Http Client 工厂 Bean 的创建。

spring.cloud.hypermedia.refresh.fixed-delay

5000

spring.cloud.hypermedia.refresh.initial-delay

10000

spring.cloud.inetutils.default-hostname

localhost

默认主机名。在出现错误时使用。

spring.cloud.inetutils.default-ip-address

127.0.0.1

默认 IP 地址。在出现错误时使用。

spring.cloud.inetutils.ignored-interfaces

将被忽略的网络接口的 Java 正则表达式列表。

spring.cloud.inetutils.preferred-networks

将被优先考虑的网络地址的 Java 正则表达式列表。

spring.cloud.inetutils.timeout-seconds

1

计算主机名的超时时间(秒)。

spring.cloud.inetutils.use-only-site-local-interfaces

false

是否仅使用具有站点本地地址的接口。有关详细信息,请参阅 {@link InetAddress#isSiteLocalAddress()}。

spring.cloud.loadbalancer.call-get-with-request-on-delegates

true

如果此标志设置为 {@code true},则将实现 {@code ServiceInstanceListSupplier#get(Request request)} 方法,以便在可从 {@code DelegatingServiceInstanceListSupplier} 赋值的类中调用 {@code delegate.get(request)},这些类尚未实现该方法,但不包括 {@code CachingServiceInstanceListSupplier} 和 {@code HealthCheckServiceInstanceListSupplier},它们应直接放在执行网络实例检索的提供程序层次结构之后,在执行任何基于请求的过滤之前,默认为 {@code true}。

spring.cloud.loadbalancer.clients

spring.cloud.loadbalancer.eager-load.clients

spring.cloud.loadbalancer.health-check.initial-delay

0

健康检查调度的初始延迟值。

spring.cloud.loadbalancer.health-check.interval

25s

重新运行健康检查调度的间隔。

spring.cloud.loadbalancer.health-check.interval

25s

重新运行健康检查调度的间隔。

spring.cloud.loadbalancer.health-check.path

应进行健康检查请求的路径。可以按serviceId设置。也可以设置default值。如果没有设置,则将使用/actuator/health

spring.cloud.loadbalancer.health-check.port

应进行健康检查请求的路径。如果没有设置,则为服务实例中请求的服务可用的端口。

spring.cloud.loadbalancer.health-check.refetch-instances

false

指示实例是否应由HealthCheckServiceInstanceListSupplier重新获取。如果可以更新实例并且底层委托不提供持续的 flux,则可以使用此选项。

spring.cloud.loadbalancer.health-check.refetch-instances-interval

25s

重新获取可用服务实例的间隔。

spring.cloud.loadbalancer.health-check.repeat-health-check

true

指示健康检查是否应继续重复。如果定期重新获取实例,则将其设置为false可能很有用,因为每次重新获取也会触发健康检查。

spring.cloud.loadbalancer.health-check.update-results-list

true

指示{@code healthCheckFlux}是否应在每个已检索到的活动{@link ServiceInstance}上发出。如果设置为{@code false},则整个活动实例序列首先被收集到一个列表中,然后才发出。

spring.cloud.loadbalancer.hint

允许设置传递给 LoadBalancer 请求的<code>hint</code>的值,随后可在{@link ReactiveLoadBalancer}实现中使用。

spring.cloud.loadbalancer.hint-header-name

X-SC-LB-Hint

允许设置用于传递基于提示的服务实例过滤提示的标头的名称。

spring.cloud.loadbalancer.retry.backoff.enabled

false

指示是否应应用 Reactor 重试回退。

spring.cloud.loadbalancer.retry.backoff.jitter

0.5

用于设置RetryBackoffSpec.jitter

spring.cloud.loadbalancer.retry.backoff.max-backoff

Long.MAX 毫秒

用于设置RetryBackoffSpec.maxBackoff

spring.cloud.loadbalancer.retry.backoff.min-backoff

5 毫秒

用于设置RetryBackoffSpec#minBackoff

spring.cloud.loadbalancer.retry.enabled

true

启用负载均衡器重试。

spring.cloud.loadbalancer.retry.max-retries-on-next-service-instance

1

在下一个ServiceInstance上执行的重试次数。在每次重试调用之前都会选择一个ServiceInstance

spring.cloud.loadbalancer.retry.max-retries-on-same-service-instance

0

在同一个ServiceInstance上执行的重试次数。

spring.cloud.loadbalancer.retry.retry-on-all-exceptions

false

指示应尝试对所有异常进行重试,而不仅仅是retryableExceptions中指定的那些异常。

spring.cloud.loadbalancer.retry.retry-on-all-operations

false

指示应尝试对HttpMethod.GET以外的操作进行重试。

spring.cloud.loadbalancer.retry.retryable-exceptions

{}

应该触发重试的Throwable类的Set

spring.cloud.loadbalancer.retry.retryable-status-codes

{}

应该触发重试的状态码的Set

spring.cloud.loadbalancer.stats.micrometer.enabled

false

启用负载均衡请求的 Micrometer 指标。

spring.cloud.loadbalancer.sticky-session.add-service-instance-cookie

false

指示负载均衡器是否应添加包含新选择实例的 Cookie。

spring.cloud.loadbalancer.sticky-session.instance-id-cookie-name

sc-lb-instance-id

保存首选实例 ID 的 Cookie 名称。

spring.cloud.loadbalancer.subset.instance-id

确定性子集的实例 ID。如果未设置,将使用{@link IdUtils#getDefaultInstanceId(PropertyResolver)}。

spring.cloud.loadbalancer.subset.size

100

确定性子集的最大大小。

spring.cloud.loadbalancer.x-forwarded.enabled

false

启用 X-Forwarded Headers。

spring.cloud.openfeign.autoconfiguration.jackson.enabled

true

如果为 true,则将提供 PageJacksonModule 和 SortJacksonModule bean 用于 Jackson 页面解码。

spring.cloud.openfeign.circuitbreaker.alphanumeric-ids.enabled

false

如果为 true,则断路器 ID 将仅包含字母数字字符,以便可以通过配置属性进行配置。

spring.cloud.openfeign.circuitbreaker.enabled

false

如果为 true,则 OpenFeign 客户端将使用 Spring Cloud 断路器进行包装。

spring.cloud.openfeign.circuitbreaker.group.enabled

false

如果为 true,则 OpenFeign 客户端将使用带有分组的 Spring Cloud 断路器进行包装。

spring.cloud.openfeign.client.config

spring.cloud.openfeign.client.decode-slash

true

Feign 客户端默认不编码斜杠/字符。要更改此行为,请将decodeSlash设置为false

spring.cloud.openfeign.client.default-config

default

spring.cloud.openfeign.client.default-to-properties

true

spring.cloud.openfeign.client.refresh-enabled

false

启用 Feign 的选项值刷新功能。

spring.cloud.openfeign.compression.request.enabled

false

启用 Feign 发送的请求进行压缩。

spring.cloud.openfeign.compression.request.mime-types

[text/xml, application/xml, application/json]

支持的 MIME 类型列表。

spring.cloud.openfeign.compression.request.min-request-size

2048

最小阈值内容大小。

spring.cloud.openfeign.compression.response.enabled

false

启用 Feign 返回的响应进行压缩。

spring.cloud.openfeign.encoder.charset-from-content-type

false

指示是否应从{@code Content-Type}标头派生字符集。

spring.cloud.openfeign.http2client.enabled

false

启用 Feign 使用 Java 11 HTTP 2 客户端。

spring.cloud.openfeign.httpclient.connection-timeout

2000

spring.cloud.openfeign.httpclient.connection-timer-repeat

3000

spring.cloud.openfeign.httpclient.disable-ssl-validation

false

spring.cloud.openfeign.httpclient.follow-redirects

true

spring.cloud.openfeign.httpclient.hc5.connection-request-timeout

3

连接请求超时的默认值。

spring.cloud.openfeign.httpclient.hc5.connection-request-timeout-unit

连接请求超时单位的默认值。

spring.cloud.openfeign.httpclient.hc5.enabled

true

启用 Feign 使用 Apache HTTP Client 5。

spring.cloud.openfeign.httpclient.hc5.pool-concurrency-policy

池并发策略。

spring.cloud.openfeign.httpclient.hc5.pool-reuse-policy

池连接重用策略。

spring.cloud.openfeign.httpclient.hc5.socket-timeout

5

套接字超时的默认值。

spring.cloud.openfeign.httpclient.hc5.socket-timeout-unit

套接字超时单位的默认值。

spring.cloud.openfeign.httpclient.http2.version

HTTP_2

配置此客户端用于与远程服务器通信的协议。使用{@link HttpClient.Version}的{@link String}值。

spring.cloud.openfeign.httpclient.max-connections

200

spring.cloud.openfeign.httpclient.max-connections-per-route

50

spring.cloud.openfeign.httpclient.ok-http.protocols

配置此客户端用于与远程服务器通信的协议。使用{@link Protocol}的{@link String}值。

spring.cloud.openfeign.httpclient.ok-http.read-timeout

60 秒

{@link OkHttpClient} 读取超时;默认为 60 秒。

spring.cloud.openfeign.httpclient.time-to-live

900

spring.cloud.openfeign.httpclient.time-to-live-unit

spring.cloud.openfeign.lazy-attributes-resolution

false

将 @FeignClient 属性解析模式切换为延迟模式。

spring.cloud.openfeign.micrometer.enabled

true

启用 Feign 的 Micrometer 功能。

spring.cloud.openfeign.oauth2.clientRegistrationId

提供要与 OAuth2 一起使用的 clientId。

spring.cloud.openfeign.oauth2.enabled

false

启用用于管理 OAuth2 访问令牌的 Feign 拦截器。

spring.cloud.openfeign.okhttp.enabled

false

启用 Feign 使用 OK HTTP 客户端。

spring.cloud.refresh.additional-property-sources-to-retain

在刷新期间要保留的其他属性源。通常只保留系统属性源。此属性允许保留属性源,例如由 EnvironmentPostProcessors 创建的属性源。

spring.cloud.refresh.enabled

true

启用刷新范围和相关功能的自动配置。

spring.cloud.refresh.extra-refreshable

true

要后处理到刷新范围的 bean 的其他类名。

spring.cloud.refresh.never-refreshable

true

要从不刷新或重新绑定 bean 的类名的逗号分隔列表。

spring.cloud.refresh.on-restart.enabled

true

启动时启用刷新上下文。

spring.cloud.service-registry.auto-registration.enabled

true

服务自动注册是否启用。默认为 true。

spring.cloud.service-registry.auto-registration.fail-fast

false

如果没有 AutoServiceRegistration,启动是否失败。默认为 false。

spring.cloud.service-registry.auto-registration.register-management

true

是否将管理注册为服务。默认为 true。

spring.cloud.util.enabled

true

启用 Spring Cloud 实用程序 bean 的创建。