如何在Spring Data JPA中默认全局禁用JPA实体管理？

下面提供几种可行的全局配置方式，避免每次手动分离实体：

1. 全局启用只读事务 #

JPA在只读事务中不会自动将实体的本地修改同步到数据库，因为EntityManager会忽略flush操作。可以通过配置快速实现：

方式1：配置文件全局设置 #

在application.properties或application.yml中添加：

spring.data.jpa.repositories.default-transaction-read-only=true

这个配置会给所有Spring Data JPA Repository的方法默认添加@Transactional(readOnly = true)属性。

方式2：自定义事务配置类 #

如果需要更精细的控制，可创建配置类：

@Configuration
@EnableTransactionManagement
public class GlobalTransactionConfig {

    @Bean
    public TransactionAttributeSource transactionAttributeSource() {
        NameMatchTransactionAttributeSource attributeSource = new NameMatchTransactionAttributeSource();
        RuleBasedTransactionAttribute readOnlyTx = new RuleBasedTransactionAttribute();
        
        readOnlyTx.setReadOnly(true);
        readOnlyTx.setRollbackRules(Collections.singletonList(new RollbackRuleAttribute(Exception.class)));
        // 匹配所有Repository方法
        attributeSource.addTransactionalMethod("*", readOnlyTx);
        
        return attributeSource;
    }
}

注意：此方式下实体仍会被EntityManager管理，但修改不会自动同步到数据库。

2. 全局配置查询返回分离实体 #

如果需要实体从数据库加载后直接脱离EntityManager的持久化上下文（处于DETACHED状态），可自定义Repository基类统一处理：

步骤1：定义自定义Repository接口 #

@NoRepositoryBean
public interface DetachedRepository<T, ID> extends JpaRepository<T, ID> {
}

步骤2：实现自定义Repository基类 #

public class DetachedRepositoryImpl<T, ID> extends SimpleJpaRepository<T, ID> implements DetachedRepository<T, ID> {

    private final EntityManager entityManager;

    public DetachedRepositoryImpl(JpaEntityInformation<T, ID> entityInfo, EntityManager entityManager) {
        super(entityInfo, entityManager);
        this.entityManager = entityManager;
    }

    // 重写查询方法，返回后立即分离实体
    @Override
    public T findById(ID id) {
        T entity = super.findById(id).orElse(null);
        if (entity != null) {
            entityManager.detach(entity);
        }
        return entity;
    }

    @Override
    public List<T> findAll() {
        List<T> entities = super.findAll();
        entities.forEach(entityManager::detach);
        return entities;
    }

    // 按需重写其他查询方法（如findAllById、findByXXX等）
}

步骤3：配置使用自定义基类 #

@Configuration
@EnableJpaRepositories(
        basePackages = "com.yourpackage.repository",
        repositoryBaseClass = DetachedRepositoryImpl.class
)
public class JpaConfig {
}

此后所有继承DetachedRepository的Repository，查询返回的实体都会自动处于分离状态，本地修改不会触发数据库同步。

3. Hibernate专属：全局设置查询返回分离实体 #

如果使用Hibernate作为JPA实现，可通过全局属性直接让所有查询返回分离实体：

在配置文件中添加：

spring.jpa.properties.hibernate.query.default_fetch_mode=DETACHED

或者通过配置类设置：

@Bean
public LocalContainerEntityManagerFactoryBean entityManagerFactory(DataSource dataSource) {
    LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
    em.setDataSource(dataSource);
    em.setPackagesToScan("com.yourpackage.entity");
    
    HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
    em.setJpaVendorAdapter(vendorAdapter);
    
    Properties jpaProps = new Properties();
    jpaProps.setProperty("hibernate.query.default_fetch_mode", "DETACHED");
    em.setJpaProperties(jpaProps);
    
    return em;
}

该配置会让Hibernate在执行所有查询时，直接返回分离的实体，不会将其加入持久化上下文。

额外说明 #

• 如果需要将修改后的分离实体同步到数据库，需手动调用repository.save(entity)或entityManager.merge(entity)，这两个方法会将分离实体重新纳入管理并同步修改。
• 只读事务模式下，若尝试修改实体并提交，不会抛出异常，但修改不会写入数据库；分离实体模式下，修改实体后若不手动触发merge/save，也不会同步。

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