多模块Spring Boot项目Cosmos DB依赖及ServiceBus配置异常排查

核心问题 #

你引入了不必要的Azure Service Bus/EventHubs、JMS相关依赖，导致Spring Boot自动配置尝试初始化ServiceBus相关组件，但缺少对应的配置属性，从而抛出NamespaceProperties Bean找不到的错误。你原本仅需连接Cosmos DB，这些额外依赖完全冗余。

步骤1：清理冗余依赖 #

移除所有与ServiceBus、EventHubs、JMS相关的依赖，仅保留Cosmos DB必备的starter：

// 仅保留这一行即可
implementation 'com.azure.spring:spring-cloud-azure-starter-data-cosmos:4.3.0'

// 以下依赖全部删除
// implementation "javax.jms:javax.jms-api:2.0.1"
// implementation 'org.apache.qpid:qpid-jms-client:0.60.1'
// implementation 'com.azure.spring:spring-messaging-azure-servicebus:4.3.0'
// implementation 'com.azure.spring:spring-messaging-azure-eventhubs:4.3.0'

步骤2：正确管理Azure Spring依赖版本 #

spring-cloud-azure-dependencies应放在dependencyManagement块中统一管理版本，而非作为业务依赖引入，避免版本冲突：

dependencyManagement {
    imports {
        mavenBom "com.azure.spring:spring-cloud-azure-dependencies:4.3.0"
    }
}

步骤3：按需保留安全依赖 #

若你的Cosmos DB连接无需OAuth2客户端认证，可移除以下安全依赖进一步简化配置：

// 若不需要则删除
// implementation "org.springframework.boot:spring-boot-starter-security"
// implementation "org.springframework.security:spring-security-oauth2-client"

步骤4：确保自动配置完全排除（可选） #

若清理依赖后仍有ServiceBus自动配置触发，在启动类显式排除：

@SpringBootApplication(exclude = {AzureServiceBusMessagingAutoConfiguration.class})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

或在application.properties中添加：

spring.autoconfigure.exclude=com.azure.spring.cloud.autoconfigure.servicebus.AzureServiceBusMessagingAutoConfiguration

验证配置 #

完成以上步骤后，确保配置文件仅包含Cosmos DB相关配置，示例：

spring.cloud.azure.cosmos.endpoint=你的Cosmos DB端点
spring.cloud.azure.cosmos.key=你的Cosmos DB密钥
spring.cloud.azure.cosmos.database=目标数据库名称

内容的提问来源于stack exchange，提问作者prguptadev