禁用enable_lazy_ghost_objects等配置后仍出现Doctrine Ghost对象

问题现象 #

在Doctrine配置中已经关闭了auto_generate_proxy_classes和enable_lazy_ghost_objects，但系统依然生成了以下Ghost对象：

• CreateFooBarOneGhost259bdb8
• CreateFooBarTwoGhost2ecc09c
• CreateFooBarThreeGhost1ea45a3

你的doctrine.yaml配置如下：

parameters:
# Adds a fallback DATABASE_URL if the env var is not set.
# This allows you to run cache:warmup even if your
# environment variables are not available yet.
# You should not need to change this value.
env(DATABASE_URL): ''

doctrine:
    dbal:
        driver: 'pdo_mysql'
        server_version: '10.4.14-MariaDB'
        charset: utf8
        default_table_options:
            charset: utf8
            collate: utf8_unicode_ci
        schema_filter: ~^(?!session)~
        url: '%env(DATABASE_URL)%'
        options:
            PDO::MYSQL_ATTR_LOCAL_INFILE: 1
            PDO::ATTR_ERRMODE:            2
            1002: "SET sql_mode=(SELECT 
REPLACE(@@sql_mode,'ONLY_FULL_GROUP_BY',''))"
        # IMPORTANT: You MUST configure your server version,
        # either here or in the DATABASE_URL env var (see .env file)
        #server_version: '16'

        profiling_collect_backtrace: '%kernel.debug%'
        use_savepoints: true
    orm:
        auto_generate_proxy_classes: false
        enable_lazy_ghost_objects: false
        controller_resolver: 
            auto_mapping: false
        entity_managers:
            default:
                # Opt-in to new mapping driver mode as of Doctrine ORM 2.16, https://github.com/doctrine/orm/pull/10455
                report_fields_where_declared: true
                # 0pt-in to the new mapping driver mode as of Doctrine ORM 2.14. See https://github.com/doctrine/orm/pull/6728.
                validate_xml_mapping: true
                naming_strategy: 
doctrine.orm.naming_strategy.default
                auto_mapping: true
                query_cache_driver:
                    pool: doctrine_query_pool
                result_cache_driver:
                    pool: doctrine_result_pool
                mappings:
                    gedmo_tree:
                        is_bundle: false
                        type: attribute
                        dir: "%kernel.project_dir%/vendor/gedmo/doctrine-extensions/src/Tree/Entity"
                        prefix: Gedmo\Tree\Entity
                        alias: GedmoTree
                    App:
                        is_bundle: false
                        type: attribute
                        dir: '%kernel.project_dir%/src/Entity'
                        prefix: 'App\Entity'
                        alias: App
                hydrators:
                    ColumnHydrator: App\Doctrine\Hydrators\ColumnHydrator
when@test:
    doctrine:
        dbal:
            # "TEST_TOKEN" is typically set by ParaTest
            dbname_suffix: '_test%env(default::TEST_TOKEN)%'
when@prod:
    doctrine:
        orm:
            auto_generate_proxy_classes: false
            proxy_dir: '%kernel.build_dir%/doctrine/orm/Proxies'
            query_cache_driver:
                type: pool
                pool: doctrine.system_cache_pool
            result_cache_driver:
                type: pool
                pool: doctrine.result_cache_pool

    framework:
        cache:
            pools:
                doctrine.result_cache_pool:
                    adapter: cache.app
                doctrine.system_cache_pool:
                    adapter: cache.system

排查方向与解决方法 #

1. 配置层级错误（最常见原因） #

你在orm根节点下设置了enable_lazy_ghost_objects: false，但Doctrine的实体管理器（entity_managers.default）层级的配置会覆盖根级别配置。必须把禁用配置放到实体管理器节点内，否则不生效：

doctrine:
    orm:
        entity_managers:
            default:
                enable_lazy_ghost_objects: false
                auto_generate_proxy_classes: false
                # 保留其他原有配置...

2. 旧缓存/代理类未清理 #

修改配置后，之前生成的Ghost类可能残存在缓存或代理目录中，导致新配置不生效。执行以下命令彻底清理：

# 清理Symfony全环境缓存
php bin/console cache:clear --no-warmup

# 手动删除代理类目录（生产环境路径看配置里的proxy_dir）
rm -rf var/cache/dev/doctrine/orm/Proxies
rm -rf var/cache/prod/doctrine/orm/Proxies

3. Gedmo扩展触发的生成 #

你使用了Gedmo Tree扩展，部分第三方Doctrine扩展可能会在内部触发懒加载或代理生成，不受全局配置影响。可以先临时注释掉Gedmo的映射配置，重启服务后观察是否还会生成Ghost对象，以此确认是否是扩展导致的问题。如果是，需要查看Gedmo扩展的文档，是否有单独的配置可以控制其代理生成行为。

4. 代码中触发了懒加载 #

如果实体关联字段设置了fetch: LAZY，且代码中在未加载关联的情况下访问了该字段，Doctrine会自动生成代理类（包括Ghost类）来实现懒加载，即使全局禁用了Ghost对象。检查实体映射文件，必要时将关联改为fetch: EAGER，或者调整代码逻辑，避免触发未预料的懒加载。

5. Doctrine版本bug #

部分Doctrine ORM版本（尤其是2.16+的新映射驱动模式）可能存在配置读取的bug，导致禁用Ghost对象的配置不生效。可以查看当前Doctrine版本的release notes，确认是否有相关已知问题，必要时升级到最新稳定版本或降级到无问题的版本。

内容的提问来源于stack exchange，提问作者Iyappan Ayan