Doctrine报“表不存在”通常因连接错误、实体未注解或未扫描、表未创建、名称不匹配或缓存未清除，需逐项验证。
doctrine:schema:validate 报 “The table does not exist” 或控制器里查不到数据，通常不是 Doctrine “不认识” 表，而是它压根没连上、没映射对、或根本没建表。
数据库连接 URL 配错，连都连不上
Doctrine 不报“找不到表”，先报“连不上库”——但错误可能被掩盖。比如 Connection refused 或 SQLSTATE[HY000] [2002] No such file or directory，本质是 DATABASE_URL 写错了。
-
mysql://user:pass@localhost:3306/dbname→ 本地开发慎用localhost，MySQL 会走 Unix socket，而 Docker 或某些系统下 socket 路径不对，改用127.0.0.1 - 密码含
@、/、:等字符没做 URL 编码，例如pass@word必须写成pass%40word -
serverVersion缺失或错配：MySQL 8.0 必须写?serverVersion=8.0，否则 Doctrine 无法生成兼容语法，建表都可能失败 - 确认
.env文件生效：运行php bin/console debug:container --env-vars | grep DATABASE_URL，看输出是否和你写的完全一致
实体没加 @ORM\Entity 或没扫到目录
Doctrine 只认加了 @ORM\Entity 注解（或 #[ORM\Entity] 属性）的类，并且只扫描 config/packages/doctrine.yaml 里 mappings 指定的路径。漏掉任一环，就等于没定义表。
- 检查实体类顶部是否有
@ORM\Entity（PHP 8.1+ 推荐用属性语法#[ORM\Entity]），且没拼错 - 确认
doctrine.yaml中mappings的dir指向的是实体所在目录，比如%kernel.project_dir%/src/Entity，而不是src/Entities（少了个 s） - 运行
php bin/console doctrine:mapping:info，如果返回 “No mapping files found”，说明 Doctrine 根本没发现你的 Entity 目录 - 别在
src/Model或src/Domain下放实体——除非你显式修改了 mapping 配置
表确实没创建，或名字对不上
Doctrine 默认不会自动建表，doctrine:schema:create 只在空库上有效；已有库想同步结构，得靠迁移或 doctrine:schema:update（不推荐生产用）。
-
php bin/console doctrine:schema:create --dump-sql先看它打算建啥——如果输出为空，说明 Doctrine 认为你没定义任何实体，或所有实体都被排除在外 - 实体里写了
@ORM\Table(name="my_custom_table")？那 Doctrine 就只认这个名，不会按类名默认生成user表，而是找my_custom_table - MySQL 里手动建过表，但字段名/类型和实体定义不一致（比如实体写
@ORM\Column(type="string", length=255)，而表里是VARCHAR(191)），doctrine:schema:validate就会报 “table exists but schema differs” - PostgreSQL 用户注意：
@ORM\Column(options={"autoincrement":true})在 PG 中完全无效，会导致主键无默认值，表建出来但 ID 字段不能自增
缓存没清，旧元数据还在骗人
Doctrine 把实体结构解析结果缓存在 var/cache 里。改了注解、加了新实体、甚至只是改了 doctrine.yaml，不清理缓存，它就继续用旧的映射信息。
- 开发环境务必跑
php bin/console cache:clear，而不是只删var/cache/dev—— 因为 Doctrine 元数据缓存可能单独存在 - 如果用了 APCu 或 Redis 做字节码缓存，也要清掉：例如
php bin/console cache:pool:clear doctrine.orm.default_metadata_cache - 极端情况可临时禁用缓存验证：加
--no-cache参数试试，比如php bin/console doctrine:schema:validate --no-cache
真正卡住的地方，往往不是“表在哪”，而是“Doctrine 根本没机会看到它”——URL 连不上、实体没标@Entity、目录没扫到、缓存还锁着旧结构。每一步都得实打实验证，不能靠猜。
