Fix sub-level event-hub-name override for Spring Event Hubs starter

[j7nw4r]

Fixes #43593.

Problem

When using spring-cloud-azure-starter-eventhubs with both base-level and sub-level event-hub-name configured:

spring:
  cloud:
    azure:
      eventhubs:
        namespace: evhns-sample
        event-hub-name: bbbb
        consumer:
          consumer-group: $Default
          event-hub-name: aaaa
        producer:
          event-hub-name: aaaa

the injected EventHubProducerClient / EventHubConsumerClient connect to bbbb instead of the override aaaa.

Root cause

The property merge in AzureEventHubsProperties.build{Consumer,Producer}Properties() is correct (sub-level wins). The defect is in the autoconfiguration path selection:

AzureEventHubs{Consumer,Producer}ClientConfiguration only switches to the Dedicated (per-section builder) inner configuration when connection-string or namespace is set under the sub-prefix. With only event-hub-name overridden, it falls through to the Shared configuration, which reuses the parent EventHubClientBuilder already pinned to bbbb. EventHubClientBuilder is per-hub, so the shared path cannot represent a different hub.

Fix

Add "event-hub-name" to the @ConditionalOnMissingProperty / @ConditionalOnAnyProperty name arrays in both consumer and producer client configurations. Any sub-level event-hub-name override now routes to the Dedicated path, which already calls build{Consumer,Producer}Properties() with the correct precedence — no merge-logic changes required.

Tests

• Added consumerEventHubNameOverrideShouldConfigureDedicated and producerEventHubNameOverrideShouldConfigureDedicated reproducing the issue scenario and asserting the merged properties resolve to the override and to the parent namespace.
• Pruned the obsolete sub-scenarios in eventHubNameAndConsumerGroupProvidedShouldConfigure / eventHubNameProvidedShouldConfigure that were asserting the old (buggy) behavior of no inner config being created when only consumer.event-hub-name / producer.event-hub-name was set.
• All 100 EventHub-related tests in spring-cloud-azure-autoconfigure pass locally.

How to verify

mvn -f sdk/spring/spring-cloud-azure-autoconfigure/pom.xml `
    -Dtest='AzureEventHubsConsumerClientConfigurationTests,AzureEventHubsProducerClientConfigurationTests,AzureEventHubsAutoConfigurationTests' `
    -DfailIfNoTests=false test

[Copilot]

Pull request overview

This PR updates Azure Spring Event Hubs autoconfiguration so that sub-level event-hub-name overrides (under spring.cloud.azure.eventhubs.consumer / .producer) correctly trigger the dedicated builder path, ensuring producer/consumer clients connect to the overridden hub rather than the base hub. It also includes a separate checkpointing fix in the Event Hubs libraries to ensure offsetString is propagated and persisted correctly.

Changes:

• Spring autoconfigure: route to dedicated consumer/producer configuration when sub-level event-hub-name is set, and add regression tests for the override scenario.
• Event Hubs client: propagate EventData.offsetString into Checkpoint in EventContext.updateCheckpointAsync() (with a regression unit test).
• Blob checkpoint store: prefer Checkpoint.offsetString, and fall back to deprecated Checkpoint.offset when offsetString is missing (with expanded unit coverage + changelog updates).

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
sdk/spring/spring-cloud-azure-autoconfigure/src/main/java/com/azure/spring/cloud/autoconfigure/implementation/eventhubs/AzureEventHubsProducerClientConfiguration.java	Ensures sub-level producer event-hub-name triggers the dedicated configuration path.
sdk/spring/spring-cloud-azure-autoconfigure/src/main/java/com/azure/spring/cloud/autoconfigure/implementation/eventhubs/AzureEventHubsConsumerClientConfiguration.java	Ensures sub-level consumer event-hub-name triggers the dedicated configuration path.
sdk/spring/spring-cloud-azure-autoconfigure/src/test/java/com/azure/spring/cloud/autoconfigure/implementation/eventhubs/AzureEventHubsProducerClientConfigurationTests.java	Adds a regression test asserting dedicated config is used when producer event-hub-name overrides the base value.
sdk/spring/spring-cloud-azure-autoconfigure/src/test/java/com/azure/spring/cloud/autoconfigure/implementation/eventhubs/AzureEventHubsConsumerClientConfigurationTests.java	Adds a regression test asserting dedicated config is used when consumer event-hub-name overrides the base value.
sdk/spring/spring-cloud-azure-autoconfigure/CHANGELOG.md	Documents the Spring Event Hubs override bug fix (#43593).
sdk/eventhubs/azure-messaging-eventhubs/src/main/java/com/azure/messaging/eventhubs/models/EventContext.java	Propagates EventData.offsetString into the checkpoint built by updateCheckpointAsync().
sdk/eventhubs/azure-messaging-eventhubs/src/test/java/com/azure/messaging/eventhubs/models/EventContextTest.java	Adds a regression test verifying offsetString is set on the checkpoint passed to CheckpointStore.
sdk/eventhubs/azure-messaging-eventhubs/CHANGELOG.md	Documents the EventContext.updateCheckpointAsync() checkpointing fix (#46752).
sdk/eventhubs/azure-messaging-eventhubs-checkpointstore-blob/src/main/java/com/azure/messaging/eventhubs/checkpointstore/blob/BlobCheckpointStore.java	Updates validation and persistence to prefer offsetString and fall back to deprecated offset.
sdk/eventhubs/azure-messaging-eventhubs-checkpointstore-blob/src/test/java/com/azure/messaging/eventhubs/checkpointstore/blob/BlobCheckpointStoreTests.java	Adds unit tests covering fallback/preference/validation behaviors for offsetString vs offset.
sdk/eventhubs/azure-messaging-eventhubs-checkpointstore-blob/CHANGELOG.md	Documents the Blob checkpoint store fallback fix (#46752).

[rujche]

/azp run java - spring - tests

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).