Identity Map Collision with Class Table Inheritance When Using Predefined IDs #7485

New Issue

Open

opened 2026-01-22 15:52:14 +01:00 by admin · 1 comment

admin commented 2026-01-22 15:52:14 +01:00

Owner

Copy Link

Originally created by @juslintek on GitHub (Mar 7, 2025).

Description

When using Class Table Inheritance (CTI) with predefined IDs (e.g., from an external system) for internal representation, retrieving an entity via the parent class and then the child class causes an identity map collision. Doctrine creates a new instance instead of reusing the managed one, resulting in duplicate instances with the same ID in the Unit of Work.

Steps to Reproduce

1. Set up a CTI hierarchy with BaseEntity (parent) and ChildEntityA (child), using a predefined/external string ID.
2. Persist a ChildEntityA instance with a predefined ID.
3. Fetch it via $em->find(BaseEntity::class, $externalId) – returns ChildEntityA.
4. Fetch it via $em->find(ChildEntityA::class, $externalId) – creates a new instance.
5. Call $em->flush(), which triggers an identity collision.

Expected Behavior

The second find() should return the existing managed instance from the UOW, even with predefined/external IDs.

Actual Behavior

A new instance is created, causing an identity collision. This occurs specifically when using predefined IDs.

Environment

composer show -i | grep doctrine
beberlei/doctrineextensions                    1.5.0   A set of extensions to Doctrine 2 that add support for additional query functions available in MySQL, Oracle, PostgreSQL and SQLite.
dama/doctrine-test-bundle                      8.3.0   Symfony bundle to isolate doctrine database tests and improve test performance
doctrine/cache                                 2.2.0   PHP Doctrine Cache library is a popular cache implementation that supports many different drivers such as redis, memcache, apc, mongodb and others.
doctrine/collections                           2.2.2   PHP Doctrine Collections library that adds additional functionality on top of PHP arrays.
doctrine/common                                3.5.0   PHP Doctrine Common project is a library that provides additional functionality that other Doctrine projects depend on such as better reflection support, p...
doctrine/data-fixtures                         2.0.2   Data Fixtures for all Doctrine Object Managers
doctrine/dbal                                  3.9.4   Powerful PHP database abstraction layer (DBAL) with many features for database schema introspection and management.
doctrine/deprecations                          1.1.4   A small layer on top of trigger_error(E_USER_DEPRECATED) or PSR-3 logging with options to disable all deprecations or selectively for packages.
doctrine/doctrine-bundle                       2.13.2  Symfony DoctrineBundle
doctrine/doctrine-fixtures-bundle              3.7.1   Symfony DoctrineFixturesBundle
doctrine/doctrine-migrations-bundle            3.4.1   Symfony DoctrineMigrationsBundle
doctrine/event-manager                         2.0.1   The Doctrine Event Manager is a simple PHP event system that was built to be used with the various Doctrine projects.
doctrine/inflector                             2.0.10  PHP Doctrine Inflector is a small library that can perform string manipulations with regard to upper/lowercase and singular/plural forms of words.
doctrine/instantiator                          2.0.0   A small, lightweight utility to instantiate objects in PHP without invoking their constructors
doctrine/lexer                                 3.0.1   PHP Doctrine Lexer parser library that can be used in Top-Down, Recursive Descent Parsers.
doctrine/migrations                            3.8.2   PHP Doctrine Migrations project offer additional functionality on top of the database abstraction layer (DBAL) for versioning your database schema and easi...
doctrine/orm                                   3.3.2   Object-Relational-Mapper for PHP
doctrine/persistence                           3.4.0   The Doctrine Persistence project is a set of shared interfaces and functionality that the different Doctrine object mappers share.
doctrine/sql-formatter                         1.5.2   a PHP SQL highlighting library
dunglas/doctrine-json-odm                      1.4.2   An object document mapper for Doctrine ORM using JSON types of modern RDBMS.
gedmo/doctrine-extensions                      3.19.0  Doctrine behavioral extensions
phpstan/phpstan-doctrine                       1.5.7   Doctrine extensions for PHPStan
scienta/doctrine-json-functions                6.3.0   A set of extensions to Doctrine that add support for json query functions.
simpod/doctrine-utcdatetime                    0.3.0   Doctrine UTC DateTime
stof/doctrine-extensions-bundle                1.13.0  Integration of the gedmo/doctrine-extensions with Symfony
symfony/doctrine-bridge                        7.2.4   Provides integration for Doctrine with various Symfony components

Using latest stable symfony 7.2.4
Using Api Platform: 3.4.16
Percona MySQL Database: 8.0.36
PHP: 8.3.17 under alpine linux

Reproducible Example

<?php
use Doctrine\ORM\Mapping as ORM;

// Parent entity with predefined ID
#[ORM\Entity]
#[ORM\InheritanceType('JOINED')]
#[ORM\DiscriminatorColumn(name: 'type', type: 'string')]
#[ORM\DiscriminatorMap(['a' => ChildEntityA::class])]
class BaseEntity {
    #[ORM\Id]
    #[ORM\Column(type: 'string')] // Predefined/external ID
    protected $id;

    public function setId($id) { $this->id = $id; }
    public function getId() { return $this->id; }
}

// Child entity
#[ORM\Entity]
class ChildEntityA extends BaseEntity {
    #[ORM\Column(type: 'string)]
    private $fieldA;

    public function setFieldA($value) { $this->fieldA = $value; }
    public function getFieldA() { return $this->fieldA; }
}

// Reproduce the issue
$em = // Your EntityManager setup
$externalId = 'external-123'; // Predefined/external ID

// Create and persist entity
$entity = new ChildEntityA();
$entity->setId($externalId);
$entity->setFieldA('test');
$em->persist($entity);
$em->flush();

// Fetch via parent class
$baseEntity = $em->find(BaseEntity::class, $externalId); // Returns ChildEntityA

// Fetch via child class
$childEntity = $em->find(ChildEntityA::class, $externalId); // New instance created

// Check if they’re the same
var_dump($baseEntity === $childEntity); // Outputs: false

// Trigger collision
$em->flush(); // Throws identity collision error

Additional Notes

This seems related to how the UOW manages identity mapping for CTI with predefined/external IDs when querying child classes directly.

Originally created by @juslintek on GitHub (Mar 7, 2025). ### Description When using Class Table Inheritance (CTI) with **predefined IDs** (e.g., from an external system) for internal representation, retrieving an entity via the parent class and then the child class causes an identity map collision. Doctrine creates a new instance instead of reusing the managed one, resulting in duplicate instances with the same ID in the Unit of Work. ### Steps to Reproduce 1. Set up a CTI hierarchy with `BaseEntity` (parent) and `ChildEntityA` (child), using a predefined/external string ID. 2. Persist a `ChildEntityA` instance with a predefined ID. 3. Fetch it via `$em->find(BaseEntity::class, $externalId)` – returns `ChildEntityA`. 4. Fetch it via `$em->find(ChildEntityA::class, $externalId)` – creates a new instance. 5. Call `$em->flush()`, which triggers an identity collision. ### Expected Behavior The second `find()` should return the existing managed instance from the UOW, even with predefined/external IDs. ### Actual Behavior A new instance is created, causing an identity collision. This occurs specifically when using predefined IDs. ### Environment ```` composer show -i | grep doctrine beberlei/doctrineextensions 1.5.0 A set of extensions to Doctrine 2 that add support for additional query functions available in MySQL, Oracle, PostgreSQL and SQLite. dama/doctrine-test-bundle 8.3.0 Symfony bundle to isolate doctrine database tests and improve test performance doctrine/cache 2.2.0 PHP Doctrine Cache library is a popular cache implementation that supports many different drivers such as redis, memcache, apc, mongodb and others. doctrine/collections 2.2.2 PHP Doctrine Collections library that adds additional functionality on top of PHP arrays. doctrine/common 3.5.0 PHP Doctrine Common project is a library that provides additional functionality that other Doctrine projects depend on such as better reflection support, p... doctrine/data-fixtures 2.0.2 Data Fixtures for all Doctrine Object Managers doctrine/dbal 3.9.4 Powerful PHP database abstraction layer (DBAL) with many features for database schema introspection and management. doctrine/deprecations 1.1.4 A small layer on top of trigger_error(E_USER_DEPRECATED) or PSR-3 logging with options to disable all deprecations or selectively for packages. doctrine/doctrine-bundle 2.13.2 Symfony DoctrineBundle doctrine/doctrine-fixtures-bundle 3.7.1 Symfony DoctrineFixturesBundle doctrine/doctrine-migrations-bundle 3.4.1 Symfony DoctrineMigrationsBundle doctrine/event-manager 2.0.1 The Doctrine Event Manager is a simple PHP event system that was built to be used with the various Doctrine projects. doctrine/inflector 2.0.10 PHP Doctrine Inflector is a small library that can perform string manipulations with regard to upper/lowercase and singular/plural forms of words. doctrine/instantiator 2.0.0 A small, lightweight utility to instantiate objects in PHP without invoking their constructors doctrine/lexer 3.0.1 PHP Doctrine Lexer parser library that can be used in Top-Down, Recursive Descent Parsers. doctrine/migrations 3.8.2 PHP Doctrine Migrations project offer additional functionality on top of the database abstraction layer (DBAL) for versioning your database schema and easi... doctrine/orm 3.3.2 Object-Relational-Mapper for PHP doctrine/persistence 3.4.0 The Doctrine Persistence project is a set of shared interfaces and functionality that the different Doctrine object mappers share. doctrine/sql-formatter 1.5.2 a PHP SQL highlighting library dunglas/doctrine-json-odm 1.4.2 An object document mapper for Doctrine ORM using JSON types of modern RDBMS. gedmo/doctrine-extensions 3.19.0 Doctrine behavioral extensions phpstan/phpstan-doctrine 1.5.7 Doctrine extensions for PHPStan scienta/doctrine-json-functions 6.3.0 A set of extensions to Doctrine that add support for json query functions. simpod/doctrine-utcdatetime 0.3.0 Doctrine UTC DateTime stof/doctrine-extensions-bundle 1.13.0 Integration of the gedmo/doctrine-extensions with Symfony symfony/doctrine-bridge 7.2.4 Provides integration for Doctrine with various Symfony components ```` Using latest stable symfony 7.2.4 Using Api Platform: 3.4.16 Percona MySQL Database: 8.0.36 PHP: 8.3.17 under alpine linux ### Reproducible Example ```php <?php use Doctrine\ORM\Mapping as ORM; // Parent entity with predefined ID #[ORM\Entity] #[ORM\InheritanceType('JOINED')] #[ORM\DiscriminatorColumn(name: 'type', type: 'string')] #[ORM\DiscriminatorMap(['a' => ChildEntityA::class])] class BaseEntity { #[ORM\Id] #[ORM\Column(type: 'string')] // Predefined/external ID protected $id; public function setId($id) { $this->id = $id; } public function getId() { return $this->id; } } // Child entity #[ORM\Entity] class ChildEntityA extends BaseEntity { #[ORM\Column(type: 'string)] private $fieldA; public function setFieldA($value) { $this->fieldA = $value; } public function getFieldA() { return $this->fieldA; } } // Reproduce the issue $em = // Your EntityManager setup $externalId = 'external-123'; // Predefined/external ID // Create and persist entity $entity = new ChildEntityA(); $entity->setId($externalId); $entity->setFieldA('test'); $em->persist($entity); $em->flush(); // Fetch via parent class $baseEntity = $em->find(BaseEntity::class, $externalId); // Returns ChildEntityA // Fetch via child class $childEntity = $em->find(ChildEntityA::class, $externalId); // New instance created // Check if they’re the same var_dump($baseEntity === $childEntity); // Outputs: false // Trigger collision $em->flush(); // Throws identity collision error ``` ### Additional Notes This seems related to how the UOW manages identity mapping for CTI with predefined/external IDs when querying child classes directly.

admin commented 2026-01-22 15:52:14 +01:00

Author

Owner

Copy Link

@mpdude commented on GitHub (Apr 7, 2025):

I've tried to add a test case for this in #11901, but I fail to demonstrate the problem both on 2.20.x and 3.3x.

@mpdude commented on GitHub (Apr 7, 2025): I've tried to add a test case for this in #11901, but I fail to demonstrate the problem both on 2.20.x and 3.3x.

Sign in to join this conversation.

No Branch/Tag Specified

Branches Tags

3.6.x

2.20.x

dependabot/github_actions/2.20.x/doctrine/dot-github/dot-github/workflows/composer-lint.yml-14.0.0

3.7.x

4.0.x

2.21.x

old-prototype-3.x

3.6.2

3.6.1

3.6.0

2.20.9

3.5.8

3.5.7

3.5.6

3.5.5

2.20.8

3.5.4

3.5.3

2.20.7

3.5.2

2.20.6

3.5.1

3.5.0

3.4.4

3.4.3

3.4.2

2.20.5

3.4.1

3.4.0

3.3.4

2.20.4

3.3.3

2.20.3

3.3.2

2.20.2

3.3.1

2.20.1

3.3.0

3.2.3

2.20.0

2.19.8

3.2.2

2.19.7

3.2.1

2.19.6

3.2.0

3.1.4

3.1.3

2.19.5

3.1.2

2.19.4

3.1.1

2.19.3

2.19.2

2.19.1

3.1.0

2.19.0

3.0.3

2.18.3

3.0.2

2.18.2

3.0.1

2.18.1

3.0.0

2.18.0

2.17.5

3.0.0-RC1

2.17.4

2.17.3

2.17.2

2.17.1

3.0.0-beta2

2.17.0

2.16.3

3.0.0-beta1

2.16.2

2.16.1

2.16.0

2.15.5

2.15.4

2.15.3

2.15.2

2.15.1

2.15.0

2.14.3

2.14.2

2.14.1

2.14.0

2.13.5

2.13.4

2.13.3

2.13.2

2.13.1

2.13.0

2.12.4

2.12.3

2.12.2

2.12.1

2.12.0

2.11.3

2.11.2

2.11.1

2.11.0

2.10.5

2.10.4

2.10.3

2.10.2

2.10.1

2.10.0

2.9.6

2.9.5

2.9.4

2.9.3

2.9.2

2.9.1

2.9.0

2.8.5

2.8.4

2.8.3

2.8.2

2.8.1

2.8.0

2.7.5

2.7.4

v2.7.3

v2.7.2

v2.7.1

v2.7.0

v2.6.6

v2.6.5

v2.6.4

v2.6.3

v2.6.2

v2.6.1

v2.6.0

v2.5.14

v2.5.13

v2.5.12

v2.5.11

v2.5.10

v2.5.9

v2.5.8

v2.5.7

v2.5.6

v2.5.5

v2.5.4

v2.5.3

v2.5.2

v2.4.8

v2.5.1

v2.5.0

v2.5.0-RC2

v2.5.0-RC1

v2.5.0-beta1

v2.5.0-alpha2

v2.5.0-alpha1

v2.4.7

v2.4.6

v2.4.5

v2.4.4

v2.4.3

v2.3.6

v2.4.2

2.3.5

v2.4.1

v2.4.0

2.4.0-RC2

2.4.0-RC1

2.4.0-BETA2

2.3.4

2.3.3

2.4.0-BETA1

2.3.2

2.3.1

2.3.0

2.3.0-RC4

2.3.0-RC3

2.3.0-RC2

2.2.3

2.3.0-RC1

2.3.0-BETA1

2.1.7

2.2.2

2.2.1

2.1.6

2.2.0

2.2.0-RC1

2.2.0-BETA2

2.2.0-BETA1

2.1.5

2.1.4

2.1.3

2.1.2

2.1.1

2.0.7

2.1.0

2.1.0RC3

2.1.0RC2

2.1.0RC1

2.0.6

2.1.0BETA1

2.0.5

2.0.4

2.0.3

2.0.2

2.0.1

2.0.0

2.0.0RC2

2.0.0RC1

2.0.0-BETA4

2.0.0-BETA3

2.0.0-BETA2

2.0.0-BETA1

Labels

Clear labels

BC Break

Bug

Can't Fix

Deprecation

Documentation

DQL

Duplicate

Failing Test

Hacktoberfest

Improvement

Improvement

Incomplete

Invalid

Missing Tests

New Feature

PR Created

pull-request

Mirrored from GitHub Pull Request

Question

Regression

Status: Waiting feedback

Waiting feedback

WIP

Won't Fix

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

admin

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: doctrine/archived-orm#7485