Under specific scenarios a DeadlockDetectedException may be encountered and the behavior is described at http://neo4j.com/docs/stable/transactions-deadlocks.html.
When a DeadlockDetected is encountered one option is to simply retry the statement.
As a deadlock detection error is a safe-to-retry error and the user is expected to handle these in all application code, since there may be legitimate deadlocks at any time, this behavior is actually by design to gain scalability.
The following describes a scenario where a deadlock can be demonstrated/reproduced.
[frame="topbot",options="header,footer"]
|====
|Time | Transaction | Cypher Statement
|08:00:01 | tx1001 | Begin
|08:00:02 | tx1001 | MATCH (n:Person {name:'Tom Hanks'}) set n.age=59;
|08:00:03 | tx1002 | Begin
|08:00:04 | tx1002 | MATCH (n:Movie {title:'Cast Away'}) set n.gross=233630478;
|08:00:05 | tx1001 | MATCH (n:Movie {title:'Cast Away'}) set n.budget=90000000;
|08:00:06 | tx1002 | MATCH (n:Person {name:'Tom Hanks'}) set n.residence=California;
|====
In the above scenario tx1001 is started at 08:00:01 and then @ 08:00:02 performs an update on the Person node for 'Tom Hanks' and defines age to be 59, resulting in a Write-Lock placed on this node. +
tx1002 is then started at 08:00:03 and subsequently at 08:00:04 performs an update on the Movie node for Cast Away and defines the gross to be 233630478, resulting on a Write-Lock on this node. +
tx1001 @ 08:00:05 then attempts to update the Movie node for Cast Away but is blocked as a result of the transaction @ 08:00:04 which has a Write-Lock on this node. +
tx1002 @08:00:06 then attempts to update the Person node for Tom Hanks but is blocked as a result of the transaction at 08:00:02 which has a Write-Lock on this node. +
Since the last two statements are waiting on each other, the dead lock is detected and the transaction at 08:00:06 is aborted with the following error
DeadlockDetectedException: ForsetiClient[0] can't acquire ExclusiveLock{owner=ForsetiClient[1]} on NODE(200153), because holders of that lock are waiting for ForsetiClient[0].
Wait list:ExclusiveLock[
Client[1] waits for [0]]
