如何创建不关联特定实体的Spring Data @Repository？

针对你需要创建不绑定特定实体、仅归集@Query注解查询的Repository需求，以下是两种可行的解决办法：

方案1：继承Repository<Void, Void>标记接口 #

直接继承Spring Data的基础Repository接口，使用Void作为实体和ID类型，这样既让Spring Data识别并生成代理类（使@Query生效），又不会继承JpaRepository的CRUD方法：

@Repository
public interface UsageReports extends Repository<Void, Void> {
    // 原生查询示例
    @Query(nativeQuery = true, value = "SELECT COUNT(*) FROM user_usage")
    long getUserUsageCount();

    // JPQL查询示例
    @Query("SELECT u.name FROM User u WHERE u.active = true")
    List<String> getActiveUserNames();
}

方案2：自定义无实体绑定的Repository基类 #

如果有多个这类查询Repository，可以先定义一个通用基类，用@NoRepositoryBean标记避免Spring为其生成实例，再让具体查询Repository继承它：

@NoRepositoryBean
public interface BaseQueryRepository extends Repository<Void, Void> {
    // 可添加通用查询逻辑（可选）
}

@Repository
public interface UsageReports extends BaseQueryRepository {
    @Query(nativeQuery = true, value = "SELECT SUM(usage_hours) FROM device_usage")
    double getTotalDeviceUsageHours();
}

补充：处理自定义结果集 #

如果查询返回非实体的自定义数据，可通过构造函数映射或接口投影接收结果：

构造函数映射示例 #

// 自定义结果DTO
public class UsageStats {
    private long totalUsers;
    private double totalUsage;

    public UsageStats(long totalUsers, double totalUsage) {
        this.totalUsers = totalUsers;
        this.totalUsage = totalUsage;
    }

    // getter方法
}

// Repository中的查询
@Query(nativeQuery = true, value = "SELECT COUNT(*) AS totalUsers, SUM(usage_hours) AS totalUsage FROM user_usage")
UsageStats getUsageStats();

接口投影示例 #

// 投影接口
public interface UsageStatsProjection {
    long getTotalUsers();
    double getTotalUsage();
}

// Repository中的查询
@Query(nativeQuery = true, value = "SELECT COUNT(*) AS totalUsers, SUM(usage_hours) AS totalUsage FROM user_usage")
UsageStatsProjection getUsageStats();

原方案问题说明 #

• 方案1未继承Spring Data的Repository标记接口，Spring不会为其生成代理类，导致@Query注解无效。
• 方案2绑定了具体实体，会继承JpaRepository的CRUD方法，存在误调用风险。

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