Kafka Error INVALID_UPDATE_VERSION
Error code 95 · Non-retriable Admin
The given update version was invalid.
Common Causes
- UpdateFeatures request attempted to downgrade a feature version below the current finalized version, which is not permitted for non-downgradeable features
- Attempted to set a feature version higher than the maximum supported by one or more brokers currently in the cluster
- KRaft metadata version update was requested with a version that skips required intermediate versions
Solutions
- Check the currently finalized feature version and the max supported version on all brokers before attempting an upgrade: kafka-features.sh describe
- Upgrade all brokers to a version that supports the target feature level before finalizing the metadata version bump
- For metadata version downgrades, verify the feature is marked as downgradeable; if it is not, keep the current finalized version and plan a roll-forward rather than forcing a downgrade
Diagnostic Commands
# Check finalized feature versions in cluster
kafka-features.sh --bootstrap-server localhost:9092 describe
# Check broker metadata/feature API versions
kafka-broker-api-versions.sh --bootstrap-server localhost:9092 | grep -i 'metadata\|feature'Related APIs
This error can be returned by: UpdateFeatures
Debugging Kafka errors? Conduktor Console gives you real-time visibility into your cluster. Explore all errors in the Error Decoder.