connection refused 表示 tcp 连接被拒，根源是 mysql 未监听端口、bind-address 配置不当或防火墙拦截；no such file or directory 表明 unix socket 路径不匹配，常见于 localhost 强制走 socket 但路径错误。
Connection refused 或 No such file or directory 怎么快速定位
这两种错误看似相似，根源完全不同：Connection refused 是 TCP 连接被拒（MySQL 没监听、端口错、防火墙挡了），而 No such file or directory 是 Unix socket 路径不对（常见于用 localhost 连但 MySQL 实际走 socket，且路径不匹配）。
先跑一句命令确认问题类型：mysql -h 127.0.0.1 -u your_user -p。如果能连上，说明是 localhost 导致的 socket 问题；如果也报 Connection refused，就去查服务状态和端口。
- Linux/macOS：用
sudo systemctl status mysql或brew services list看服务是否 running - Windows：打开服务管理器，找 “MySQL80” 或对应服务名，状态必须是“正在运行”
- 检查端口占用：
lsof -i:3306（macOS/Linux）或netstat -ano | findstr :3306（Windows）
DATABASE_URL 里写 localhost 还是 127.0.0.1
必须写 127.0.0.1，别碰 localhost。MySQL 客户端对这两个字面量的处理逻辑不同：用 localhost 会强制走 Unix socket（哪怕你配了 port），而 socket 路径可能和 Symfony 期望的不一致；用 127.0.0.1 才真正走 TCP/IP，可控性强。
DATABASE_URL 格式示例：mysql://app_user:pass%40word@127.0.0.1:3306/myapp?serverVersion=8.0
- 密码含
@、/、:等字符，必须 URL 编码，比如pass@word→pass%40word -
serverVersion参数不能省——Doctrine 靠它决定 SQL 语法兼容性，MySQL 8.0 就写8.0，5.7 就写5.7 - 端口没改过就别写
:3306，但写了也没坏处；写了就得确保 MySQL 确实监听那个端口
Access denied for user 怎么判断是权限还是配置错
doctrine:database:create 报这个错，90% 不是 DATABASE_URL 写错了，而是用户没建库权限。这个命令不是用 root 连，而是直接拿 URL 里的用户去执行 CREATE DATABASE。
登录 MySQL 控制台，运行：SHOW GRANTS FOR 'app_user'@'127.0.0.1';
- 如果没有
CREATE权限，执行：GRANT CREATE ON *.* TO 'app_user'@'127.0.0.1'; FLUSH PRIVILEGES; - 如果只允许建特定库，可缩窄范围：
GRANT CREATE ON `myapp`.* TO 'app_user'@'127.0.0.1'; - 注意 host 必须和连接时一致：用
127.0.0.1连，就不能只给'app_user'@'localhost'授权
Docker 环境下 host 解析失败怎么办
如果你用 Docker Compose 启动 MySQL，Symfony 却跑在宿主机上（非容器内），那么 database 这个服务名在宿主机 DNS 里根本不存在——DATABASE_URL 里写 mysql://...@database:3306/... 必然失败。
两个务实解法：
- 把 Symfony 也扔进容器，用 compose 的内部网络互通（推荐，符合 Docker 原则）
- 宿主机手动改
/etc/hosts，加一行：127.0.0.1 database，前提是 MySQL 容器映射了3306到宿主机（即ports: - "3306:3306"）
别试图在宿主机用 docker network inspect 查容器 IP 再硬写——IP 可能变，且 Docker Desktop 在 macOS/Windows 上的网络栈行为不稳定。
