配置属性
以下是配置属性的列表。
| 名称 | 默认 | 描述 |
|---|---|---|
| spring.cloud.compatibility-verifier.compatible-boot-versions | 4.0.x | Spring Boot 依赖的默认接受版本。如果您不想指定具体值,可以为补丁版本设置 {@code x}。例如:{@code 3.5.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 | 启用功能端点。 |
| 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.api-version.default | 设置每个请求应使用的默认版本。 | |
| spring.cloud.loadbalancer.api-version.fallback-to-available-instances | false | 指示当指定版本没有可用实例时,是否应返回所有可用实例。 |
| spring.cloud.loadbalancer.api-version.header | 使用指定名称的 HTTP 头部来获取版本。 | |
| spring.cloud.loadbalancer.api-version.media-type-parameters | 使用具有给定名称的媒体类型参数来获取版本。 | |
| spring.cloud.loadbalancer.api-version.path-segment | 使用给定索引处的路径段来获取版本。 | |
| spring.cloud.loadbalancer.api-version.query-parameter | 使用给定名称的查询参数来获取版本。 | |
| spring.cloud.loadbalancer.api-version.required | false | 指示每个请求是否需要包含API版本。 |
| 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 | 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 重新获取。如果实例可以更新且底层委托未提供持续的数据流,则可以使用此功能。 |
| 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 | 允许设置传递给负载均衡器请求的 hint 值,该值随后可在 {@link ReactiveLoadBalancer} 实现中使用。 | |
| spring.cloud.loadbalancer.hint-header-name | X-SC-LB-Hint | 允许设置用于传递基于提示的服务实例筛选提示的标头名称。 |
| 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 | 启用负载均衡器重试。 |
| 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.include-path | true | 指示是否应将 {@code path} 添加到指标中的 {@code uri} 标签。当使用 {@link RestTemplate} 执行具有高基数路径的负载均衡请求时,建议将其设置为 {@code false}。 |
| spring.cloud.loadbalancer.stats.micrometer.enabled | false | 为负载均衡请求启用微米级指标。 |
| 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 标头。 |
| spring.cloud.openfeign.autoconfiguration.jackson.enabled | true | 如果为 true,将提供 PageJacksonModule 和 SortJacksonModule bean 用于 Jackson 页面解码。 |
| spring.cloud.openfeign.circuitbreaker.alphanumeric-ids.enabled | true | 如果为 true,断路器 ID 将仅包含字母数字字符,以便通过配置属性进行配置。 |
| spring.cloud.openfeign.circuitbreaker.enabled | false | 如果为 true,OpenFeign 客户端将被 Spring Cloud CircuitBreaker 断路器包装。 |
| spring.cloud.openfeign.circuitbreaker.group.enabled | false | 如果为 true,OpenFeign 客户端将被包装在一个具有分组的 Spring Cloud CircuitBreaker 断路器内。 |
| 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.client.remove-trailing-slash | false | 如果为 {@code true},请求 URL 末尾的尾部斜杠将被移除。 |
| spring.cloud.openfeign.compression.request.content-encoding-types | 内容编码列表(适用的编码取决于所使用的客户端)。 | |
| 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对Java11 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 | minutes | 连接请求超时单位的默认值。 |
| spring.cloud.openfeign.httpclient.hc5.enabled | true | 启用Feign使用Apache HTTP Client 5。 |
| spring.cloud.openfeign.httpclient.hc5.pool-concurrency-policy | strict | 池并发策略。 |
| spring.cloud.openfeign.httpclient.hc5.pool-reuse-policy | fifo | 连接池复用策略。 |
| spring.cloud.openfeign.httpclient.hc5.socket-timeout | 5 | 套接字超时的默认值。 |
| spring.cloud.openfeign.httpclient.hc5.socket-timeout-unit | seconds | 套接字超时单位的默认值。 |
| 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.time-to-live | 900 | |
| spring.cloud.openfeign.httpclient.time-to-live-unit | seconds | |
| spring.cloud.openfeign.lazy-attributes-resolution | false | 将 @FeignClient 属性的解析模式切换为延迟模式。 |
| spring.cloud.openfeign.micrometer.enabled | true | 为Feign启用Micrometer功能。 |
| spring.cloud.openfeign.oauth2.client-registration-id | 用于检索 OAuth2 访问令牌的客户端注册 ID。如果未指定,将使用从 {@code url} 主机段检索到的 {@code serviceId}。这对于负载均衡的 Feign 客户端非常方便。对于非负载均衡的客户端,建议指定 {@code clientRegistrationId}。 | |
| spring.cloud.openfeign.oauth2.clientRegistrationId | 提供一个用于 OAuth2 的 clientId。 | |
| spring.cloud.openfeign.oauth2.enabled | false | 启用Feign拦截器以管理OAuth2访问令牌。 |
| 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 的创建。 |