配置屬性

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。這僅在使用 config first 引導時生效。

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 工廠 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 DelegatingServiceInstanceListSupplier} 且尚未實現 {@code ServiceInstanceListSupplier#get(Request request)} 方法的類，該方法將呼叫 {@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.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

允許設定 <code>hint</code> 的值，該值會傳遞給 LoadBalancer 請求，隨後可在 {@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

啟用 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.stats.include-path

true

指示 {@code path} 是否應新增到指標中的 {@code uri} 標籤。當使用 {@link RestTemplate} 執行具有高基數路徑的負載均衡請求時，建議將其設定為 {@code false}。

spring.cloud.loadbalancer.stats.micrometer.enabled

false

為負載均衡請求啟用 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.openfeign.autoconfiguration.jackson.enabled

true

如果為 true，將為 Jackson 頁面解碼提供 PageJacksonModule 和 SortJacksonModule bean。

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

Socket 超時的預設值。

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

seconds

Socket 超時單位的預設值。

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

60s

{@link OkHttpClient} 讀取超時時間；預設為 60 秒。

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 屬性解析模式切換為 lazy。

spring.cloud.openfeign.micrometer.enabled

true

為 Feign 啟用 Micrometer 功能。

spring.cloud.openfeign.oauth2.clientRegistrationId

提供與 OAuth2 一起使用的 clientId。

spring.cloud.openfeign.oauth2.enabled

false

啟用 feign 攔截器以管理 oauth2 訪問令牌。

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 的額外 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。