配置属性

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

3.4.x

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。这仅在使用配置优先引导时生效。

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

启用 features 端点。

spring.cloud.httpclientfactories.apache.enabled

true

启用 Apache Http Client factory bean 的创建。

spring.cloud.httpclientfactories.ok.enabled

true

启用 OK Http Client factory 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.cache.caffeine.spec

用于创建缓存的规范。有关规范格式的更多详细信息，请参阅 CaffeineSpec。

spring.cloud.loadbalancer.cache.capacity

256

初始缓存容量，以 int 表示。

spring.cloud.loadbalancer.cache.enabled

true

启用 Spring Cloud LoadBalancer 缓存机制。

spring.cloud.loadbalancer.cache.ttl

35s

生存时间 (TTL) - 从记录写入开始计时，之后缓存条目过期，表示为 {@link Duration}。属性 {@link String} 必须符合 Spring Boot <code>StringToDurationConverter</code> 中指定的相应语法。@see <a href= "https://github.com/spring-projects/spring-boot/blob/master/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/convert/StringToDurationConverter.java">StringToDurationConverter.java</a>

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.configurations

default

启用预定义的 LoadBalancer 配置。

spring.cloud.loadbalancer.eager-load.clients

客户端名称。

spring.cloud.loadbalancer.enabled

true

启用 Spring Cloud LoadBalancer。

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

0

HealthCheck 调度器的初始延迟值。

spring.cloud.loadbalancer.health-check.interval

25s

重新运行 HealthCheck 调度器的间隔。

spring.cloud.loadbalancer.health-check.interval

25s

重新运行 HealthCheck 调度器的间隔。

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

允许设置用于传递提示以进行基于提示的服务实例过滤的 header 名称。

spring.cloud.loadbalancer.retry.avoid-previous-instance

true

如果在 classpath 中存在 Spring-Retry，则启用使用 RetryAwareServiceInstanceListSupplier 包装 ServiceInstanceListSupplier bean。

spring.cloud.loadbalancer.retry.backoff.enabled

false

指示是否应应用 Reactor Retry 退避策略。

spring.cloud.loadbalancer.retry.backoff.jitter

0.5

用于设置 RetryBackoffSpec.jitter。

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

Long.MAX ms

用于设置 RetryBackoffSpec.maxBackoff。

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

5 ms

用于设置 RetryBackoffSpec#minBackoff。

spring.cloud.loadbalancer.retry.enabled

true

启用 LoadBalancer 重试。

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.service-discovery.timeout

调用服务发现的超时时间（Duration）的字符串表示。

spring.cloud.loadbalancer.stats.include-path

true

指示是否应将 {@code path} 添加到指标中的 {@code uri} 标签。当使用 {@link RestTemplate} 执行具有高基数路径的负载均衡请求时，建议将其设置为 {@code false}。

spring.cloud.loadbalancer.stats.micrometer.enabled

false

启用 Spring Cloud LoadBalancer Micrometer 统计信息。

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

false

指示 LoadBalancer 是否应添加一个包含新选定实例的 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.loadbalancer.zone

Spring Cloud LoadBalancer 区域。

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

刷新期间要保留的额外属性源。通常只保留系统属性源。此属性允许保留由 EnvironmentPostProcessors 等创建的属性源。

spring.cloud.refresh.enabled

true

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

spring.cloud.refresh.extra-refreshable

true

要后处理到刷新范围内的 bean 的额外 bean 名称或类名称。

spring.cloud.refresh.never-refreshable

true

逗号分隔的 bean 名称或类名称列表，这些 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 的创建。