Spring Boot通用Repository含findByIdAndName方法启动报错解决方案咨询

方案1：拆分通用接口（推荐，类型安全） #

既然只有部分实体拥有name属性，最直接的方式是将带name相关查询的方法从通用仓库中拆分出来，创建专门的子接口，仅让需要该方法的自定义Repository继承它。

步骤1：重构基础通用仓库 #

保留无属性依赖的通用方法，移除findByIdAndName：

import java.util.Optional;
import org.springframework.data.repository.NoRepositoryBean;
import com.mobinets.nep.client.backend.repository.AbstractEntityRepository;

@NoRepositoryBean
public interface GenericCatalogRepository<E, ID> extends AbstractEntityRepository<E, ID> {
    // 存放所有实体都支持的通用方法
}

步骤2：创建带name属性的子接口 #

新增一个仅包含name相关查询的接口，继承基础通用仓库：

import java.util.Optional;
import org.springframework.data.repository.NoRepositoryBean;

@NoRepositoryBean
public interface NamedCatalogRepository<E, ID> extends GenericCatalogRepository<E, ID> {
    Optional<E> findByIdAndName(String id, String name);
}

步骤3：自定义Repository按需继承 #

• 拥有name属性的实体Repository继承NamedCatalogRepository：

public interface UserRepository extends NamedCatalogRepository<User, Long> {
    // 其他自定义方法
}

• 无name属性的实体Repository直接继承GenericCatalogRepository：

public interface ProductRepository extends GenericCatalogRepository<Product, Long> {
    // 其他自定义方法
}

这种方式能在启动时保证类型安全，Spring Data JPA只会为实际继承NamedCatalogRepository的Repository生成包含findByIdAndName的代理类，避免无name属性的实体触发解析错误。

方案2：动态查询适配（运行时兼容） #

如果不想拆分接口，可以通过Specification动态构建查询，在运行时判断实体是否拥有name属性，避免启动报错：

import java.util.Optional;
import org.springframework.data.jpa.domain.Specification;
import org.springframework.data.repository.NoRepositoryBean;
import com.mobinets.nep.client.backend.repository.AbstractEntityRepository;

@NoRepositoryBean
public interface GenericCatalogRepository<E, ID> extends AbstractEntityRepository<E, ID> {

    default Optional<E> findByIdAndName(String id, String name) {
        try {
            Specification<E> spec = (root, query, cb) -> 
                cb.and(
                    cb.equal(root.get("id"), id),
                    cb.equal(root.get("name"), name)
                );
            return findOne(spec);
        } catch (IllegalArgumentException e) {
            // 实体无name属性时，返回空Optional或自定义处理逻辑
            return Optional.empty();
        }
    }
}

这种方式通过默认方法+动态查询实现，启动时不会触发属性检查，但运行时调用无name属性实体的该方法会返回空，缺点是缺乏编译时类型安全，若后续实体属性变更可能引发运行时异常。

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