“No supported normalizer found”错误表明SerializerInterface实例未正确初始化，缺少JsonEncoder和必要的normalizer组件，而非实体或注解问题。
“No supported normalizer found” 是序列化器没配编码器和规范化器
这个 500 错误说明 SerializerInterface 实例缺少必要的组件，不是实体写错了，也不是注解漏了——它压根没被初始化成能干活的样子。Symfony 的默认 DI 容器注入的 serializer 服务是完整的，但如果你手动 new Serializer，就必须自己塞 JsonEncoder 和
。
- 错误写法：
new Serializer()（空构造，无任何 encoder/normalizer） - 正确写法：
new Serializer([new ObjectNormalizer()], [new JsonEncoder()]) - 更推荐：直接用容器注入的
$serializer，别自己 new —— 它已预配置好，支持groups、maxDepth等选项 - 如果坚持手动构造，记得加
ObjectNormalizer的构造参数：new ObjectNormalizer(null, null, null, $propertyAccessor)，否则属性访问可能失败
“Access denied for user” 不是密码错了，是 host 或权限不匹配
报这个错时，doctrine:database:create 命令根本没走到密码校验那步，它卡在 MySQL 的用户授权检查上。“app_user@'127.0.0.1'” 和 “app_user@'%'” 是两个完全不同的账号，哪怕密码一样也互不认。
- 查授权：进 MySQL 执行
SELECT host FROM mysql.user WHERE User = 'app_user';，确认返回结果包含你连接时用的 host（如127.0.0.1、10.0.1.5或%） - Docker 场景下，宿主机连容器数据库，host 得填
172.17.0.1或host.docker.internal，但数据库必须明确授权app_user@'172.17.0.1'，不能只开@'localhost' - MySQL 8+ 默认认证插件是
caching_sha2_password，PHP 7.4–8.0 可能不兼容，执行ALTER USER 'app_user'@'%' IDENTIFIED WITH mysql_native_password BY 'xxx';再试 - 验证方式：在应用服务器上跑
mysql -u app_user -p -h your-db-host -P 3306，复现相同错误才准定位
“Connection refused” 多半是网络不通或 socket 路径错
这个错误发生在 TCP 连接建立阶段，Doctrine 还没开始发 SQL。90% 情况下跟 Doctrine 配置无关，先别翻 doctrine.yaml。
-
localhost在 MySQL 里默认走 Unix socket，但容器或远程环境没有该 socket 文件 → 改成127.0.0.1强制走 TCP - 密码含
@、/、:必须 URL 编码，例如pa@ss/word→pa%40ss%2Fword，否则DATABASE_URL解析直接截断 - 云数据库（如阿里云 RDS）禁止从公网 IP 连接，
DATABASE_URL的 host 必须填内网地址，且安全组放行 3306 端口 - Docker Compose 中，Symfony 容器连
database服务名没问题，但宿主机上的 Symfony 就得用127.0.0.1:3307（前提是端口映射了）
路由 404 不是控制器写错了，是请求根本没进内核
Symfony 返回 404 但日志里没记录路由匹配过程？说明 Web 服务器压根没把请求转给 public/index.php，别急着查 routes.yaml。
- 先测
https://yoursite.com/public/index.php，能打开就证明 PHP 和 autoloader 正常；打不开就查文件权限、vendor/autoload.php是否存在 - Apache 必须启用
mod_rewrite且虚拟主机配置AllowOverride All，否则.htaccess不生效 - Nginx 必须有
try_files $uri $uri/ /index.php?$query_string;，漏掉$query_string会导致 GET 参数丢失，部分带 query 的路由 404 - 临时在
public/index.php开头加，刷新页面看到文字才算请求抵达入口
真正难排查的从来不是错误信息本身，而是你以为它在某一层出问题，其实它卡在更底层——比如把 Access denied 当配置错误调，却忘了 MySQL 根本没允许那个 IP 登录；或者对着空的 form_errors() 发愁，却没意识到表单压根没提交到对的 action 地址。
