spring-cloud / spring-cloud/spring-cloud-consul
Spring Cloud Consul config watch keeps generating warning messages
Nobody has claimed this yet.
- Dominant language
- Java
- Stars
- 822
- Forks
- 539
- Avg merge
- 9h 31m
- Merged PRs (30d)
- 7
Description
Describe the bug
Spring Cloud Consul config 5.0.0 keeps giving us warnings messages when enabling config watches for configuration, and the config data can be found with config/application/data(data is the key).
[
{
"key": "config/",
"flags": 0,
"value": ""
},
{
"key": "config/application/",
"flags": 0,
"value": ""
},
{
"key": "config/application/data",
"flags": 0,
"value": "bG9nZ2luZzoKICBsZXZlbDoKICAgIG9yZy5zcHJpbmdmcmFtZXdvcmsuY29yZS5lbnY6IERFQlVH"
},
{
"key": "config/gateway/",
"flags": 0,
"value": ""
},
{
"key": "config/gateway/data",
"flags": 0,
"value": ""
}
]
Sample
The logs are as below. and if set fail fast, It will produce errors. and actually, we had provided the config items in consul KV.
2026-01-26T18:44:20.470+08:00 WARN 36468 --- [gateway] [TaskScheduler-1] o.s.cloud.consul.config.ConfigWatch : Error querying consul Key/Values for context 'config/gateway/'. Message: I/O error on GET request for "http://localhost:8500/v1/kv/config/gateway/": null
2026-01-26T18:44:30.475+08:00 WARN 36468 --- [gateway] [ctor-http-nio-5] r.netty.http.client.HttpClientConnect : [74757339-1, L:/127.0.0.1:62403 - R:localhost/127.0.0.1:8500] The connection observed an error
io.netty.handler.timeout.ReadTimeoutException
2026-01-26T18:44:30.475+08:00 WARN 36468 --- [gateway] [TaskScheduler-1] o.s.cloud.consul.config.ConfigWatch : Error querying consul Key/Values for context 'config/application/'. Message: I/O error on GET request for "http://localhost:8500/v1/kv/config/application/": null
2026-01-26T18:45:10.488+08:00 WARN 36468 --- [gateway] [ctor-http-nio-7] r.netty.http.client.HttpClientConnect : [61d86986-1, L:/127.0.0.1:62448 - R:localhost/127.0.0.1:8500] The connection observed an error
io.netty.handler.timeout.ReadTimeoutException
2026-01-26T18:45:10.489+08:00 WARN 36468 --- [gateway] [TaskScheduler-1] o.s.cloud.consul.config.ConfigWatch : Error querying consul Key/Values for context 'config/gateway/'. Message: I/O error on GET request for "http://localhost:8500/v1/kv/config/gateway/": null
2026-01-26T18:45:20.504+08:00 WARN 36468 --- [gateway] [ctor-http-nio-2] r.netty.http.client.HttpClientConnect : [df3e3ad3-25, L:/127.0.0.1:62388 - R:localhost/127.0.0.1:8500] The connection observed an error
io.netty.handler.timeout.ReadTimeoutException
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the attached gateway.zip reproducer and the ConfigWatch warnings for the config/application/ and config/gateway/ contexts. Reproduce the Consul KV setup shown in the issue, then trace why the watch requests hit ReadTimeoutException despite existing data. Done means the watches retrieve the provided configuration without repeated warning messages.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- java, spring
- Domain
- backend, cloud
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100