Spring Boot3+Java21集成DynamoDB：Repository Bean未找到问题排查

一、最初找不到 TenantRepository Bean 的原因及解决 #

你最初的配置存在两个核心问题：

1. 版本不兼容：com.github.derjust:spring-data-dynamodb:5.1.0 仅适配 Spring Data 2.x，而 Spring Boot 3.x 依赖的是 Spring Data 3.x，版本不匹配导致无法生成 Repository 代理类。
2. 缺少必要注解：未启用 DynamoDB Repository 的自动扫描机制。

临时修复（针对旧 SDK 配置） #

• 升级 spring-data-dynamodb 到支持 Spring Boot 3.x 的版本（最低 6.0.0），同时替换为 AWS SDK v2 依赖。
• 在配置类或主启动类上添加 @EnableDynamoDBRepositories 注解，指定 Repository 所在包：

@Configuration
@EnableDynamoDBRepositories(basePackages = "com.middleware")
public class DynamoDBConfig {
    @Bean
    public DynamoDbClient dynamoDbClient() {
        return DynamoDbClient.builder()
                .region(Region.US_EAST_1) // 替换为你的AWS区域
                // 本地测试时添加
                // .endpointOverride(URI.create("http://localhost:8000"))
                .build();
    }
}

• 确保实体类正确标注 DynamoDB 映射注解：

@DynamoDBTable(tableName = "Tenant")
@Data
public class Tenant {
    @DynamoDBHashKey
    private String id;
    // 其他字段添加@DynamoDBAttribute等对应注解
}

二、关于 JPA 与 DynamoDB 的兼容性问题 #

JPA 是关系型数据库的规范，DynamoDB 是非关系型 NoSQL 数据库，二者本质不兼容，不存在用 JPA 连接 DynamoDB 的说法。你混淆了 Spring Data JPA（用于关系型数据库）和 Spring Data DynamoDB（用于 DynamoDB 的 Spring Data 实现）的概念。

Spring Boot 3.x、Java 21 与 AWS SDK v2 完全兼容，以下是两种推荐的集成方案：

方案一：使用 AWS 官方 DynamoDB Enhanced Client（推荐） #

这是 AWS 官方维护的增强客户端，简化对象与 DynamoDB 表的映射，无需依赖第三方 Spring Data 实现。

Gradle 依赖配置

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    // AWS SDK v2 核心及增强客户端
    implementation 'software.amazon.awssdk:dynamodb'
    implementation 'software.amazon.awssdk:dynamodb-enhanced'
    // Spring Cloud AWS 自动配置（简化客户端初始化）
    implementation 'io.awspring.cloud:spring-cloud-starter-aws:3.0.1'
    
    implementation 'org.modelmapper:modelmapper:2.1.1'
    implementation 'org.springframework.boot:spring-boot-starter-hateoas'
    
    compileOnly 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}

配置文件（application.yml）

aws:
  region: us-east-1 # 替换为你的区域
  dynamodb:
    endpoint: http://localhost:8000 # 本地测试用，生产环境移除

实体类与 Repository 实现

// 实体类
@Data
@Table(name = "Tenant")
public class Tenant {
    @Id
    private TenantId id;
    
    @Attribute(name = "tenant_name")
    private String name;

    // 复合主键（如果需要）
    @Data
    public static class TenantId {
        @PartitionKey
        private String tenantId;
        // 排序键（可选）
        // @SortKey
        // private String subId;
    }
}

// Repository 层
@Repository
public class TenantRepository {
    private final DynamoDbTable<Tenant> tenantTable;

    // 注入增强客户端
    public TenantRepository(DynamoDbEnhancedClient enhancedClient) {
        this.tenantTable = enhancedClient.table("Tenant", TableSchema.fromBean(Tenant.class));
    }

    public void save(Tenant tenant) {
        tenantTable.putItem(tenant);
    }

    public Tenant findById(TenantId id) {
        return tenantTable.getItem(Key.builder()
                .partitionValue(id.getTenantId())
                // 有排序键的话添加 .sortValue(id.getSubId())
                .build());
    }

    // 自定义其他CRUD方法
}

方案二：使用适配 Spring Boot 3.x 的 Spring Data DynamoDB #

如果习惯 Spring Data 的 Repository 风格，可以使用升级后的第三方实现：

Gradle 依赖配置

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    // 支持Spring Boot3.x的版本
    implementation 'com.github.derjust:spring-data-dynamodb:6.2.0'
    implementation 'software.amazon.awssdk:dynamodb'
    
    implementation 'org.modelmapper:modelmapper:2.1.1'
    implementation 'org.springframework.boot:spring-boot-starter-hateoas'
    
    compileOnly 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}

配置类与 Repository 接口

@Configuration
@EnableDynamoDBRepositories(basePackages = "com.middleware")
public class DynamoDBConfig {
    @Bean
    public DynamoDbClient dynamoDbClient() {
        return DynamoDbClient.builder()
                .region(Region.US_EAST_1)
                .build();
    }
}

// Repository 接口（Spring Data自动实现）
public interface TenantRepository extends CrudRepository<Tenant, String> {
    // 自定义查询方法，比如
    Optional<Tenant> findByName(String name);
}

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