DoctrineMongoDBBundle关联用户文档后登录序列化失败问题

问题根源 #

Symfony 7.x配套的Doctrine MongoDB ODM版本调整了代理类命名规则——原代理类会带随机长ID后缀，现在改为无后缀的固定短命名格式。而session中存储的旧安全token仍保留着旧代理类名，登录时反序列化就会出现「Class not found: MongoDBODMProxies__CG__\App\Document\Address」错误。

解决步骤 #

1. 清理旧代理文件与session数据 #

• 删除缓存目录下的旧代理文件，路径通常为：var/cache/{你的环境名}/MongoDBODMProxies/，直接删除整个目录即可
• 清理服务器端session存储：如果是文件存储，删除var/sessions/目录；如果是Redis等分布式存储，执行对应清空命令，确保旧安全token被完全移除

2. 配置固定代理类命名规则 #

在config/packages/doctrine_mongodb.yaml中明确代理生成配置，强制使用无随机ID的固定命名：

doctrine_mongodb:
  document_managers:
    default:
      proxies:
        namespace: MongoDBODMProxies
        path: '%kernel.cache_dir%/MongoDBODMProxies'
        suffix: '__CG__' # 关键配置：固定代理类后缀，不再生成随机ID

3. 重新生成代理类 #

执行以下命令生成符合新命名规则的代理文件：

php bin/console doctrine:mongodb:generate-proxies

或者直接清理缓存，缓存重建时会自动生成最新代理类：

php bin/console cache:clear

4. 优化User文档的序列化逻辑 #

• 确保User类的序列化配置（如使用#[Groups]注解）仅包含必要字段，避免直接序列化整个Address代理对象
• 若需保留关联关系，建议序列化Address的ID而非完整对象，减少代理类依赖，同时提升序列化效率

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