使用Neo4j 5.26.0调用neo4jTemplate.save时遇Spring事务冲突错误

问题核心 #

当前Spring事务上下文绑定的是默认数据库（此处为PostgreSQL），但Neo4j操作明确指定了neo4j数据库，导致事务上下文与目标数据库不匹配，触发冲突错误。

具体解决方案 #

1. 配置Neo4j专属事务管理器 #

在配置类中单独定义Neo4j事务管理器，确保Neo4j操作使用独立的事务上下文：

@Configuration
@EnableTransactionManagement
public class Neo4jTransactionConfig {

    @Bean
    public Neo4jTransactionManager neo4jTransactionManager(Neo4jDatabaseSupport neo4jDatabaseSupport) {
        return new Neo4jTransactionManager(neo4jDatabaseSupport);
    }
}

在调用neo4jTemplate.save的业务方法上，指定使用该事务管理器：

@Transactional(transactionManager = "neo4jTransactionManager")
public void saveEntities(List<YourEntity> entities) {
    neo4jTemplate.save(entities);
}

2. 修正测试用例的事务隔离 #

在测试类中明确绑定Neo4j事务管理器，避免与默认数据库事务冲突：

@SpringBootTest
@Transactional(transactionManager = "neo4jTransactionManager")
@Rollback
public class YourNeo4jTest {
    // 测试逻辑
}

3. 简化并统一Neo4j配置 #

Spring Boot 2.4+版本中，spring.neo4j.database已覆盖spring.data.neo4j.database的作用，可移除冗余配置，确保数据库配置唯一生效：

Map<String, String> properties = [
    "spring.neo4j.uri"                    : neo4j.boltURI().toString(),
    "spring.neo4j.authentication.username": "neo4j",
    "spring.neo4j.authentication.password": "Test@1234",
    "spring.neo4j.database"               : "neo4j",
    "product"                             : "flamingo",
    "auth.strategy"                       : "jwt",
    "spring.jpa.database-platform"        : "org.hibernate.dialect.PostgreSQLDialect",
    "spring.jpa.hibernate.ddl-auto"       : "create"
]

4. 手动控制Neo4j事务（调试应急方案） #

若上述配置仍未解决问题，可尝试绕过Spring事务上下文，手动管理Neo4j事务：

try (Session session = neo4jTemplate.getSessionFactory().openSession()) {
    try (Transaction tx = session.beginTransaction()) {
        entities.forEach(session::save);
        tx.commit();
    }
}

内容的提问来源于stack exchange，提问作者Ankit Lokhande