Spring Boot整合JNOSQL（CDI库）时出现KeyValueTemplate Bean未找到问题

首先，你的猜想完全正确：JNoSQL Artemis默认依赖CDI容器来自动创建KeyValueTemplate这类Bean，但Spring的IoC容器无法识别CDI的自动装配逻辑——所以你手动声明BucketManager后，Spring并不知道要自动生成KeyValueTemplate。下面是两种可行的解决方案，从手动配置到更简洁的starter方式，还有替代库推荐。

方案一：纯Spring手动配置 #

1. 清理依赖 #

先移除Java EE API依赖，避免和Spring的注解体系冲突：

// 删掉这行：implementation group: 'javax', name: 'javaee-web-api', version: '8.0'

2. 重写配置类（替换CDI注解为Spring的@Bean） #

把原来的配置类改成完全Spring风格，并且手动声明KeyValueTemplate及其依赖的核心Bean：

package com.max.backend.service.jnosql;

import jakarta.nosql.Settings;
import jakarta.nosql.keyvalue.BucketManager;
import org.eclipse.jnosql.artemis.keyvalue.DefaultKeyValueTemplate;
import org.eclipse.jnosql.artemis.keyvalue.KeyValueTemplate;
import org.eclipse.jnosql.artemis.keyvalue.KeyValuePersistenceContext;
import org.eclipse.jnosql.artemis.keyvalue.KeyValueEntityConverter;
import org.eclipse.jnosql.diana.dynamodb.keyvalue.DynamoDBBucketManagerFactory;
import org.eclipse.jnosql.diana.dynamodb.keyvalue.DynamoDBKeyValueConfiguration;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.util.HashMap;
import java.util.Map;

@Configuration
public class MyDatabase {

    @Bean
    public DynamoDBKeyValueConfiguration dynamoDBConfig() {
        return new DynamoDBKeyValueConfiguration();
    }

    @Bean
    public DynamoDBBucketManagerFactory dynamoDBManagerFactory(DynamoDBKeyValueConfiguration config) {
        Map<String, Object> settings = new HashMap<>();
        settings.put("dynamodb.endpoint", "http://localhost:8073");
        settings.put("dynamodb.region", "eu-west-1");
        settings.put("dynamodb.awsaccesskey", "myLocalKeyId");
        settings.put("dynamodb.secretaccess", "myLocalSecretAccessKey");
        return config.get(Settings.of(settings));
    }

    @Bean
    public BucketManager bucketManager(DynamoDBBucketManagerFactory managerFactory) {
        return managerFactory.getBucketManager("initiatives");
    }

    // 手动创建KeyValueTemplate核心Bean
    @Bean
    public KeyValueTemplate keyValueTemplate(BucketManager bucketManager, 
                                             KeyValuePersistenceContext persistenceContext) {
        return new DefaultKeyValueTemplate(persistenceContext, bucketManager);
    }

    // 配置KeyValueTemplate依赖的上下文和转换器
    @Bean
    public KeyValueEntityConverter keyValueConverter() {
        return new KeyValueEntityConverter();
    }

    @Bean
    public KeyValuePersistenceContext keyValuePersistenceContext(KeyValueEntityConverter converter) {
        return new KeyValuePersistenceContext(converter);
    }
}

3. 优化服务类的注入方式 #

Spring推荐构造注入（比字段注入更安全、便于测试），你可以修改服务类：

package com.max.backend.service;

import com.max.backend.model.TestEntry;
import jakarta.nosql.mapping.keyvalue.KeyValueTemplate;
import org.springframework.stereotype.Service;
import java.util.Optional;

@Service
public class TestEntryService {

    private final KeyValueTemplate template;

    // Spring 4.3+支持无@Autowired的构造注入
    public TestEntryService(KeyValueTemplate template) {
        this.template = template;
    }

    public void put(TestEntry user) {
        template.put(user);
    }

    public Optional<TestEntry> find(String id) {
        return template.get(id, TestEntry.class);
    }
}

方案二：使用JNoSQL Spring Boot Starter（更简洁） #

JNoSQL其实提供了Spring Boot Starter，可以自动配置所有需要的Bean，省去手动配置的麻烦：

1. 替换依赖 #

把原来的artemis-keyvalue依赖换成starter：

// 替换：implementation group: 'org.eclipse.jnosql.artemis', name: 'artemis-keyvalue', version: '1.0.0-b1'
implementation group: 'org.eclipse.jnosql.artemis', name: 'artemis-spring-boot-starter-keyvalue', version: '1.0.0-b1'

2. 配置application.properties #

直接在配置文件中填写DynamoDB参数：

# JNoSQL配置
jnosql.keyvalue.database=initiatives

# DynamoDB配置
jnosql.dynamodb.endpoint=http://localhost:8073
jnosql.dynamodb.region=eu-west-1
jnosql.dynamodb.awsaccesskey=myLocalKeyId
jnosql.dynamodb.secretaccess=myLocalSecretAccessKey

这样Spring Boot会自动创建BucketManager、KeyValueTemplate等Bean，你直接注入即可，不需要写任何配置类。

替代库推荐 #

如果JNoSQL在Spring生态中的适配体验不符合预期，推荐几个更成熟的替代方案：

• Spring Data DynamoDB：专门为DynamoDB打造的Spring Data实现，完全兼容Spring的注解和生态，文档、社区支持更完善。
• AWS SDK for Java v2 + Spring Boot Starter：官方SDK配合Spring Boot自动配置，对AWS服务的支持最全面，适合需要深度定制DynamoDB操作的场景。
• Spring Data JDBC + DynamoDB JDBC Driver：如果想保持通用的Spring Data风格，但这种方式对DynamoDB的NoSQL特性支持有限，适合简单场景。

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